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

# カスタムチャットエージェント
<a name="custom-agents"></a>

カスタムチャットエージェントを使用すると、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)

## カスタムチャットエージェントの作成とプレビュー
<a name="create-custom-agents"></a>

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. **チャットエージェントの起動** を選択して、カスタムチャットエージェントを作成します。
**注記**  
**チャットエージェントの起動**を選択するまで、チャットエージェントはチャットエージェントライブラリでは使用できません。起動せずに作成プロセスを終了すると、プレビューバージョンが削除され、チャットエージェントは保存されません。
チャットエージェントを起動すると、デフォルトではプライベートのままになります。チャットエージェントは、共有後に他のユーザーのライブラリでのみ使用可能になります。共有されると、それ以降の編集と起動は、アクセス権を持つすべてのユーザーに対して同じチャットエージェントに変更を公開します。

------

## カスタムチャットエージェントを共有する
<a name="share-custom-agents"></a>

チャットエージェントを作成すると、デフォルトで所有者として割り当てられます。次のアクセス許可を使用して、所有しているチャットエージェントを他の Amazon Quick ユーザーと共有することを選択できます。
+ *所有者*のアクセス許可 – ユーザーはチャットエージェントを編集、共有、使用、削除できます。
+ *ビューワー*のアクセス許可 – ユーザーはチャットエージェントを表示して使用できます。

また、チャットエージェントのアクセス許可をグローバルに定義し、すべてのユーザーにチャットエージェントへのアクセスを許可し、特定のユーザーとグループのより詳細なアクセス許可を定義することもできます。

次の手順では、チャットエージェントに権限を共有して割り当てる方法を示します。

**カスタムチャットエージェントを共有するには**

1. Amazon Quick コンソールにログインします。

1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。

1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**共有**を選択します。

1. チャット**エージェントを共有する**モーダルで、チャットエージェントを共有するユーザー名またはグループ名を入力します。ユーザーまたはグループ名が表示されたら、それを選択します。チャットエージェントを共有するすべてのグループまたはユーザーに対して アクションを繰り返します。モーダルには、追加するユーザーとグループが表示されます。

1. チャットエージェントを共有する各ユーザーまたはグループのアクセス許可とアクセス情報は、ユーザーまたはグループ名の横にあるドロップダウンを使用して割り当てます。次の 2 つのロールのいずれかを割り当てることができます。
   + **所有者** – ユーザーはチャットエージェントを編集、共有、削除できます。
   + **ビューワー** – ユーザーはチャットエージェントを表示して使用できます。

1. **[共有]** を選択します。

## カスタムチャットエージェントの埋め込み
<a name="embed-custom-agents"></a>

ユーザーが Amazon Quick コンソールの外部で操作できるように、外部ウェブサイトまたはアプリケーションにカスタムチャットエージェントを埋め込むことができます。チャットエージェントを埋め込むには、まず Amazon Quick 管理者設定でホスティングドメインを許可してから、チャットエージェントの共有オプションから埋め込みコードを生成する必要があります。

チャットエージェントを埋め込むには、次の 2 つのステップが必要です。

1. **ホスティングドメインを許可する** – Amazon Quick 管理者は、埋め込みチャットエージェントがホストされるドメイン (およびオプションでそのサブドメイン) をドメイン許可リストに追加する必要があります。

1. **埋め込みコードの生成** – チャットエージェントの所有者または承認されたユーザーが、チャットエージェントの共有オプションから埋め込みコードを生成します。

### 埋め込みチャットエージェントのドメインを許可する
<a name="embed-agents-allow-domain"></a>

外部ウェブサイトにチャットエージェントを埋め込む前に、Amazon Quick 管理者はホスティングドメインを許可リストに追加する必要があります。この手順を完了するには、Amazon Quick 管理者である必要があります。これにより、承認されたドメインのみが埋め込みチャットエージェントをホストできるようになります。

**ドメインの埋め込みを許可するには**

1. Amazon Quick コンソールにログインします。

1. プロファイルアイコンを選択します。

1. **アカウントの管理** を選択します。

1. **セキュリティ**のナビゲーションペインで、**ドメインの管理**を選択します。

1. **ドメイン**フィールドに、埋め込みチャットエージェントをホストするドメイン名を入力します (例: `https://example.com`)。

1. (オプション) **サブドメインを含めるを選択して**、指定されたドメインのすべてのサブドメインで埋め込みチャットエージェントを許可します。

1. **[Add]** (追加) を選択します。

許可されたドメインのリストにドメインが表示されるようになりました。既存のドメインを編集または削除するには、リスト内の各ドメインの横にある編集または削除アイコンを選択します。

### チャットエージェントの埋め込みコードを生成する
<a name="embed-agents-generate-code"></a>

ホスティングドメインを許可したら、チャットエージェントの埋め込みコードを生成できます。

**チャットエージェントの埋め込みコードを生成するには**

1. Amazon Quick コンソールにログインします。

1. ナビゲーションペインから、**チャットエージェント**を選択します。

1. 埋め込みたいチャットエージェントの**アクション**列から、メニューアイコンを選択し、**編集**を選択します。

1. チャットエージェントエディタで、**共有**を選択します。

1. 共有オプションで、**埋め込みによる共有**を選択します。

1. 提供された埋め込みコードをコピーし、チャットエージェントを表示するウェブサイトまたはアプリケーションの HTML に貼り付けます。

埋め込みチャットエージェントがウェブサイトで利用可能になりました。ページにアクセスするユーザーは、チャットエージェントと直接やり取りできます。

## カスタムチャットエージェントを更新する
<a name="update-custom-agents"></a>

Amazon Quick のカスタムチャットエージェントは、Amazon Quick ホームページの**エージェント**メニューから更新できます。次の手順では、その方法の概要を説明します。

**注記**  
チャットエージェントの設定時に、チャットエージェントのカスタマイズの更新がどのように実行されるかをプレビューチャットインターフェイスでプレビューできます。変更をテストする前に、**必ずプレビューの更新**を選択してください。プレビューですべての変更がテストされたら、**起動**を選択して、現在使用中のチャットエージェントに変更を公開します。

**カスタムチャットエージェントを更新するには**

1. Amazon Quick コンソールにログインします。

1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。

1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**編集**を選択します。これにより、公開前に更新してテストするチャットエージェントのプレビューバージョンが作成されます。

1. **エージェントの編集**で、チャットエージェントの設定を更新し、**起動**を選択します。

## カスタムチャットエージェントへのアクセスを管理する
<a name="remove-access-custom-agents"></a>

チャットエージェントの所有者は、チャットエージェントのユーザーアクセス許可を変更することができます。チャットエージェントへのユーザーおよびグループのアクセスを削除することもできます。手順を以下に示します。

**カスタムチャットエージェントへのアクセスを管理するには**

1. Amazon Quick コンソールにログインします。

1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。

1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**共有**を選択します。

1. **チャットエージェントの共有**モーダルで、アクセス許可を変更するユーザーとグループを選択します。ユーザーまたはグループ名が表示されたら、その名前を選択してアクセス許可を変更します。アクセス許可を変更するすべてのグループまたはユーザーに対して、 アクションを繰り返します。モーダルには、変更するユーザーとグループのアクセス許可が表示されます。次の 3 つのアクションを実行できます。
   + **所有者**への変更 – ユーザーはチャットエージェントを編集、共有、削除できます。
   + **ビューワー**への変更 – ユーザーはチャットエージェントを表示して使用できます。
   + **アクセスの削除** – チャットエージェントへのユーザーまたはグループのアクセスを削除します。
**注記**  
また、チャットエージェントへのアクセス許可をグローバルに定義し、すべてのユーザーにチャットエージェントへのアクセスを許可し、特定のユーザーとグループのより詳細なアクセス許可を定義することもできます。これを行うには、**設定**を選択し、**グローバル設定**を使用してこの機能をオンまたはオフにします。

1. **[共有]** を選択します。

## チャットエージェントを表示する
<a name="view-agents"></a>

作成したチャットエージェントまたはアクセスできるチャットエージェントのリストを表示できます。手順を以下に示します。

**カスタムチャットエージェントを表示するには**

1. Amazon Quick コンソールにログインします。

1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。

1. 作成したチャットエージェント、またはアクセスできるチャットエージェントは、**チャットエージェントの**ホームページに表示されます。

## チャットエージェントの詳細を表示する
<a name="view-agent-details"></a>

各チャットエージェントにアタッチされたすべてのスペースやアクションなど、ユーザーが作成または共有したチャットエージェントの詳細を表示できます。

**チャットエージェントの詳細を表示するには**

1. Amazon Quick コンソールにログインします。

1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。

1. 次に、チャットエージェントのリストから名前****列で、詳細を表示するチャットエージェントの名前をクリックします。詳細モーダルが開きます。
**注記**  
チャットエージェントの詳細を表示するには、共有するチャットエージェントの**アクション**列に移動し、メニューアイコンを選択し、**チャットエージェントの詳細の表示**を選択します。

1. が開くチャットエージェントの詳細モーダルには、次の詳細が表示されます。

   1. **説明** – チャットエージェントの説明。

   1. **指示の概要** – チャットエージェントに定義された指示の概要。

   1. **作成者** – チャットエージェントがユーザーまたは他のユーザーによって作成されたかどうかの詳細。

   1. **Last modified** – チャットエージェントが最後に変更された時刻。

   1. **以下の機能**:
      + **ナレッジ** – チャットエージェントがアタッチされているか、アクセスできるナレッジソース。チャットエージェントがスペースにリンクされている場合、どのスペースにリンクされているかを確認できます。
      + **アクション** – チャットエージェントがアタッチされている、またはアクセスできるアクション。これを表示するには、チャット UI エージェントセレクタのエージェント名の横にある**情報**をクリックします。

## カスタムチャットエージェントの複製
<a name="duplicate-agents"></a>

チャットエージェントを最初から構築しなくても、既存のカスタムチャットエージェントを複製できます。ユーザーは、重複アクションボタンを使用して、リストページからチャットエージェントを**複製**できます。チャットエージェントを複製すると、Amazon Quick は名前形式「[Original name] (copy)」の新しいチャットエージェントを作成し、編集できます。元のチャットエージェントのすべてのフィールドと設定は、チャットエージェントの新しいバージョンにコピーされます。複製すると、複製されたチャットエージェントにカスタムユーザーアクセス許可を割り当てて共有できます。

次の手順では、チャットエージェントを複製する方法について説明します。

**カスタムチャットエージェントを複製するには**

1. Amazon Quick コンソールにログインします。

1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。

1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**重複**を選択します。

   事前入力されたフィールドを含むチャットエージェントの重複モーダルにリダイレクトされます。

1. 適切なユーザーおよびグループのアクセス許可の追加、必要なアセットへのリンクなど、必要な変更を加え、**起動**を選択して重複したチャットエージェントを起動します。

## チャットエージェントを削除する
<a name="delete-agents"></a>

所有している Amazon Quick チャットエージェントを削除できます。以下の手順でその方法を説明します。

**カスタムチャットエージェントを削除するには**

1. Amazon Quick コンソールにログインします。

1. 左側のナビゲーションメニューから、**チャットエージェント**を選択します。

1. 次に、共有するチャットエージェントの**アクション**列から、メニューアイコンを選択し、**削除**を選択します。