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

# Amazon Quick で AI を活用したチャットエージェントを作成、カスタマイズ、デプロイする
<a name="working-with-agents"></a>

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)

## チャットエージェントタイプ
<a name="agent-types"></a>

Amazon Quick は、次の 2 種類のチャットエージェントをサポートしています。
+ **システムチャットエージェント** – このチャットエージェント (「アシスタント」) は、デフォルトですべてのユーザーが自動的に使用できます。システムチャットエージェントは、固有のデータや独自のアクションを持たないベースプランナーとして機能します。チャット中に各ユーザーが利用できるリソースに動的にアクセスするため、個々のユーザーのアクセス許可と利用可能なコンテンツに合わせて調整できます。管理者ユーザーは、特定のユーザーを所有者として割り当ててシステムチャットエージェントの設定を制御し、ペルソナやその他の設定をカスタマイズできるようにします。

  システムチャットエージェントは、ファイルアップロード機能、LLM ナレッジアクセス、毒性およびその他のガードレール、ウェブ検索など、すべてのチャット機能で有効になります。また、スペース、トピック、ダッシュボード、ナレッジベース、ユーザーのアクセス許可に基づくアクションへのアクセスを提供するチャットデータスコープメカニズムも含まれています。
+ **カスタムチャットエージェント** – これらのチャットエージェントは、Amazon Quick のチャットエージェント作成機能を持つユーザーが作成および特定のユースケースに合わせてカスタマイズでき、誰でも共有できます。管理者は、特定のユーザーとグループがカスタムチャットエージェントを作成するのを制限しながら、ユーザーがチャット経由でチャットエージェントを使用できるようにすることを選択できます。チャットエージェントは、呼び出し元のユーザーがアクセス許可を持っているコンテンツに限定されたレスポンスを返します。

カスタムチャットエージェントは、次の方法で Amazon Quick リソースとやり取りできます。
+ **リソースで事前設定**済み – これらのチャットエージェントは、失敗した動作として回答を探したり、アクションをオーケストレーションしたりするときに、設定されたリソース (ナレッジソースとしてのスペース、ツールとしてのアクションコネクタなど) のみを使用します。チャット中に、ユーザーは必要に応じて追加のリソースをアタッチしたり、アクションを直接呼び出すことができます。たとえば、ファイルを含むスペースのみで構成されるチャットエージェントは、ユーザーが明示的に呼び出さない限り、デフォルトでアクションを実行できません。同様に、アクションのみで構成されるチャットエージェントは、ユーザーがエンタープライズ固有の回答にスペースまたはダッシュボードをアタッチしない限り、LLM の知識に依存します。ただし、ユーザーは追加のスペースをアタッチしたり、チャットインターフェイス内でアクセスできる他のアクションを直接呼び出すことができます。
+ **ビルド時に意見を述べない** – これらのチャットエージェントは、構築時にリソース (スペース、アクションコネクタ、またはその両方) で最初に設定されることはありません。チャットは、チャットエージェントのリソース境界を決定します。たとえば、チャットエージェントにスペースが設定されていない場合、ユーザーが変更を加えるまで、チャットはデフォルトですべてのスペースまたは LLM ナレッジになります。チャットエージェントにアクションコネクタが設定されていない場合、チャット中に、ユーザーがアクセスできるすべてのアクションは、ユーザーがアクションを含まないリソースを選択するまで、エージェントが使用できます。

  チャット中のユーザーリソースの選択は、チャットエージェントの動作に影響します。ユーザーがスペースを選択すると、チャットエージェントはそのスペース内のデータでのみ応答し、そのスペース内で利用可能なアクションを実行します (ビルド時に意見を述べていない場合）。ユーザーがダッシュボード、トピック、またはナレッジベースを選択した場合、チャットエージェントはそのソースからのみ応答し、フォーカスが特定のデータソースに変更されるため、アクションを実行しません。包括的なサポートを受けるには、チャット内のすべての関連リソースを選択する必要があります。
**注記**  
システムチャットエージェントは、設計上、操作されていないチャットエージェントです。データフォーカスに関係なく、チャットエージェントがすべてのアクションにアクセスする場合は、アクションコネクタを使用してチャットエージェントを設定します。

## Amazon Quick ユーザーとチャットエージェントとのやり取り
<a name="user-agent-actions"></a>

次の表は、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 ユーザーアクセス許可
<a name="user-agent-permissions"></a>

チャットエージェントでできることは、チャットエージェントに割り当てられたアクセス許可にも依存します。ユーザーに割り当てることができるアクセス許可タイプは 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)  | 

## チャットエージェントのカスタムアクセス許可
<a name="custom-permissions-chat-agents"></a>

デフォルトでは、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) |