翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Quick で AI を活用したチャットエージェントを作成、カスタマイズ、デプロイする
Amazon Quick のチャットエージェントは、ユーザーがデータを探索し、情報を分析して、アクションを実行するのに役立ちます。ユーザーは、クイックチャットインターフェイスを使用してチャットエージェントとやり取りできます。チャットエージェントは、特定の目標、知識のソース、および接続されたツールでサポートされているオープンエンドの会話を通じてサポートを提供します。チャットエージェントは、シンプルな質疑応答インターフェイスから、複雑なワークフローを調整するより高度な関数に進化できます。
チャットエージェントを使用すると、次のことができます。
+ 自然言語の会話を通じてコンテンツを生成し、回答を提供する
+ 接続されたスペース、ダッシュボード、トピック、データセット、アップロードされたファイルからの情報を分析して要約する
+ アクションを呼び出して、一貫性のある繰り返し可能な結果を得るために事前定義されたステップを実行する
**注記**
チャットエージェントを使用したチャットの詳細については、[「Amazon Quick Chat ](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html)の使用」を参照してください。
**Topics**
+ [チャットエージェントタイプ](#agent-types)
+ [Amazon Quick ユーザーとチャットエージェントとのやり取り](#user-agent-actions)
+ [チャットエージェントの Amazon Quick ユーザーアクセス許可](#user-agent-permissions)
+ [チャットエージェントのカスタムアクセス許可](#custom-permissions-chat-agents)
+ [システムチャットエージェント](default-assistant.md)
+ [カスタムチャットエージェント](custom-agents.md)
+ [チャットエージェントのコンテキストソースとベストプラクティス](agent-knowledge-sources-best-practices.md)
+ [チャットエージェントを使用する](use-agents.md)
## チャットエージェントタイプ
Amazon Quick は、次の 2 種類のチャットエージェントをサポートしています。
+ **システムチャットエージェント** – このチャットエージェント (「アシスタント」) は、デフォルトですべてのユーザーが自動的に使用できます。システムチャットエージェントは、固有のデータや独自のアクションを持たないベースプランナーとして機能します。チャット中に各ユーザーが利用できるリソースに動的にアクセスするため、個々のユーザーのアクセス許可と利用可能なコンテンツに合わせて調整できます。管理者ユーザーは、特定のユーザーを所有者として割り当ててシステムチャットエージェントの設定を制御し、ペルソナやその他の設定をカスタマイズできるようにします。
システムチャットエージェントは、ファイルのアップロード機能、LLM ナレッジアクセス、毒性やその他のガードレール、ウェブ検索など、すべてのチャット機能で有効になります。また、スペース、トピック、ダッシュボード、ナレッジベース、ユーザーのアクセス許可に基づくアクションへのアクセスを提供するチャットデータスコープメカニズムも含まれています。
+ **カスタムチャットエージェント** – これらのチャットエージェントは、Amazon Quick のチャットエージェント作成機能を持つユーザーが作成および特定のユースケースに合わせてカスタマイズでき、誰でも共有できます。管理者は、特定のユーザーとグループがカスタムチャットエージェントを作成するのを制限しながら、ユーザーがチャット経由でチャットエージェントを使用できるようにすることを選択できます。チャットエージェントは、呼び出し元のユーザーがアクセス許可を持っているコンテンツに限定されたレスポンスを返します。
カスタムチャットエージェントは、次の方法で Amazon Quick リソースとやり取りできます。
+ **リソースで事前設定**済み – これらのチャットエージェントは、失敗した動作として回答を探したり、アクションを調整したりするときに、設定されたリソース (ナレッジソースとしてのスペース、ツールとしてのアクションコネクタなど) のみを使用します。チャット中に、ユーザーは必要に応じて追加のリソースをアタッチしたり、アクションを直接呼び出すことができます。たとえば、ファイルを含むスペースのみで構成されるチャットエージェントは、ユーザーが明示的に呼び出さない限り、デフォルトでアクションを実行できません。同様に、アクションのみで構成されるチャットエージェントは、ユーザーがエンタープライズ固有の回答用にスペースまたはダッシュボードをアタッチしない限り、LLM の知識に依存します。ただし、ユーザーは追加のスペースをアタッチしたり、チャットインターフェイス内でアクセスできる他のアクションを直接呼び出すことができます。
+ **ビルド時に意見を述べない** – これらのチャットエージェントは、構築時にリソース (スペース、アクションコネクタ、またはその両方) で最初に設定されることはありません。チャットは、チャットエージェントのリソース境界を決定します。たとえば、チャットエージェントにスペースが設定されていない場合、ユーザーが変更を加えるまで、チャットはデフォルトですべてのスペースまたは LLM ナレッジになります。チャットエージェントにアクションコネクタが設定されていない場合、チャット中に、ユーザーがアクセスできるすべてのアクションは、ユーザーがアクションを含まないリソースを選択するまで、エージェントが使用できます。
チャット中のユーザーリソースの選択は、チャットエージェントの動作に影響します。ユーザーがスペースを選択した場合、チャットエージェントはそのスペース内のデータでのみ応答し、そのスペース内で利用可能なアクションを実行します (ビルド時に意見を述べていない場合）。ユーザーがダッシュボード、トピック、またはナレッジベースを選択した場合、チャットエージェントはそのソースからのみ応答し、フォーカスが特定のデータソースに変更されるため、アクションを実行しません。包括的なサポートを受けるには、チャット内のすべての関連リソースを選択する必要があります。
**注記**
システムチャットエージェントは、設計上、操作されていないチャットエージェントです。データフォーカスに関係なく、チャットエージェントがすべてのアクションにアクセスする場合は、アクションコネクタを使用してチャットエージェントを設定します。
## Amazon Quick ユーザーとチャットエージェントとのやり取り
次の表は、Amazon Quick ユーザーとしてではなく、管理者コンソールでチャットエージェントで何ができるかを示しています。これらの機能にアクセスできるロールの詳細については、[Amazon Quick 料金](https://aws.amazon.com/quicksuite/pricing/)ドキュメントを参照してください。
| アクセスレベル | 機能 |
| --- | --- |
| 管理者コンソール | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/working-with-agents.html) |
| Amazon Quick ユーザー | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/working-with-agents.html) |
## チャットエージェントの Amazon Quick ユーザーアクセス許可
チャットエージェントでできることは、割り当てられたアクセス許可にも依存します。ユーザーに割り当てることができるアクセス許可タイプは 2 つあります。
+ **所有者** – 所有者はチャットエージェントを編集、共有、削除できます。
+ **ビューワー** – ビューワーはチャットエージェントを表示して使用できます。
**注記**
ビューワーまたは所有者としてリンクされたリソースにアクセスできない場合、別の所有者によってチャットエージェントに追加されたリソースは「リソースが使用不可」と表示されます。これらのリソースは所有者として削除できますが、リソースレベルの共有が必要なため、リストまたは追加することはできません。
クイック管理者は、チャットエージェントを作成するアクセス許可をユーザーに付与する必要があります。チャットエージェントを作成できるロールについては、[Amazon Quick の料金](https://aws.amazon.com/quicksuite/pricing/)ドキュメントを参照してください。これらの機能へのアクセスを提供する方法については、「 クイック管理ガイド」の[「カスタムアクセス許可](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html)」を参照してください。
次の表は、Amazon Quick Chat エージェントで何ができるかをユーザーアクセス許可が判断する方法の概要を示しています。
| アクセス許可タイプ | アクセス許可 |
| --- | --- |
| Owners | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/working-with-agents.html) |
| ビューワー | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/working-with-agents.html) |
## チャットエージェントのカスタムアクセス許可
デフォルトでは、Amazon Quick は Amazon Quick アカウントで使用できるすべての新機能を有効にし、ユーザーはサブスクリプションに基づいてすぐにアクセスできます。[カスタムアクセス許可](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html)を使用して、特定の機能を制限できます。管理者は、カスタムアクセス許可プロファイルを作成するときに、チャットエージェントに対して 2 種類の制限を作成できます。
+ デフォルトのエージェントとのチャット、カスタムエージェントとのチャット、新しいエージェントの作成など、ユーザーのすべてのチャットエージェント機能を完全に無効にできます。これを行うには、**チャットエージェントの**機能を制限します。
+ また、エージェントとのチャットに影響を与えずにエージェントを作成する機能を具体的に制限することもできます。これは、カスタムアクセス許可プロファイルを作成し、**チャットエージェントの作成**機能のみを制限することで実行できます。
**注記**
ユーザーがシステムエージェントを使用してチャットできるようにするが、チャットエージェントを作成しない場合は、チャットエージェントの作成機能のみを制限します。
Amazon Quick のエージェントのアクセス許可は、組織のニーズに合わせてさまざまな組み合わせで設定できます。アクセス許可の設定方法を理解するために、次のセクションでは、一般的なシナリオをグループ化するユースケース主導のアプローチを示します。
| ユースケースのシナリオ | ユーザーができること |
| --- | --- |
| すべての機能を備えたエージェント(チャットエージェント、スペース、ナレッジベース、アクション、フローに制限はありません) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/working-with-agents.html) |
| エージェントへのチャットのみのアクセス(エージェント機能は有効になっていますが、チャットエージェントの作成は制限されています) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/working-with-agents.html) |
| 他の 機能への制限付きアクセス(チャットエージェントは有効になっていますが、特定の機能は制限されています) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/working-with-agents.html) |
| チャットエージェントアクセスなし(エージェント機能が完全に制限されています) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/working-with-agents.html) |
# システムチャットエージェント
Quick にサインアップすると、Amazon Quick システムチャットエージェントが自動的に作成されます。これは、すべてのユーザーがデータを操作し、Quick 環境内でさまざまなタスクを実行するためのプライマリインターフェイスとして機能します。デフォルトのガードレールが付属しています。
システムチャットエージェントの所有権は、クイック管理者が管理します。管理者は、[カスタムアクセス許可](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html)を使用して、システムチャットエージェントを含むチャットエージェントとのチャットを無効にすることができます。有効にすると、管理者以外のロール (作成者とリーダー) を持つユーザーは、クイックチャットチャットエージェントを表示、一覧表示、呼び出し、使用できます。そのレスポンスは、アセットへのユーザーのアクセス許可に基づいてフィルタリングされます。
クイックシステムチャットエージェントは、カスタマイズを最小限に抑えながら、すぐにすべてのチャット機能を使用するように設定されています。これらの機能はカスタムチャットエージェントでも利用できますが、チャットエージェントの作成時に設定する必要があります。システムチャットエージェントには以下が含まれます。
+ プロフェッショナルなトーンとレスポンススタイルを備えた、クイックアシスタントとしてのデフォルトのペルソナ
+ チャットでのファイルアップロード機能が有効
+ 大規模言語モデル (LLM) ナレッジチャットが有効
+ 管理コンソールでチャット用に設定されたデフォルトのガードレールを使用します
+ ユーザーアクセス許可に基づくすべてのスペース、トピック、ダッシュボード、ナレッジベース、アクションへのアクセス
+ ウェブ検索機能
管理者所有者としてシステムチャットエージェントをカスタマイズする方法については、[「チャットエージェントのカスタマイズの管理](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-agent.html)」を参照してください。システムチャットエージェントへのアクセスを制御する方法については、[「アセットの管理](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-qs-assets.html)」を参照してください。
# カスタムチャットエージェント
カスタムチャットエージェントを使用すると、Amazon Quick ユーザーは特定のビジネスニーズに合わせてカスタマイズされた会話型インターフェイスを作成できます。デフォルトではチャット権限を持つすべてのユーザーが利用できるシステムチャットエージェントとは異なり、カスタムチャットエージェントは、承認されたユーザーによって選択的に共有および設定できます。
チャットエージェント作成機能を持つユーザーは、自然言語インターフェイスまたはエージェントビルダー設定フローを使用して、チャットエージェントのパーソナリティ、レスポンススタイル、機能をカスタマイズできます。これらのユーザーは、各リソースの共有とアクセス許可を個別に制御しながら、特定のナレッジソース (スペースなど) とワークフロー (アクションなど) でこれらのチャットエージェントを設定することもできます。または、チャットエージェントは、エンドユーザーがリソースのすべてまたは一部でエージェントを使用できるように、リンクを解除したままにしておくこともできます。
クイック管理者は、チャットエージェントを作成するアクセス許可をユーザーに付与する必要があります。チャットエージェントを作成できるロールについては、[Amazon Quick の料金](https://aws.amazon.com/quicksuite/pricing/)ドキュメントを参照してください。これらの機能へのアクセスを提供または制限する方法については、「 クイック管理ガイド」の[「カスタムアクセス許可](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html)」を参照してください。
**Topics**
+ [カスタムチャットエージェントの作成とプレビュー](#create-custom-agents)
+ [カスタムチャットエージェントを共有する](#share-custom-agents)
+ [カスタムチャットエージェントの埋め込み](#embed-custom-agents)
+ [カスタムチャットエージェントを更新する](#update-custom-agents)
+ [カスタムチャットエージェントへのアクセスを管理する](#remove-access-custom-agents)
+ [チャットエージェントを表示する](#view-agents)
+ [チャットエージェントの詳細を表示する](#view-agent-details)
+ [カスタムチャットエージェントの複製](#duplicate-agents)
+ [チャットエージェントを削除する](#delete-agents)
## カスタムチャットエージェントの作成とプレビュー
Amazon Quick ホームページのチャットエージェントメニューから、Amazon Quick でカスタム**チャットエージェント**を作成できます。チャットエージェントは、ビルド時にプレビューおよびテストできます。カスタムチャットエージェントを作成すると、デフォルトで所有者として割り当てられます。次の手順では、カスタムチャットエージェントを作成する方法の概要を説明します。
------
#### [ Using natural language ]
**自然言語プロンプトを使用してカスタムチャットエージェントを作成するには**
1. Amazon Quick コンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択し、**チャットエージェントの作成**を選択します。
1. **新しいチャットエージェント**で、次の操作を行います。
1. テキストボックスに、作成するチャットエージェントの種類に関する自然言語の説明を入力します。これは、Amazon Quick がチャットエージェントの作成に使用するプロンプトです。ページの推奨サンプル手順を使用して、チャットエージェントを作成することもできます。
1. 次に、**生成** を選択します。**Generate** を選択すると、指定された指示または目標を受け取り、チャットエージェントの指示と設定に展開されます。また、ユーザーの利用可能なリソース (スペースとアクションコネクタ) をスキャンし、提供されたチャットエージェントのインテントに基づいて最も関連性の高い一致を見つけます。拡張されたビルダー UI は、ユーザーが確認、カスタマイズ、テスト、起動できるように、これらの設定で開きます。
1. **チャットエージェントの設定**ページで、チャットエージェントに適切な設定があることを確認し、チャットエージェントをさらにカスタマイズします。プレビューでチャットエージェントを試す前に、プレビュー**の更新**をクリックして、すべての変更が保存されていることを確認します。
1. 準備ができたら、**チャットエージェントの起動** を選択してカスタムチャットエージェントをチャットエージェントライブラリに発行し、チャットで使用します。
**注記**
**チャットエージェントの起動** を選択するまで、チャットエージェントはチャットエージェントライブラリでは使用できません。起動せずに作成プロセスを終了すると、プレビューバージョンが削除され、チャットエージェントは保存されません。
チャットエージェントを起動しても、デフォルトではプライベートのままです。チャットエージェントは、共有後に他のユーザーのライブラリでのみ使用可能になります。共有されると、それ以降の編集と起動は、アクセス権を持つすべてのユーザーに対して同じチャットエージェントに変更を公開します。
------
#### [ Using builder view directly ]
**ビルダーモードを使用してカスタムチャットエージェントを作成するには**
1. Amazon Quick コンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択し、**チャットエージェントの作成**を選択します。
1. **エージェント作成者**で、**スキップ**を選択します。これにより、チャットエージェントの設定ページが開き、チャットエージェントを構築およびカスタマイズできます。
1. カスタムチャットエージェントの名前を追加します。これは、チャットエージェントが識別される名前です。
1. (オプション) ユーザーがチャットエージェントの目的を理解するのに役立つカスタムチャットエージェントの説明を追加します。
1. (オプション) チャットエージェントのアイコンを選択します。
1. **チャットエージェントの設定**で、以下のセクションをカスタマイズします。
1. **エージェントパーソナ**で、チャットエージェントのパーソナリティ、アイデンティティ、トーン、応答スタイルを設定します。
+ **エージェント ID** の場合 – チャットエージェントの ID を定義します。たとえば、名前とパーソナリティを指示できます。Amazon Quick は、空白のままにするとデフォルトを使用します。
+ **ペルソナの手順** – チャットエージェントがチャット中にユーザーとやり取りする方法に関する手順を追加します。たとえば、チャットエージェントの主なタスクを定義できます。Amazon Quick は、これらを使用してチャットエージェントのペルソナをカスタマイズします。
1. **コミュニケーションスタイル**で、**「応答スタイルのプリセットを選択**」 – 応答スタイルを選択します。次のレスポンススタイルのプリセットから選択することも、カスタム手順を追加することもできます。
+ **エグゼクティブ** – 高レベルのビジネスコミュニケーションと戦略的インサイトのために最適化されています。
+ **技術的** – 詳細な技術的説明と技術的な問題解決のために最適化されています。
+ **クリエイティブ** – 汎用インタラクションの標準設定。
各プリセットには次の設定があります。
+ **トーン**の場合 – 自然言語プロンプトを追加して、エージェントのトーンを定義します。Amazon Quick はこれを使用してチャットエージェントのペルソナをカスタマイズします。
+ **レスポンス形式** – 自然言語プロンプトを追加して、チャットエージェントのレスポンススタイルを定義します。Amazon Quick はこれを使用して、チャットエージェントの応答スタイルをカスタマイズします。チャットエージェントのレスポンスの形式を定義します。例えば、「3 項目を超えるリストに箇条書きを使用する」です。
+ **長さ** – チャットエージェントのレスポンスの長さを指定します。チャットエージェントのレスポンスの長さを定義します。例えば、「100 語未満で回答を保持」です。
使用するプリセットを選択すると、Amazon Quick は選択したスタイルに基づいてチャットエージェントのレスポンスの**トーン**、**レスポンス形式**、**長さ**の手順を自動的に入力します。自然言語を使用して既存のプロンプトをさらにカスタマイズすることも、新しいプロンプトを作成することもできます。
1. **リファレンスドキュメント**で、チャットエージェントのメモリにアクティブなままのファイルをアップロードして、すべてのインタラクションをガイドします。リファレンスドキュメントが他のコンテキストタイプと連携する方法の詳細については、[「エージェントコンテキストのタイプ](quicksuite/latest/userguide/agent-knowledge-sources-best-practices.html)」を参照してください。
+ **ファイルのアップロード**を選択するか、ドキュメントをドラッグアンドドロップして、チャットエージェントの応答をガイドするファイルをアタッチします。
+ .pdf、.txt、.html、.md、.csv、.doc、または .docx 形式のドキュメントをアタッチできます。最大 100,000 文字のテキストが抽出され、アップロードされたドキュメントから受け入れられます。
1. (オプション) **ナレッジソース**で、次のオプションから選択します。
+ ナレッジソースをリンクせずに続行する
+ チャットエージェントは、大規模言語モデル (LLM) の知識と、対話するユーザーがアクセスできるすべての Amazon Quick リソースからレスポンスを生成します。チャット中に焦点を当てる特定のナレッジソースを選択できます。汎用チャットエージェントを作成する場合は、これを選択します。
+ 特定の既存のスペースをリンクするには
+ **リンク**を選択します。
+ **リンクスペース**モーダルから、チャットエージェントにリンクするスペースを選択し、**リンク**を選択します。
リンクが成功したことを示す成功メッセージが表示されます。
チャットエージェントをナレッジソースにリンクすると、チャットエージェントは、リンクされたリソースからのみ、大規模言語モデル (LLM) のナレッジとデータからレスポンスを生成します。このチャットエージェントには、チャット中の一時コンテキストとして最大 1 つのナレッジソースを追加できます。
+ 新しいスペースを作成してリンクするには
+ **[作成]** を選択します。
+ 開いた**スペースの作成**ウィンドウで、スペースに追加するアセットを選択し、**作成**を選択します。
チャットエージェントをナレッジソースにリンクすると、チャットエージェントは、リンクされたリソースからのみ、大規模言語モデル (LLM) のナレッジとデータからレスポンスを生成します。このチャットエージェントには、チャット中の一時コンテキストとして最大 1 つのナレッジソースを追加できます。
**注記**
スペースの作成と使用の詳細については、[「Amazon Quick でのスペースの使用](https://docs.aws.amazon.com/quicksuite/latest/userguide/working-with-spaces.html)」を参照してください。
成功メッセージが表示され、スペースの作成が成功したことを示します。チャットエージェントの作成ウィンドウに戻ります。
+ チャットエージェント作成ウィンドウで、**ナレッジソース**から**リンク**を選択します。
+ **リンクスペース**モーダルから、先ほど作成したスペースを選択し、**リンク**を選択します。
リンクが成功したことを示す成功メッセージが表示されます。
1. (オプション) **アクション**の**アクション** – 次のオプションから選択します。
+ 特定の既存のアクションをリンクするには
+ **リンク**を選択します。
+ **リンクアクションコネクタ**モーダルから、チャットエージェントにリンクするアクションコネクタを選択し、次**へ**を選択します。
+ **アクション**で追加するアクションを選択し、**リンク**を選択します。
リンクが成功したことを示す成功メッセージが表示されます。
+ アクションコネクタを作成し、新しいアクションをリンクするには
+ **[作成]** を選択します。
+ **アクション**のホームページから、**新しいアクション**を選択します。
+ **新しいアクション**ウィンドウから、**ソース**で追加するアクションコネクタを選択し、**次へ**を選択します。
+ **「アクション**」で、使用可能なアクションを確認し、次**へ**を選択します。
+ **接続の詳細**で、必要な接続の詳細を入力し、**追加**を選択します。
**注記**
アクションコネクタの作成と使用の詳細については、[「Amazon Quick のアクション](https://docs.aws.amazon.com/quicksuite/latest/userguide/qbs-actions.html)」を参照してください。
成功したアクションの追加を示す成功メッセージが表示されます。チャットエージェントの作成ウィンドウに戻ります。
+ チャットエージェント作成ウィンドウで、**アクション**から**リンク**を選択します。
+ **リンクアクションコネクタ**モーダルから、先ほど作成したアクションコネクタを選択し、**リンク**を選択します。
リンクが成功したことを示す成功メッセージが表示されます。
1. **カスタマイズ**で、次の操作を行います。
1. **ウェルカムメッセージ** – チャットエージェントがエンドユーザーに表示するウェルカムメッセージを追加します。
1. **推奨されるプロンプト**の場合 – チャットエージェントの機能をエンドユーザーに通知する会話スターターとしてプロンプトの例を追加します。
1. **チャットエージェントの起動** を選択して、カスタムチャットエージェントを作成します。
**注記**
**チャットエージェントの起動**を選択するまで、チャットエージェントはチャットエージェントライブラリでは使用できません。起動せずに作成プロセスを終了すると、プレビューバージョンが削除され、チャットエージェントは保存されません。
チャットエージェントを起動すると、デフォルトではプライベートのままになります。チャットエージェントは、共有後に他のユーザーのライブラリでのみ使用可能になります。共有されると、それ以降の編集と起動は、アクセス権を持つすべてのユーザーに対して同じチャットエージェントに変更を公開します。
------
## カスタムチャットエージェントを共有する
チャットエージェントを作成すると、デフォルトで所有者として割り当てられます。次のアクセス許可を使用して、所有しているチャットエージェントを他の Amazon Quick ユーザーと共有することを選択できます。
+ *所有者*のアクセス許可 – ユーザーはチャットエージェントを編集、共有、使用、削除できます。
+ *ビューワー*のアクセス許可 – ユーザーはチャットエージェントを表示して使用できます。
また、チャットエージェントのアクセス許可をグローバルに定義し、すべてのユーザーにチャットエージェントへのアクセスを許可し、特定のユーザーとグループのより詳細なアクセス許可を定義することもできます。
次の手順では、チャットエージェントに権限を共有して割り当てる方法を示します。
**カスタムチャットエージェントを共有するには**
1. Amazon Quick コンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。
1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**共有**を選択します。
1. チャット**エージェントを共有する**モーダルで、チャットエージェントを共有するユーザー名またはグループ名を入力します。ユーザーまたはグループ名が表示されたら、それを選択します。チャットエージェントを共有するすべてのグループまたはユーザーに対して アクションを繰り返します。モーダルには、追加するユーザーとグループが表示されます。
1. チャットエージェントを共有する各ユーザーまたはグループのアクセス許可とアクセス情報は、ユーザーまたはグループ名の横にあるドロップダウンを使用して割り当てます。次の 2 つのロールのいずれかを割り当てることができます。
+ **所有者** – ユーザーはチャットエージェントを編集、共有、削除できます。
+ **ビューワー** – ユーザーはチャットエージェントを表示して使用できます。
1. **[共有]** を選択します。
## カスタムチャットエージェントの埋め込み
ユーザーが Amazon Quick コンソールの外部で操作できるように、外部ウェブサイトまたはアプリケーションにカスタムチャットエージェントを埋め込むことができます。チャットエージェントを埋め込むには、まず Amazon Quick 管理者設定でホスティングドメインを許可してから、チャットエージェントの共有オプションから埋め込みコードを生成する必要があります。
チャットエージェントを埋め込むには、次の 2 つのステップが必要です。
1. **ホスティングドメインを許可する** – Amazon Quick 管理者は、埋め込みチャットエージェントがホストされるドメイン (およびオプションでそのサブドメイン) をドメイン許可リストに追加する必要があります。
1. **埋め込みコードの生成** – チャットエージェントの所有者または承認されたユーザーが、チャットエージェントの共有オプションから埋め込みコードを生成します。
### 埋め込みチャットエージェントのドメインを許可する
外部ウェブサイトにチャットエージェントを埋め込む前に、Amazon Quick 管理者はホスティングドメインを許可リストに追加する必要があります。この手順を完了するには、Amazon Quick 管理者である必要があります。これにより、承認されたドメインのみが埋め込みチャットエージェントをホストできるようになります。
**ドメインの埋め込みを許可するには**
1. Amazon Quick コンソールにログインします。
1. プロファイルアイコンを選択します。
1. **アカウントの管理** を選択します。
1. **セキュリティ**のナビゲーションペインで、**ドメインの管理**を選択します。
1. **ドメイン**フィールドに、埋め込みチャットエージェントをホストするドメイン名を入力します (例: `https://example.com`)。
1. (オプション) **サブドメインを含めるを選択して**、指定されたドメインのすべてのサブドメインで埋め込みチャットエージェントを許可します。
1. **[Add]** (追加) を選択します。
許可されたドメインのリストにドメインが表示されるようになりました。既存のドメインを編集または削除するには、リスト内の各ドメインの横にある編集または削除アイコンを選択します。
### チャットエージェントの埋め込みコードを生成する
ホスティングドメインを許可したら、チャットエージェントの埋め込みコードを生成できます。
**チャットエージェントの埋め込みコードを生成するには**
1. Amazon Quick コンソールにログインします。
1. ナビゲーションペインから、**チャットエージェント**を選択します。
1. 埋め込みたいチャットエージェントの**アクション**列から、メニューアイコンを選択し、**編集**を選択します。
1. チャットエージェントエディタで、**共有**を選択します。
1. 共有オプションで、**埋め込みによる共有**を選択します。
1. 提供された埋め込みコードをコピーし、チャットエージェントを表示するウェブサイトまたはアプリケーションの HTML に貼り付けます。
埋め込みチャットエージェントがウェブサイトで利用可能になりました。ページにアクセスするユーザーは、チャットエージェントと直接やり取りできます。
## カスタムチャットエージェントを更新する
Amazon Quick のカスタムチャットエージェントは、Amazon Quick ホームページの**エージェント**メニューから更新できます。次の手順では、その方法の概要を説明します。
**注記**
チャットエージェントの設定時に、チャットエージェントのカスタマイズの更新がどのように実行されるかをプレビューチャットインターフェイスでプレビューできます。変更をテストする前に、**必ずプレビューの更新**を選択してください。プレビューですべての変更がテストされたら、**起動**を選択して、現在使用中のチャットエージェントに変更を公開します。
**カスタムチャットエージェントを更新するには**
1. Amazon Quick コンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。
1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**編集**を選択します。これにより、公開前に更新してテストするチャットエージェントのプレビューバージョンが作成されます。
1. **エージェントの編集**で、チャットエージェントの設定を更新し、**起動**を選択します。
## カスタムチャットエージェントへのアクセスを管理する
チャットエージェントの所有者は、チャットエージェントのユーザーアクセス許可を変更することができます。チャットエージェントへのユーザーおよびグループのアクセスを削除することもできます。手順を以下に示します。
**カスタムチャットエージェントへのアクセスを管理するには**
1. Amazon Quick コンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。
1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**共有**を選択します。
1. **チャットエージェントの共有**モーダルで、アクセス許可を変更するユーザーとグループを選択します。ユーザーまたはグループ名が表示されたら、その名前を選択してアクセス許可を変更します。アクセス許可を変更するすべてのグループまたはユーザーに対して、 アクションを繰り返します。モーダルには、変更するユーザーとグループのアクセス許可が表示されます。次の 3 つのアクションを実行できます。
+ **所有者**への変更 – ユーザーはチャットエージェントを編集、共有、削除できます。
+ **ビューワー**への変更 – ユーザーはチャットエージェントを表示して使用できます。
+ **アクセスの削除** – チャットエージェントへのユーザーまたはグループのアクセスを削除します。
**注記**
また、チャットエージェントへのアクセス許可をグローバルに定義し、すべてのユーザーにチャットエージェントへのアクセスを許可し、特定のユーザーとグループのより詳細なアクセス許可を定義することもできます。これを行うには、**設定**を選択し、**グローバル設定**を使用してこの機能をオンまたはオフにします。
1. **[共有]** を選択します。
## チャットエージェントを表示する
作成したチャットエージェントまたはアクセスできるチャットエージェントのリストを表示できます。手順を以下に示します。
**カスタムチャットエージェントを表示するには**
1. Amazon Quick コンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。
1. 作成したチャットエージェント、またはアクセスできるチャットエージェントは、**チャットエージェントの**ホームページに表示されます。
## チャットエージェントの詳細を表示する
各チャットエージェントにアタッチされたすべてのスペースやアクションなど、ユーザーが作成または共有したチャットエージェントの詳細を表示できます。
**チャットエージェントの詳細を表示するには**
1. Amazon Quick コンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。
1. 次に、チャットエージェントのリストから名前****列で、詳細を表示するチャットエージェントの名前をクリックします。詳細モーダルが開きます。
**注記**
チャットエージェントの詳細を表示するには、共有するチャットエージェントの**アクション**列に移動し、メニューアイコンを選択し、**チャットエージェントの詳細の表示**を選択します。
1. が開くチャットエージェントの詳細モーダルには、次の詳細が表示されます。
1. **説明** – チャットエージェントの説明。
1. **指示の概要** – チャットエージェントに定義された指示の概要。
1. **作成者** – チャットエージェントがユーザーまたは他のユーザーによって作成されたかどうかの詳細。
1. **Last modified** – チャットエージェントが最後に変更された時刻。
1. **以下の機能**:
+ **ナレッジ** – チャットエージェントがアタッチされているか、アクセスできるナレッジソース。チャットエージェントがスペースにリンクされている場合、どのスペースにリンクされているかを確認できます。
+ **アクション** – チャットエージェントがアタッチされている、またはアクセスできるアクション。これを表示するには、チャット UI エージェントセレクタのエージェント名の横にある**情報**をクリックします。
## カスタムチャットエージェントの複製
チャットエージェントを最初から構築しなくても、既存のカスタムチャットエージェントを複製できます。ユーザーは、重複アクションボタンを使用して、リストページからチャットエージェントを**複製**できます。チャットエージェントを複製すると、Amazon Quick は名前形式「[Original name] (copy)」の新しいチャットエージェントを作成し、編集できます。元のチャットエージェントのすべてのフィールドと設定は、チャットエージェントの新しいバージョンにコピーされます。複製すると、複製されたチャットエージェントにカスタムユーザーアクセス許可を割り当てて共有できます。
次の手順では、チャットエージェントを複製する方法について説明します。
**カスタムチャットエージェントを複製するには**
1. Amazon Quick コンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。
1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**重複**を選択します。
事前入力されたフィールドを含むチャットエージェントの重複モーダルにリダイレクトされます。
1. 適切なユーザーおよびグループのアクセス許可の追加、必要なアセットへのリンクなど、必要な変更を加え、**起動**を選択して重複したチャットエージェントを起動します。
## チャットエージェントを削除する
所有している Amazon Quick チャットエージェントを削除できます。以下の手順でその方法を説明します。
**カスタムチャットエージェントを削除するには**
1. Amazon Quick コンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。
1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**削除**を選択します。
# チャットエージェントのコンテキストソースとベストプラクティス
Amazon Quick でカスタムチャットエージェントを作成する場合、チャットエージェントの動作とフレームチャットエージェントのワークフローに影響を与える複数のオプションがあります。チャットエージェントのコンテキストと手順を設定する方法は、チャットエージェントがユーザーインタラクションを実行および応答する方法に大きな影響を与えます。指示書、リファレンスドキュメント、スペースをいつ使用するかを理解することは、特定のビジネスニーズを満たす効果的なチャットエージェントを作成し、一貫性のある信頼性の高い結果を提供する上で不可欠です。以下のセクションでは、ユースケースでチャットエージェントのコンテキストと知識を最大限に活用する方法について説明します。
**Topics**
+ [エージェントコンテキストのタイプ](#knowledge-source-types)
## エージェントコンテキストのタイプ
Amazon Quick には、チャットエージェントの動作を設定するための 3 つの異なる方法が用意されており、それぞれがチャットエージェント開発で異なる目的を果たします。各メソッドがコンテンツをどのように処理し、いつ使用するかを理解することが、効果的なチャットエージェント設定の基盤となります。
Amazon Quick で使用できる 3 つのコンテキストタイプは次のとおりです。
+ **ペルソナの手順** – Amazon Quick が生成機能を使用して強化する大まかなガイダンス AI
+ **リファレンスドキュメント** – 正確な手順を提供し、チャットエージェントのメモリでアクティブなままのドキュメント
+ **スペース** – チャットエージェントが質問に答えるために情報を取得する、検索可能な Amazon Quick リソースとドキュメントのコレクション
次のセクションでは、これらとは何か、およびそれらを使用するためのベストプラクティスについて詳しく説明します。
**Topics**
+ [チャットエージェントのペルソナの手順](#agent-instructions)
+ [チャットエージェントのリファレンスドキュメント](#in-context-files)
+ [チャットエージェントとスペース](#spaces)
### チャットエージェントのペルソナの手順
カスタムチャットエージェントを作成するときは、**Persona instructions フィールドにチャットエージェントのペルソナの手順**を指定します。これらのペルソナ命令は、生成 AI を使用して改良され、すべてのチャット機能とチャットエージェント用に設定されたリソースで動作するようにします。このアプローチは、システムが基本的な方向性に基づいて構築する場合に最適です。ペルソナ命令を使用すると、Amazon Quick は生成AIを使用してバックエンドのペルソナ命令を解釈して拡張し、追加のコンテキストと機能でシンプルなガイダンスを強化し、プロンプトを最適化してチャットエージェントのパフォーマンスを向上させ、 AI主導の改善を通じて有効性を向上させます。
**ペルソナの手順を使用して、次の操作を行います。**
+ Amazon Quick AI によって強化され、エージェントの応答をカスタマイズする動作と目標に関する高レベルのガイダンスを提供します。
+ 詳細なやり取りにリファレンスドキュメントを活用する方法を指示する
+ レスポンスでのスペースとアクションコネクタの使用に関する一般的なガイダンスを提供する
このアプローチは、汎用チャットエージェントや、チャットエージェント設計AIの支援の恩恵を受けたい探索的なユースケースに最適です。
**注記**
AI 拡張プロセスでは、チャットエージェントのパフォーマンスを向上させるために、元の文言と構造が変更される場合があります。変更しない必要がある重要なガイドラインは、代わりにリファレンスドキュメントに配置する必要があります。
### チャットエージェントのリファレンスドキュメント
リファレンスドキュメントには、チャットエージェントが従う必要がある特定のプロセステンプレートとレスポンステンプレートが記載されています。これらのリファレンスドキュメントは、チャットエージェントの永続的なコンテキストの一部であり、ペルソナの指示と応答スタイルhand-in-hand、全体的な動作を通知します。
リファレンスドキュメントでは、コンテンツを記述されたとおりに保持することで、チャットエージェントの動作を完全に制御できます。このアプローチは、精度と一貫性が最優先事項である場合に不可欠です。リファレンスドキュメントをアップロードすると、Amazon Quick は正確な文言と特定の指示を保持し、正確な形式と構造を維持し、チャットエージェントの動作を直接制御し、すべてのやり取りの一貫性を確保します。
**必要に応じてリファレンスドキュメントを使用します。**
+ 正確な文言と特定の指示を保持する必要がある正確な制御
+ 特定のトーン、用語、またはレスポンス形式とのブランド整合性
+ 正確なシーケンスに従う必要がある複数ステップのプロセスを含む複雑なワークフロー
+ すべてのインタラクションで一貫したレスポンスを持つ予測可能な動作
**サポートされているファイル形式:**
+ `.pdf`、`.txt`、`.html`、 `.md` – 手順、テンプレート、ガイドライン
+ `.csv` – リファレンスデータ、ルックアップテーブル、および例
+ `.doc`、 `.docx` — 詳細なプロセスドキュメント
リファレンスドキュメントとして、合計サイズ 50 MB のファイルを最大 10 個アタッチできます。Amazon Quick は、これらのドキュメントからテキストを抽出し、処理後に 100K文字の制限を適用します。
**ファイルの優先順位付けと動作**
ユーザーが代替コンテンツをアタッチしても、ファイルからの動作フレームワークと参照データはアクティブのままです。
ユーザーが競合するフォーマット手順を提供する場合、レスポンステンプレートは一時的に調整される場合があります。
リファレンスドキュメントは、チャットエージェントの運用マニュアルとして機能し、チャットエージェントとのすべてのユーザーインタラクションにわたって一定の動作フレームワークを提供します。
### チャットエージェントとスペース
スペースは、チャットエージェントが会話中にクエリして特定の情報を取得する動的で検索可能なナレッジリポジトリを提供します。スペースをチャットエージェントにリンクすると、Amazon Quick チャットエージェントはスペース内の回答を検索してレスポンスを生成します。スペースは、時間の経過とともに進化する組織の知識を管理することに長けており、複数のチームメンバーが Amazon Quick のアクセス許可システムを通じて適切なセキュリティ境界を維持しながら、情報を提供および更新できます。
チャットエージェントでスペースを使用する目的:
+ チャットエージェントが現在のビジネスデータを検索および取得できるようにする
+ チャットエージェントに組織のナレッジリポジトリへのアクセスを提供する
+ チャットエージェントが既存のアクセス許可の境界を尊重できるようにする
+ チャットエージェントを共同ドキュメントコレクションに接続する
+ チャットエージェントに定期的に更新された情報へのアクセスを許可する
+ チャットエージェントがライブダッシュボードとデータセットをクエリできるようにする
スペースはチャットエージェントの動的ナレッジレイヤーとして機能し、セキュリティの境界とコラボレーションワークフローを維持しながら、組織情報にリアルタイムでアクセスできます。
# チャットエージェントを使用する
Amazon Quick チャットエージェントを使用して、質問をしたり、タスクを達成したりできます。質問すると、チャットエージェントは共有された最新の承認済みデータを分析し、包括的なレスポンスを生成します。
わかりやすい言葉で複雑な質問をして、詳細なレスポンスを得ることができます。クイックチャットエージェントを使用して、E メールメッセージのドラフト作成、チケットの作成、フローの使用などのタスクを実行することもできます。
**カスタムチャットエージェントを使用するには**
1. クイックコンソールにログインします。
1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。
1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**チャット**を選択します。
これにより、チャットエージェントとのやり取りに使用するチャットインターフェイスが開きます。
チャットエージェントは、次の方法で操作できます。
+ プロンプトの例を表示してアクセスし、考えられる質問とタスクを示す
+ 組織のデータソースからコンテキストに応じたレスポンスを取得する
+ 新しい会話を続行または開始する
+ 要約や比較分析を含むデータの分析
+ 会議のスケジュールやチケットの作成などのアクションを実行する
+ クリック可能な番号付き参照を使用してレスポンスのソース引用を表示する
+ ファイルをアップロードする
+ 会話履歴を表示する
**ヒント**
チャットエージェントを使用して、クイックフローでルーチンタスクを自動化することもできます。詳細については、「[チャットエージェント](ai-response-steps.md#chat-agent-step)」を参照してください。
チャットエージェントを使用したチャットの詳細については、[「Amazon Quick Chat ](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html)の使用」を参照してください。