

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# チャットエージェントのコンテキストソースとベストプラクティス
<a name="agent-knowledge-sources-best-practices"></a>

Amazon Quick でカスタムチャットエージェントを作成する場合、チャットエージェントの動作とフレームチャットエージェントのワークフローに影響を与える複数のオプションがあります。チャットエージェントのコンテキストと手順を設定する方法は、チャットエージェントがユーザーインタラクションを実行および応答する方法に大きな影響を与えます。指示書、リファレンスドキュメント、スペースをいつ使用するかを理解することは、特定のビジネスニーズを満たす効果的なチャットエージェントを作成し、一貫性のある信頼性の高い結果を提供する上で不可欠です。以下のセクションでは、ユースケースでチャットエージェントのコンテキストと知識を最大限に活用する方法について説明します。

**Topics**
+ [エージェントコンテキストのタイプ](#knowledge-source-types)

## エージェントコンテキストのタイプ
<a name="knowledge-source-types"></a>

Amazon Quick には、チャットエージェントの動作を設定するための 3 つの異なる方法が用意されており、それぞれがチャットエージェント開発で異なる目的を果たします。各メソッドがコンテンツをどのように処理し、いつ使用するかを理解することが、効果的なチャットエージェント設定の基盤となります。

Amazon Quick で使用できる 3 つのコンテキストタイプは次のとおりです。
+ **ペルソナの手順** – Amazon Quick が生成機能を使用して強化する大まかなガイダンス AI
+ **リファレンスドキュメント** – 正確な手順を提供し、チャットエージェントのメモリでアクティブなままのドキュメント
+ **スペース** – チャットエージェントが質問に答えるために情報を取得する、検索可能な Amazon Quick リソースとドキュメントのコレクション

次のセクションでは、これらとは何か、およびそれらを使用するためのベストプラクティスについて詳しく説明します。

**Topics**
+ [チャットエージェントのペルソナの手順](#agent-instructions)
+ [チャットエージェントのリファレンスドキュメント](#in-context-files)
+ [チャットエージェントとスペース](#spaces)

### チャットエージェントのペルソナの手順
<a name="agent-instructions"></a>

カスタムチャットエージェントを作成するときは、**Persona instructions フィールドにチャットエージェントのペルソナの手順**を指定します。これらのペルソナ命令は、生成 AI を使用して改良され、すべてのチャット機能とチャットエージェント用に設定されたリソースで動作するようにします。このアプローチは、システムが基本的な方向性に基づいて構築する場合に最適です。ペルソナ命令を使用すると、Amazon Quick は生成AIを使用してバックエンドのペルソナ命令を解釈して拡張し、追加のコンテキストと機能でシンプルなガイダンスを強化し、プロンプトを最適化してチャットエージェントのパフォーマンスを向上させ、 AI主導の改善を通じて有効性を向上させます。

**ペルソナの手順を使用して、次の操作を行います。**
+ Amazon Quick AI によって強化され、エージェントの応答をカスタマイズする動作と目標に関する高レベルのガイダンスを提供します。
+ 詳細なやり取りにリファレンスドキュメントを活用する方法を指示する
+ レスポンスでのスペースとアクションコネクタの使用に関する一般的なガイダンスを提供する

このアプローチは、汎用チャットエージェントや、チャットエージェント設計AIの支援の恩恵を受けたい探索的なユースケースに最適です。

**注記**  
AI 拡張プロセスでは、チャットエージェントのパフォーマンスを向上させるために、元の文言と構造が変更される場合があります。変更しない必要がある重要なガイドラインは、代わりにリファレンスドキュメントに配置する必要があります。

### チャットエージェントのリファレンスドキュメント
<a name="in-context-files"></a>

リファレンスドキュメントには、チャットエージェントが従う必要がある特定のプロセステンプレートとレスポンステンプレートが記載されています。これらのリファレンスドキュメントは、チャットエージェントの永続的なコンテキストの一部であり、ペルソナの指示と応答スタイルhand-in-hand、全体的な動作を通知します。

リファレンスドキュメントでは、コンテンツを記述されたとおりに保持することで、チャットエージェントの動作を完全に制御できます。このアプローチは、精度と一貫性が最優先事項である場合に不可欠です。リファレンスドキュメントをアップロードすると、Amazon Quick は正確な文言と特定の指示を保持し、正確な形式と構造を維持し、チャットエージェントの動作を直接制御し、すべてのやり取りの一貫性を確保します。

**必要に応じてリファレンスドキュメントを使用します。**
+ 正確な文言と特定の指示を保持する必要がある正確な制御
+ 特定のトーン、用語、またはレスポンス形式とのブランド整合性
+ 正確なシーケンスに従う必要がある複数ステップのプロセスを含む複雑なワークフロー
+ すべてのインタラクションで一貫したレスポンスを持つ予測可能な動作

**サポートされているファイル形式:**
+ `.pdf`、`.txt`、`.html`、 `.md` – 手順、テンプレート、ガイドライン
+ `.csv` – リファレンスデータ、ルックアップテーブル、および例
+ `.doc`、 `.docx` — 詳細なプロセスドキュメント

リファレンスドキュメントとして、合計サイズ 50 MB のファイルを最大 10 個アタッチできます。Amazon Quick は、これらのドキュメントからテキストを抽出し、処理後に 100K文字の制限を適用します。

**ファイルの優先順位付けと動作**  
ユーザーが代替コンテンツをアタッチしても、ファイルからの動作フレームワークと参照データはアクティブのままです。
ユーザーが競合するフォーマット手順を提供する場合、レスポンステンプレートは一時的に調整される場合があります。

リファレンスドキュメントは、チャットエージェントの運用マニュアルとして機能し、チャットエージェントとのすべてのユーザーインタラクションにわたって一定の動作フレームワークを提供します。

### チャットエージェントとスペース
<a name="spaces"></a>

スペースは、チャットエージェントが会話中にクエリして特定の情報を取得する動的で検索可能なナレッジリポジトリを提供します。スペースをチャットエージェントにリンクすると、Amazon Quick チャットエージェントはスペース内の回答を検索してレスポンスを生成します。スペースは、時間の経過とともに進化する組織の知識を管理することに長けており、複数のチームメンバーが Amazon Quick のアクセス許可システムを通じて適切なセキュリティ境界を維持しながら、情報を提供および更新できます。

チャットエージェントでスペースを使用する目的:
+ チャットエージェントが現在のビジネスデータを検索および取得できるようにする
+ チャットエージェントに組織のナレッジリポジトリへのアクセスを提供する
+ チャットエージェントが既存のアクセス許可の境界を尊重できるようにする
+ チャットエージェントを共同ドキュメントコレクションに接続する
+ チャットエージェントに定期的に更新された情報へのアクセスを許可する
+ チャットエージェントがライブダッシュボードとデータセットをクエリできるようにする

スペースはチャットエージェントの動的ナレッジレイヤーとして機能し、セキュリティの境界とコラボレーションワークフローを維持しながら、組織情報にリアルタイムでアクセスできます。