> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AnythingLLMでAPIМartを使用する

> AnythingLLMでAPIMart APIサービスを設定し使用する詳細ガイド。このガイドは、AnythingLLMでAPIMart APIを設定し、プライベートAIナレッジベースと会話システムを構築するのに役立ちます。

## 前提条件

開始する前に、以下を確認してください：

1. **AnythingLLMのインストール**
   [公式サイト](https://anythingllm.com/)からAnythingLLMをダウンロードしてインストールするか、[GitHub](https://github.com/Mintplex-Labs/anything-llm)を参照

2. **APIMart APIキーの取得**
   [APIМartコンソール](https://apimart.ai/keys)にログインしてAPIキー（`sk-`で始まる）を取得

<Note>
  **ヒント：** APIМartアカウントをまだお持ちでない場合は、まず[APIMart](https://apimart.ai)で登録してAPIキーを取得してください。
</Note>

## ステップ1：AnythingLLMを起動し設定にアクセス

### 1.1 アプリケーションの起動

1. AnythingLLMデスクトップアプリケーションを起動するか、Web版にアクセス
2. 初回起動時にウェルカム画面が表示されます
3. 左下の**Open settings**ボタン（設定ボタン）をクリック

<Frame>
  <img src="https://mintcdn.com/apicore/lJVOGiGDkmK1gCcM/images/integrations/anythingllm/main-interface.png?fit=max&auto=format&n=lJVOGiGDkmK1gCcM&q=85&s=e33a295a9129e3f7d948219db7609429" alt="AnythingLLMメインインターフェース" width="1920" height="1008" data-path="images/integrations/anythingllm/main-interface.png" />
</Frame>

<caption>*ワークスペース一覧と設定入口を確認できるAnythingLLMメインインターフェース*</caption>

<Note>
  **注意：** AnythingLLMはデスクトップ版（Windows、macOS、Linux）とDockerデプロイメントをサポートしています。
</Note>

### 1.2 LLM設定ページへの移動

設定ページで：

1. 左メニューの**LLM Preference**を見つける
2. クリックしてLLM設定ページに入る

## ステップ2：APIMart APIの設定

### 2.1 LLMプロバイダーの選択

LLM設定ページで：

1. **LLM Provider**ドロップダウンメニューを見つける
2. **Generic OpenAI**を選択

<Frame>
  <img src="https://mintcdn.com/apicore/lJVOGiGDkmK1gCcM/images/integrations/anythingllm/llm-provider-selection.png?fit=max&auto=format&n=lJVOGiGDkmK1gCcM&q=85&s=91bc2ff729de6e22bcea7fab681e2ad4" alt="LLMプロバイダーの選択" width="1920" height="1008" data-path="images/integrations/anythingllm/llm-provider-selection.png" />
</Frame>

<caption>*LLMプロバイダーとしてGeneric OpenAIを選択*</caption>

<Note>
  **なぜGeneric OpenAI？** APIМartはOpenAI互換のAPIインターフェースを提供しているため、AnythingLLMでGeneric OpenAIプロバイダーを選択するとAPIМartサービスを使用できます。
</Note>

### 2.2 API情報の設定

Generic OpenAIを選択した後、以下の設定を入力：

| フィールド                            | 値                                    |
| -------------------------------- | ------------------------------------ |
| **API Key**                      | あなたのAPIMart APIキー（`sk-xxxxxxxxxxxx`） |
| **Base URL**または**API Base Path** | `https://api.apimart.ai/v1`          |
| **Chat Model**または**モデル名**        | 具体的なモデル名を入力（下記の推奨モデル参照）              |

<Frame>
  <img src="https://mintcdn.com/apicore/lJVOGiGDkmK1gCcM/images/integrations/anythingllm/api-configuration.png?fit=max&auto=format&n=lJVOGiGDkmK1gCcM&q=85&s=1aea88ac0df6d35b5ae6b0dbcc0e8c05" alt="API設定" width="1920" height="1008" data-path="images/integrations/anythingllm/api-configuration.png" />
</Frame>

<caption>*APIMartのAPI Key、Base URL、モデル名を入力*</caption>

<Warning>
  **重要：**

  * Base URLには`/v1`サフィックスを含める必要があります：`https://api.apimart.ai/v1`
  * API KeyはAPIМartコンソールから取得し、`sk-`で始まる必要があります
  * モデル名は正確なモデルID（例：`gpt-4o`、`claude-sonnet-4-5-20250929`など）を入力してください
  * APIキーに十分な残高があることを確認してください
</Warning>

**推奨モデル：**

| モデル名              | モデルID                          | 特徴          |
| ----------------- | ------------------------------ | ----------- |
| GPT-5             | `gpt-5`                        | 最新かつ最も強力    |
| GPT-4o            | `gpt-4o`または`chatgpt-4o-latest` | 高品質な会話      |
| GPT-4o Mini       | `gpt-4o-mini`                  | 高速で経済的      |
| Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929`   | コードと推論に優れる  |
| Claude Haiku 4.5  | `claude-haiku-4-5-20251001`    | 高速応答        |
| Gemini 2.0 Flash  | `gemini-2.0-flash-exp`         | マルチモーダルサポート |

<Tip>
  **パフォーマンス推奨：**

  * 💰 **コスト効率的：** `gpt-4o-mini`、`claude-haiku-4-5-20251001`
  * 🚀 **高性能：** `gpt-5`、`gpt-4o`、`claude-sonnet-4-5-20250929`
  * ⚡ **高速応答：** `gemini-2.0-flash-exp`、`gpt-4o-mini`
</Tip>

### 2.3 モデルパラメータの調整（オプション）

必要に応じて以下のパラメータを調整できます：

| パラメータ           | 説明                 | 推奨値               |
| --------------- | ------------------ | ----------------- |
| **Temperature** | 出力のランダム性を制御        | 0.7（創造的）/ 0.3（正確） |
| **Max Tokens**  | 最大出力長              | 2000-4000         |
| **Top P**       | ニュークリアスサンプリングパラメータ | 0.9               |

### 2.4 設定の保存

1. ページ下部の**Save**ボタンをクリック
2. システムが自動的に接続をテスト
3. 設定が正しい場合、成功メッセージが表示されます

## ステップ3：埋め込みモデルの設定（オプション）

AnythingLLMは、ドキュメント検索とナレッジベース機能のためのベクトル埋め込みをサポートしています。

### 3.1 埋め込み設定への移動

設定ページで：

1. 左メニューの**Embedding Preference**を見つける
2. クリックして埋め込みモデル設定ページに入る

### 3.2 埋め込みモデルの設定

| フィールド                  | 値                                                   |
| ---------------------- | --------------------------------------------------- |
| **Embedding Provider** | **Generic OpenAI**を選択                               |
| **API Key**            | あなたのAPIMart APIキー（`sk-xxxxxxxxxxxx`）                |
| **Base URL**           | `https://api.apimart.ai/v1`                         |
| **Model**              | `text-embedding-3-small`または`text-embedding-3-large` |

<Tip>
  **モデル選択の推奨：**

  * `text-embedding-3-small` - 高速で経済的、ほとんどのシナリオに適しています
  * `text-embedding-3-large` - より高い精度、高い検索品質が必要なシナリオに適しています
</Tip>

## ステップ4：ワークスペースの作成とドキュメントのアップロード

### 4.1 ワークスペースの作成

1. メインインターフェースに戻る
2. **+ New Workspace**をクリック
3. ワークスペース名を入力（例：「技術文書アシスタント」、「カスタマーサービスナレッジベース」）
4. 作成をクリック

### 4.2 ドキュメントのアップロード

AnythingLLMは様々なドキュメント形式をサポートしています：

**サポートされているドキュメントタイプ：**

* 📄 **テキストドキュメント** - .txt、.md、.pdf、.docx
* 💻 **コードファイル** - .py、.js、.java、.cppなど
* 🌐 **Webページ** - URLスクレイピング経由
* 📊 **データファイル** - .csv、.json、.xml

**アップロード手順：**

1. ワークスペースページで**Upload Documents**をクリック
2. ファイルを選択するか、アップロードエリアにドラッグ＆ドロップ
3. ドキュメント処理が完了するまで待つ
4. ドキュメントは自動的にベクトル化されます

<Note>
  **ドキュメント処理：** アップロードされたドキュメントは自動的にチャンクに分割され、埋め込みモデルを使用してベクトル化され、ローカルデータベースに保存されます。
</Note>

### 4.3 ドキュメントの管理

ドキュメント管理ページで：

1. アップロードされたすべてのドキュメントを表示
2. 不要なドキュメントを削除
3. ドキュメントのチャンク分割の詳細を表示
4. ドキュメントのメタデータを編集

## ステップ5：会話の開始

設定が完了したら、AnythingLLMの使用を開始できます：

### 5.1 基本的な会話

1. ワークスペース内で会話入力ボックスを見つける
2. 質問またはリクエストを入力
3. AIがアップロードされたドキュメントとAPIМartモデルに基づいて応答を生成

### 5.2 ナレッジベース機能の使用

AnythingLLMは自動的に：

1. 質問を分析
2. アップロードされたドキュメントから関連コンテンツを検索
3. 検索されたコンテンツとAIモデルを組み合わせて正確な回答を生成

<Tip>
  **検索効果を向上させる：**

  * 高品質で構造化されたドキュメントをアップロード
  * 明確で具体的な質問を使用
  * ナレッジベースを定期的に更新および維持
</Tip>

### 5.3 ワークスペースの切り替え

異なるプロジェクトやトピック用に複数のワークスペースを作成できます：

1. 左上のワークスペース名をクリック
2. 他のワークスペースを選択するか、新しいものを作成
3. 各ワークスペースには独立したドキュメントと会話履歴があります

## 高度な機能

### 1. エージェントモード

AnythingLLMはエージェント機能をサポートし、AIが次のことを可能にします：

* 🔍 **Web検索** - リアルタイム情報の取得
* 🧮 **計算の実行** - 数学とデータ分析の処理
* 📊 **チャート生成** - データの可視化
* 🔗 **API呼び出し** - 外部サービスとの対話

**エージェントモードの有効化：**

1. ワークスペース設定で**Agent Configuration**を見つける
2. 有効にするツールと機能を選択
3. 設定を保存

### 2. 会話履歴管理

* **会話のエクスポート** - 会話をテキストまたはJSON形式でエクスポート
* **履歴の検索** - 過去の会話をすばやく検索
* **レコードの削除** - 不要な会話履歴をクリーンアップ

### 3. カスタムシステムプロンプト

ワークスペース設定で：

1. **System Prompt**を見つける
2. AIの役割と動作をカスタマイズ
3. 例：

```
あなたは製品に関する技術的な質問に答えることに熟練した専門的な技術サポートエンジニアです。
回答する際は以下をお願いします：
1. プロフェッショナリズムと礼儀を保つ
2. 詳細な手順説明を提供する
3. 不確かな場合は、技術サポートへの連絡を推奨する
```

### 4. マルチユーザー管理（Dockerデプロイのみ）

Dockerデプロイを使用する場合：

* 複数のユーザーアカウントを作成
* 異なる権限レベルを設定
* ワークスペースのアクセス権限を管理

### 5. APIアクセス

AnythingLLMはREST APIを提供：

* プログラムによるワークスペースアクセス
* ドキュメントのアップロードと管理
* 会話リクエストの送信
* アプリケーションへの統合

## よくある質問

### Q1: APIМartサービスに接続できない？

**解決策：**

1. **Base URLの確認**：
   * `https://api.apimart.ai/v1`（`/v1`を含む）であることを確認
   * 追加のパスを追加したり`/v1`を省略したりしない

2. **APIキーの検証**：
   * APIキーが`sk-`で始まることを確認
   * [APIМartコンソール](https://apimart.ai/keys)でキーが有効かどうかを確認

3. **ネットワーク接続の確認**：
   * `https://api.apimart.ai`へのアクセスを確認
   * ファイアウォールまたはプロキシ設定を確認

### Q2: アップロード後にドキュメントが正しく検索されない？

**解決策：**

1. **埋め込みモデル設定の確認**：
   * 埋め込みモデルが正しく設定されていることを確認
   * 埋め込みモデル接続をテスト

2. **ドキュメントの再処理**：
   * ドキュメントを削除して再アップロード
   * ドキュメント形式がサポートされているか確認

3. **検索パラメータの調整**：
   * ワークスペース設定で類似度しきい値を調整
   * 返されるドキュメントチャンクの数を増やす

### Q3: 会話の応答が遅い？

**解決策：**

1. **より高速なモデルへの切り替え**：
   * `gpt-4o`の代わりに`gpt-4o-mini`を使用
   * より高速な応答のために`gemini-2.0-flash-exp`を使用

2. **ドキュメント数の最適化**：
   * ワークスペース内のドキュメント数を減らす
   * 不要な大きなファイルを削除

3. **Max Tokensの調整**：
   * 最大出力長を減らす
   * より簡潔なプロンプトを使用

### Q4: API使用状況とコストを確認するには？

[APIМartコンソール](https://apimart.ai/overview)にログインして表示：

* 📊 API呼び出し統計
* 💰 コストの詳細
* 📈 使用傾向チャート
* 🔍 詳細なリクエストログ

### Q5: AnythingLLMはどのようなデプロイオプションをサポートしていますか？

AnythingLLMは複数のデプロイオプションをサポート：

* 🖥️ **デスクトップアプリケーション** - Windows、macOS、Linux
* 🐳 **Docker** - セルフホストデプロイメント
* ☁️ **クラウド版** - AnythingLLM Cloud（近日公開）

## ユースケース例

### 1. 企業ナレッジベース

**設定：**

* モデル：`gpt-4o-mini`（コスト効率的）
* ドキュメント：社内文書、マニュアル、FAQ
* 機能：従業員の迅速な情報検索

**使用例：**

* 新入社員のオンボーディング
* 会社のポリシーの迅速な検索
* 技術文書の検索

### 2. 技術文書アシスタント

**設定：**

* モデル：`claude-sonnet-4-5-20250929`（コードに優れる）
* ドキュメント：APIドキュメント、技術仕様、コードベース
* 機能：開発者の技術情報検索を支援

**使用例：**

* API使用ドキュメントのクエリ
* コード例の検索
* 技術的な質問への回答

### 3. カスタマーサービスナレッジベース

**設定：**

* モデル：`gpt-4o`（高品質な会話）
* ドキュメント：製品マニュアル、FAQ、ソリューション
* 機能：顧客の質問への迅速な対応

**使用例：**

* FAQの自動回答
* 製品使用ガイダンス
* トラブルシューティングの提案

### 4. 研究と学習アシスタント

**設定：**

* モデル：`gpt-5`（強力な理解力）
* ドキュメント：研究論文、教科書、ノート
* 機能：学習と研究を支援

**使用例：**

* 論文の要約と分析
* 知識ポイントの説明
* 学習パスの計画

## 機能特性

AnythingLLM + APIМartを使用すると：

* 📚 **プライベートナレッジベース** - ローカルで安全なプライベートナレッジベースを構築
* 🔒 **データプライバシー** - すべてのデータをローカルに保存してプライバシーを保護
* 🤖 **マルチモデルサポート** - 異なるAIモデル間で柔軟に切り替え
* 📄 **マルチフォーマットサポート** - 様々なドキュメント形式をサポート
* 🎯 **正確な検索** - ベクトルベースのインテリジェントなドキュメント検索
* 💬 **コンテキスト会話** - 長い会話でコンテキストを維持
* 🔧 **高度にカスタマイズ可能** - カスタムプロンプト、パラメータなど
* 🌐 **クロスプラットフォーム** - Windows、macOS、Linuxをサポート

## データセキュリティとプライバシー

### ローカルデータストレージ

AnythingLLMのデータストレージアプローチ：

* 📁 **ローカルファイルシステム** - ドキュメントをローカルに保存
* 🗄️ **ローカルベクトルデータベース** - ベクトルインデックスをローカルに保存
* 💾 **会話履歴** - 会話記録をローカルに保存

### API呼び出しセキュリティ

* 🔐 **暗号化された転送** - すべてのAPI呼び出しはHTTPS暗号化を使用
* 🔑 **キー保護** - APIキーを安全に保存
* 🚫 **データ保持なし** - APIМartは会話コンテンツを保存しません

<Warning>
  **プライバシー通知：** ドキュメントはローカルに保存されていますが、AIに送信される会話と検索されたコンテンツは、処理のためにAPI経由でAPIМartサーバーに送信されます。機密情報を含むコンテンツのアップロードやクエリは避けてください。
</Warning>

## ベストプラクティス

### 1. ドキュメント管理

* **定期的な更新** - ドキュメントコンテンツを最新に保つ
* **構造化された整理** - 明確なフォルダ構造を使用
* **命名規則** - 意味のあるファイル名を使用
* **古いものを削除** - 定期的に古いドキュメントをクリーンアップ

### 2. プロンプトの最適化

**❌ 悪いプロンプト：**

```
あなたはアシスタントです
```

**✅ 良いプロンプト：**

```
あなたは製品関連の技術的な問題を解決することを専門とする専門的な技術サポートアシスタントです。

回答する際は、以下の原則に従ってください：
1. 提供されたドキュメントに基づいて回答し、情報が利用できない場合は明確に述べる
2. 必要に応じて例を含む詳細な手順説明を提供
3. 明確で理解しやすい言語を使用
4. 複雑な問題については、技術サポートチームへの連絡を推奨
```

### 3. パフォーマンスの最適化

* **ドキュメントサイズの制御** - 過度に大きな個別ファイルのアップロードを避ける
* **合理的なチャンク分割** - デフォルトのドキュメントチャンク設定を使用
* **適切なモデルを選択** - タスクの複雑さに基づいてモデルを選択
* **使用量の監視** - API使用状況を定期的に確認

### 4. ワークスペースプランニング

* **プロジェクトごとに分割** - 異なるプロジェクト用に独立したワークスペースを作成
* **権限管理** - ワークスペース権限を適切に設定（Docker版）
* **データのバックアップ** - 重要なワークスペースを定期的にバックアップ

## サポート＆ヘルプ

問題が発生した場合：

* 📚 [APIМartドキュメント](https://docs.apimart.ai)
* 📚 [AnythingLLM公式ドキュメント](https://docs.anythingllm.com/)
* 📚 [AnythingLLM GitHub](https://github.com/Mintplex-Labs/anything-llm)
* 💬 [Discordコミュニティ](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 テクニカルサポート：[zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="APIМartを使い始める" icon="rocket" href="https://apimart.ai">
  今すぐAPIМartに登録してAPIキーを取得し、AnythingLLMでプライベートナレッジベースを構築しましょう！
</Card>
