ナレッジ エージェントを作成する
早期アクセス始める前に
設定全体を通じて、次のガイドラインに留意してください。
- ナレッジ ソース とプロンプトで同じ言語を使用します。
- ブランド名、エージェントの目的、ナレッジソースのコンテンツに一貫性を持たせます。矛盾により、エージェントは矛盾した応答をします。
- プロンプト作成のベストプラクティスについては、AIエージェントのプロンプトの作成を参照してください。
製品 A のドキュメントをアップロードし、プロンプト You should be a helpful agent for product B と書くと、エージェントは相反する答えを出します。
エージェントを作成する
アカウントごとに最大 3 つのナレッジ エージェント を作成できます。制限に達すると、ナレッジ エージェントの作成 ボタンは使用できません。新しいエージェントを作成するには、まず既存のエージェントを削除します(/agentos-ai-agents/knowledge-agents/manage-knowledge-agents#delete-a-knowledge-agent)。
- NTT CPaaS Webインターフェイスで、AIエージェント > マイエージェント > ナレッジエージェントタブに移動します。
- ナレッジ エージェントの作成 を選択します。
- エージェントの一意の名前を入力します。この名前はエンドユーザーには表示されません。
- [エージェント]タブで、エージェント設定の設定をクリックします。
- ナレッジベースタブで、ナレッジソースの接続をクリックします。
- エージェントの保存 を選択します。
エージェント設定を構成する
[エージェント] タブで、次のフィールドを設定します。
| フィールド | 説明 |
|---|---|
| 説明 | エージェントが何をしているかを説明してください (たとえば、このエージェントは、会社のナレッジ ベースを使用して、当社の製品に関する顧客の質問に回答します)。この説明は内部参照のみを目的としており、エンドユーザーには表示されません。 |
| 手順 | エージェントの行動、ペルソナ、境界、および応答スタイルを定義します。この手順は、エンド ユーザーへの応答方法をエージェントに指示します。ペルソナ、応答行動、禁止されているトピック、会話の例を含めます。 |
例
- You are a helpful knowledge assistant for [COMPANY].
- Answer questions based on the provided documentation.
- Be concise, accurate, and friendly.
- If the answer is not in the documentation, say so honestly — do not make up facts.
- Support follow-up questions using conversation context.
- Do not answer questions about: [competitors, politics, or other off-topic subjects].
- Example: "I'm sorry, I can only help with questions about [COMPANY] products and services."
- Example conversation:
User: What are your business hours?
Assistant: Based on our documentation, we're open Monday to Friday, 9 AM to 5 PM.
User: Are you open on weekends?
Assistant: No, we're currently closed on weekends.応答設定
エージェントが応答を生成する方法を設定します。
| 設定 | 説明 |
|---|---|
| セッションウィンドウ | 応答の生成時にコンテキストとして含まれる現在の会話からの最近のメッセージの数。ウィンドウが大きいほど、継続性が向上します。ウィンドウを小さくすると、処理のオーバーヘッドが削減されます。最小値: 0。最大値: 10。 |
| 取得したチャンク | 取得され、コンテキストとしてモデルに渡されるナレッジ ベース チャンクの数。数値が大きいほど、より広いコンテキストが得られます。数値が小さいほど、応答の焦点が絞られます。範囲:1〜4。 |
| 出力トークン | モデルが 1 つの応答で使用できるトークンの最大数。この設定では回答の長さのみが制限され、プロンプトを使用して回答のスタイルと簡潔さを制御します。最小値: 1。最大値: 512。 |
| 温度 | モデルの応答がどの程度予測可能か、または変化するかを制御します。値を低くすると、一貫性のある焦点を絞った回答が得られます。値を大きくすると、より多様な応答が生成されますが、事実の精度が低下する可能性があります。範囲:0〜2。 |
高温値は避けてください。エージェントは、不正確または不明瞭な応答を生成する可能性があります。
インデックス設定
ナレッジ ベース コンテンツのインデックス作成方法を構成します。
| 設定 | 説明 |
|---|---|
| 段落サイズ | ナレッジ ベース インデックス内の各コンテンツ チャンクのサイズ。値が大きいほど、チャンクごとにより多くのコンテキストがキャプチャされます。値を小さくすると、より詳細な取得が可能になります。最小値: 1。最大値: 900。 |
| 重複するトークン | ナレッジベースインデックス内の隣接するチャンク間で共有されるトークンの数。重複を増やすと、関連するコンテンツがチャンク境界を越えて分割される可能性が低くなります。最小値: 0。最大値: 50。 |
安全
コンテンツフィルタを設定して、エージェントが議論できる内容とできない内容を制御します。ガードレールは、ユーザーメッセージ内の有害なコンテンツを検出します。1 つ以上のガードレールを選択して、以下を有効にします。
- 嫌い
- 自傷行為
- 暴力
- 性的
- 脱獄シールド
ガードレールの設定の詳細については、ガードレールの設定(/agentos-ai-agents/ai-agents/configure-guardrails)を参照してください。
詳細設定
ナレッジ エージェントのプロンプト テンプレートを構成します。
プロンプト テンプレート
コンテキストとエンドユーザーの質問をモデルに送信する前に書式設定する方法を制御するカスタム指示テンプレート。デフォルトのテンプレートは事前設定されており、ほとんどのユースケースで機能します。
必須変数 (変更せずに含む):
{context_str}: ナレッジソースから取得したコンテンツ{query_str}: ユーザーの質問の終わり
オプション変数:
{prompt_var}: 実行時に渡される追加のコンテキスト
変数 {context_str}、{query_str}、および {prompt_var} は英語で記述する必要があります。
変数の周囲に ### や ** などの区切り文字を使用して、モデルが命令と挿入されたコンテンツを区別できるようにします。
既定のテンプレート
- Parts of the documentation: ###{context_str}###
- Answer the users question: **{query_str}**