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

# AI エージェントセットアップガイド

> ライセンスキーから、Discord のチケットに回答する AI エージェントまで。

セットアップには約 15 分かかります。必要なものは 4 つです：

* EchoAuth AI エージェントの**ライセンスキー**。まだお持ちでない場合は、[ショップで購入](https://shop.echoauth.dev/product/echos-ai-agent-hosted)してください。
* ボットの追加とロールの管理ができる **Discord サーバー**。
* **[OpenRouter](https://openrouter.ai) API キー**。OpenRouter のキー 1 つで、エージェントに必要なすべて（回答、スクリーンショットの認識、検索）をまかなえます。
* 任意：エージェントが回答の根拠にする**ドキュメントサイト**または文書。

エージェントは私たちがホスティングし、稼働を維持します。セットアップは [agent.echoauth.dev](https://agent.echoauth.dev) のダッシュボードで行います。

> [!NOTE]
>
> \*\*推奨構成。\*\*長期間のテストは OpenRouter のみで、次の 3 つのモデルを使って行いました：
>
> | 役割 | モデル |
> | - | - |
> | チャット / エージェント | `deepseek/deepseek-v4-flash-0731` |
> | 埋め込み（Embedding） | `qwen/qwen3-embedding-8b` |
> | ビジョン（画像認識） | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
>
> ダッシュボードでは他のプロバイダー（NVIDIA、OpenAI、Anthropic）も利用できますが、長期間テストしてきたのはこの組み合わせです。

## 1. アカウントを作成する

**1. 登録ページを開く**

[agent.echoauth.dev/register](https://agent.echoauth.dev/register) に移動します。

**2. ライセンスキーを入力する**

購入メールに記載されたキーを貼り付けます。`ECHO-XXXX-XXXX-XXXX-XXXX` のような形式です。

**3. ユーザー名とパスワードを選ぶ**

パスワードは 8 文字以上必要です。**Create account** をクリックします。

![ライセンスキー、ユーザー名、パスワードの入力欄がある登録フォーム](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/01-register.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=572419f600e4182cf06122e903cf3aa6)

登録ページ

ライセンスが有効になると、エージェントが自動的に作成されます。ダッシュボードに移動し、エージェント、ライセンス、使用状況が表示されます。

![エージェント 1 件、ライセンスの状態、使用状況を表示するダッシュボード](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/02-dashboard.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=2397a77fc1428106e09dcbc3b2869dab)

サインイン後のダッシュボード

> [!NOTE]
>
> **No agents yet** と表示されている場合は、サイドバーの **License** を開いて、ライセンスが有効かどうかを確認してください。

エージェントをクリックして、そのページを開きます。このガイドの以降の操作はすべてここから始まります：**Configure** で設定を開き、**Live logs** でエージェントの動作を確認し、**Update Agent** で再デプロイが必要な設定を反映します。

![Configure、Live logs、Restart、Update Agent があるエージェントページ](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/03-agent.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=6c4ca792bd16efd8e9e175519f337123)

エージェントページ

## 2. Discord ボットを作成する

エージェントは、あなた自身の Discord ボットを通して回答します。Discord Developer Portal で作成してください。

**1. アプリケーションを作成する**

[Discord Developer Portal](https://discord.com/developers/applications) を開き、**New Application** をクリックします。サポートエージェントに合わせた名前（例："Acme Support"）を付けます。

**2. Message Content intent をオンにする**

**Bot** に移動します。**Privileged Gateway Intents** で **Message Content Intent** をオンにし、保存します。

> [!WARNING]
>
> この intent がないと、ボットは空のメッセージを受信し、返信しません。

**3. ボットトークンをコピーする**

引き続き **Bot** で、**Reset Token** をクリックしてトークンをコピーします。次のセクションでダッシュボードに貼り付けます。トークンを持っている人は誰でもボットを操作できるため、他人に見せないでください。

**4. ボットをサーバーに招待する**

**OAuth2** → **URL Generator** を開きます。スコープ `bot` と `applications.commands` にチェックを入れ、次のボット権限を選択します：

* View Channels
* Send Messages
* Read Message History
* Embed Links
* Attach Files

生成された URL を開いて、ボットをサーバーに追加します。

**5. ボットがチケットカテゴリにアクセスできるようにする**

ボットのロールが、チケットチャンネルが作成されるカテゴリを見られることを確認してください。チャンネルが見えないと、回答できません。

## 3. キーを追加する

[openrouter.ai/keys](https://openrouter.ai/keys) で API キーを作成し、OpenRouter アカウントにクレジットを追加します。ビジョンモデルは無料ですが、チャットと埋め込みモデルは従量課金です。

その後、エージェントページで **Configure** をクリックし、**API Keys** タブを開きます。

![OpenRouter API キーと Discord ボットトークンが設定済みと表示された API Keys タブ](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/04-keys.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=635dd8eb112950e6f74cfdc24c4f5664)

API Keys タブ。OpenRouter キーと Discord ボットトークンが設定済み

1. **OpenRouter API Key** にキーを貼り付けます。
2. **Discord Bot Token** を貼り付けます。
3. **Save** をクリックします。

OpenAI、Anthropic、NVIDIA の欄は空欄のままでかまいません。キーは暗号化して保存され、保存後は二度と表示されません。**configured** バッジが、キーが設定されていることを示します。

## 4. AI モデルを選ぶ

**AI Settings** タブを開きます。エージェントは 3 つのモデルを使います。3 つすべてを **OpenRouter** に設定し、推奨モデルを選びます：

| 設定 | 役割 | プロバイダー | モデル |
| - | - | - | - |
| **Chat / Agent Model** | 回答を作成し、ドキュメントで何を検索するかを判断します。 | OpenRouter | `deepseek/deepseek-v4-flash-0731` |
| **Vision Model** | 顧客がチケットに添付するスクリーンショットを読み取ります。 | OpenRouter | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
| **Embedding Model** | ドキュメントのインデックスを作成し、検索します。 | OpenRouter | `qwen/qwen3-embedding-8b` |

![チャット、ビジョン、埋め込みモデルのすべてで OpenRouter が選択された AI Settings タブ](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/05-ai.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=9c43f2bab0d0ade4e7a897f04f0a21f0)

推奨の OpenRouter モデルを設定した AI Settings タブ

> [!NOTE]
>
> 埋め込みモデルの下に、ダッシュボードから 2000 次元を超えているという警告が表示されます。`qwen/qwen3-embedding-8b` では想定どおりです。検索は引き続き動作します。インデックスを使わずにすべてのパッセージを確認しますが、数千パッセージ程度のナレッジベースであれば高速のままです。

次に **Base Prompt** を作成します。これはエージェントへの常時の指示で、誰のために働くか、どんなトーンを使うか、何を絶対にしてはいけないかを定めます。例：

```text theme={null}
You are the support agent for Acme Store. Be friendly and concise.
Answer only from the documentation. If you are not sure, ask a staff member to step in.
```

> [!WARNING]
>
> インデックスを作成する前に、埋め込みモデルを決めておいてください。後で変更すると、インデックスを再構築するまで既存のインデックスは使えなくなります。

## 5. チケットと接続する

**Discord** タブを開きます。これらの設定は、エージェントがどこで回答するか、そして誰がスタッフに当たるかを指定します。

![オーナーロール、スタッフロール、チケットカテゴリ ID、チケットボット ID、画像モデルを表示する Discord タブ](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/06-discord.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=43f9146b21aa094f8d7629f409930f57)

Discord タブ

ID をコピーするには、Discord の **User Settings** → **Advanced** で **Developer Mode** をオンにします。その後、ロール、カテゴリ、ユーザーを右クリックして **Copy ID** を選びます。

> [accordion] Owner Role IDs
>
> `/pause_bot` や `/edit_base` を含むすべてのスラッシュコマンドを使えるロールです。複数の ID はカンマで区切ります。

> [accordion] Staff Role IDs
>
> サポートチームのロールです。スタッフがチケットで発言すると、エージェントは身を引き、そのチケットでは沈黙します。再開させるには、チケットでボットをメンションするか、そこで `/restart` を使います。

> [accordion] Ticket Category IDs
>
> チケットチャンネルが作成されるカテゴリです。エージェントはこれらのカテゴリ内でのみ回答します。

> [accordion] Ticket Bot IDs
>
> Ticket Tool や SellAuth Tickets など、チケットボットのユーザー ID です。エージェントは他のボットを無視するため、チケットの最初のメッセージを読めるように、ここにあなたのボットを追加してください。

> [accordion] Image Models
>
> AI Settings のビジョンモデルが失敗した場合に順番に試すバックアップ用ビジョンモデルで、、1 行に 1 つずつ入力します。次のフォールバックを入れてください：\
> `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free`\
> `google/gemma-4-31b-it:free`\
> `google/gemma-4-26b-a4b-it:free`\
> `thinkingmachines/inkling-small:free`\
> `dots-studio/dots-3-note-preview:free`

**Save** をクリックします。

## 6. エージェントにドキュメントを渡す

**Knowledge Base** タブを開きます。エージェントは 2 つのソースから回答します。どちらか、または両方を使えます。

![Index documentation ボタン、Docs URL、内部ナレッジベースがある Knowledge Base タブ](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/07-knowledge.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18150d070975d8635a2a87c251b04dfa)

Knowledge Base タブ

> [tab] ドキュメントサイト
>
> ドキュメントを Mintlify で公開している場合に使います。
>
> 1. **Docs URL** を末尾のスラッシュなしで入力します。例：`https://docs.acme-store.com`。サイトは `/llms.txt` を提供している必要があります（Mintlify は自動的に提供します）。
> 2. **Save** をクリックしてから、エージェントページに移動して **Update Agent** をクリックします。
> 3. このタブに戻り、**Index documentation** をクリックします。数百ページで数分かかり、実行中はページを離れても構いません。
>
> **Sync Mode** を **Poll llms.txt hourly** にすると、エージェントは 1 時間ごとにドキュメントを確認し、変更されたページだけを再インデックスします。

> [tab] 内部ナレッジベース
>
> ドキュメントサイトにないものすべて（FAQ、ポリシー、エラーコードなど）に使います。
>
> 1. **Internal Knowledge Base** までスクロールします。
> 2. テキストを貼り付けるか、**Load file** をクリックして `.txt` または `.md` ファイルを選びます。
> 3. **Save** をクリックします。
>
> エージェントは約 1 分以内にインデックスを作成します。プレーンテキストで問題ありません：全て大文字の見出しや `=====` の行に挟まれた見出しが、検索可能なセクションになります。

**Documentation Retrieval** と **Agentic Retrieval** はオンのままにしてください。オンにすると、エージェントは毎回すべてを読むのではなく、各質問に関連するパッセージだけを検索します。

## 7. 返信のタイミングとエスカレーションを設定する

**Behavior** タブを開きます。

![返信タイミングと人間のサポート用キーワードを表示する Behavior タブ](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/08-behavior.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=14df915b4ac0f9860f6e3a6b3a61d318)

Behavior タブ

エージェントは、顧客が入力をやめるのを待ってから、すべてに 1 つの返信で答えます。新しいメッセージが来るたびに、タイマーがリセットされます。

| 設定 | デフォルト | 意味 |
| - | - | - |
| After ticket opens | 45 秒 | 顧客が詳細やスクリーンショットを追加することが多いため、最初のメッセージ後の待機時間。 |
| After each message | 30 秒 | その後のメッセージの後、返信する前に必要な無発言時間。 |
| Maximum wait | 180 秒 | 顧客が入力を続けていても、この時間が過ぎたら返信します。 |

**Human Help Keywords** では、チケットをチームに引き継ぐ言葉を1 行に 1 つずつリストします。例：`refund`、`chargeback`、`real person`。

## 8. アラートを受け取る（任意）

**Notifications** タブを開き、プライベートなスタッフチャンネルの ID を貼り付けます。ライセンスの期限が近づいたときや、AI プロバイダーがキーを拒否したとき、クォータを使い切ったときに、エージェントがここに投稿します。

![通知チャンネル ID を表示する Notifications タブ](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/09-notifications.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=5906f4bf0dbdf4fa308c4958553bded2)

Notifications タブ

## 9. エージェントを開始する

エージェントページに戻り、**Update Agent** をクリックします。これにより、ボットトークン、ドキュメント URL、埋め込みモデルを反映してエージェントが再デプロイされます。実行中は、ボタンの下に出力が表示されます。

> [!NOTE]
>
> ほとんどの設定は、再デプロイなしで約 1 分以内に稼働中のエージェントに反映されます。**Update Agent** が必要なのは、**Discord Bot Token**、**Docs URL**、**Embedding Model**、**Sync Mode** を変更した場合だけです。

すべてが動作するか確認するには：

1. サーバーでテスト用のチケットを開き、ドキュメントが答えられる質問をしてみます。
2. エージェントページで **Live logs** を開き、エージェントがメッセージを受信し、ドキュメントを検索し、返信する様子を確認します。

![エージェントの起動、同期、ドキュメント検索、チケットへの返信を示す Live logs](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/11-logs.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18d1bd77e85407858cd81751cd36388e)

Live logs

エージェントが動作中は、ステータスバッジが **Online** と表示されます。

## スラッシュコマンド

エージェントがサーバーに参加すると、オーナーとスタッフは Discord から操作できます。

| コマンド | 対象 | 動作 |
| - | - | - |
| `/stop` | オーナー、スタッフ | このチャンネルでのエージェントの返信を停止します。 |
| `/restart` | オーナー、スタッフ | このチャンネルで再びエージェントが返信できるようにします。 |
| `/mute_existing` | オーナー、スタッフ | すでに開いているすべてのチケットでエージェントを停止します。 |
| `/pause_bot` | オーナー | すべての場所でエージェントを一時停止します。 |
| `/resume_bot` | オーナー | すべての場所でエージェントを再開します。 |
| `/edit_base` | オーナー | ベースプロンプトを編集します。 |
| `/chat_model` | オーナー | チャットモデルを変更します。 |

ダッシュボードの **Discord** タブにある **Global Bot Pause** でも、エージェントを一時停止できます。

## ライセンスを有効に保つ

ライセンスが有効な間、エージェントはオンラインを維持します。**License** ページには残り日数と有効期限が表示されます。

![ステータス、残り日数、利用可能なプランを表示する License ページ](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/10-license.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=62db270604520c9a0c2815db6201b908)

License ページ

更新するには、[ショップ](https://shop.echoauth.dev/product/echos-ai-agent-hosted)で新しいキーを購入し、**Renew license** をクリックしてキーを貼り付けます。時間は現在のライセンスに加算されます。

## トラブルシューティング

> [accordion] ボットはオンラインだが、一度も返信しない
>
> * Discord Developer Portal で **Message Content Intent** がオンになっているか確認してください。
> * チケットのカテゴリ ID が **Ticket Category IDs** に含まれているか確認してください。
> * ボットがそのカテゴリでメッセージを見て送信できるか確認してください。
> * スタッフがすでにチケットで発言していないか確認してください。ボットをメンションするか `/restart` で再開させます。
> * **Global Bot Pause** がオフになっているか確認してください。

> [accordion] ボットがチケットの最初のメッセージを無視する
>
> **Discord** タブの **Ticket Bot IDs** に、チケットボットのユーザー ID を追加してください。

> [accordion] エージェントがドキュメントを使っていない
>
> **Knowledge Base** タブを開きます。**Documentation is not indexed yet** と表示されている場合は、**Index documentation** をクリックしてください。**The index does not match the embedding model** と表示されている場合は、**Clear and rebuild the index** をクリックするか、埋め込みモデルを表示されているものに戻して保存してください。

> [accordion] 返信やインデックス作成が OpenRouter のエラーで失敗する
>
> OpenRouter アカウントにクレジットがあること、そして **API Keys** タブのキーがまだ有効であることを確認してください。ビジョンモデルのような無料モデルは、混雑している時間帯にレート制限されることがあります。その場合、エージェントは **Image Models** の次のモデルにフォールバックします。

> [accordion] エージェントが応答しなくなった
>
> **Live logs** を開いて、エラー（無効なキーやクレジットの果てなど）がないか確認します。その後、エージェントページの **Restart** をクリックします。改善しない場合は、**Update Agent** をクリックしてください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.