カスタムチャットエージェントを作成するカスタムチャットエージェントを共有するカスタムチャットエージェントを更新するチャットエージェントへのマネージャーアクセスチャットエージェントを表示するチャットエージェントの詳細を表示するカスタムチャットエージェントの複製チャットエージェントを削除する

カスタムチャットエージェント

カスタムチャットエージェントを使用すると、Amazon Quick Suite ユーザーは特定のビジネスニーズに合わせてカスタマイズされた会話型インターフェイスを作成できます。デフォルトではチャット権限を持つすべてのユーザーが利用できるシステムチャットエージェントとは異なり、カスタムチャットエージェントは、承認されたユーザーによって選択的に共有および設定できます。

チャットエージェント作成機能を持つユーザーは、自然言語インターフェイスまたはエージェントビルダー設定フローを使用して、チャットエージェントのパーソナリティ、レスポンススタイル、機能をカスタマイズできます。これらのユーザーは、これらのチャットエージェントを特定のナレッジソース (スペースなど) とワークフロー (アクションなど) で設定しながら、各リソースの共有とアクセス許可を個別に制御することもできます。または、チャットエージェントは、エンドユーザーがリソースのすべてまたは一部でエージェントを使用できるように、リンクを解除したままにしておくこともできます。

Quick Suite 管理者は、チャットエージェントを作成するアクセス許可をユーザーに付与する必要があります。チャットエージェントを作成できるロールについては、Amazon Quick Suite の料金ドキュメントを参照してください。これらの機能へのアクセスを提供または制限する方法については、「Quick Suite 管理ガイド」の「カスタムアクセス許可」を参照してください。

カスタムチャットエージェントの作成とプレビュー

Amazon Quick Suite のホームページのチャットエージェントメニューから、Amazon Quick Suite でカスタムチャットエージェントを作成できます。チャットエージェントは、ビルド時にプレビューおよびテストできます。カスタムチャットエージェントを作成すると、デフォルトで所有者として割り当てられます。次の手順では、カスタムチャットエージェントを作成する方法の概要を説明します。

Using natural language

自然言語プロンプトを使用してカスタムチャットエージェントを作成するには

Amazon Quick Suite コンソールにログインします。
左側のナビゲーションメニューから、チャットエージェントを選択し、チャットエージェントの作成を選択します。
新しいチャットエージェントで、次の操作を行います。
1. テキスト入力ボックスに、作成するチャットエージェントの種類に関する自然言語の説明を入力します。これは、Amazon Quick Suite がチャットエージェントの作成に使用するプロンプトです。ページの推奨サンプル手順を使用して、チャットエージェントを作成することもできます。
2. 次に、生成を選択します。Generate を選択すると、指定された指示または目標を受け取り、チャットエージェントの指示と設定に展開されます。また、ユーザーの利用可能なリソース (スペースとアクションコネクタ) をスキャンし、提供されたチャットエージェントのインテントに基づいて最も関連性の高い一致を見つけます。拡張されたビルダー UI は、ユーザーが確認、カスタマイズ、テスト、起動できるように、これらの設定で開きます。
チャットエージェントの設定ページで、チャットエージェントに適切な設定があることを確認し、チャットエージェントをさらにカスタマイズします。プレビューでチャットエージェントを試す前に、プレビューの更新をクリックして、すべての変更が保存されていることを確認します。
準備ができたら、チャットエージェントの起動 を選択してカスタムチャットエージェントをチャットエージェントライブラリに発行し、チャットで使用します。
注記
- チャットエージェントの起動を選択するまで、チャットエージェントはチャットエージェントライブラリでは使用できません。起動せずに作成プロセスを終了すると、プレビューバージョンが削除され、チャットエージェントは保存されません。
- チャットエージェントを起動しても、デフォルトではプライベートのままになります。チャットエージェントは、共有後に他のユーザーのライブラリでのみ使用可能になります。共有されると、それ以降の編集と起動は、アクセス権を持つすべてのユーザーに対して同じチャットエージェントに変更を公開します。

Using builder view directly

ビルダーモードを使用してカスタムチャットエージェントを作成するには

Amazon Quick Suite コンソールにログインします。
左側のナビゲーションメニューから、チャットエージェントを選択し、チャットエージェントの作成を選択します。
エージェント作成者で、スキップを選択します。これにより、チャットエージェントの設定ページが開き、チャットエージェントを構築およびカスタマイズできます。
カスタムチャットエージェントの名前を追加します。これは、チャットエージェントが識別される名前です。
(オプション) ユーザーがチャットエージェントの目的を理解するのに役立つカスタムチャットエージェントの説明を追加します。
(オプション) チャットエージェントのアイコンを選択します。
チャットエージェントの設定で、以下のセクションをカスタマイズします。
1. エージェントパーソナで、チャットエージェントのパーソナリティ、アイデンティティ、トーン、応答スタイルを設定します。
  - エージェント ID の場合 – チャットエージェントの ID を定義します。たとえば、名前とパーソナリティを指示できます。Amazon Quick Suite は、空白のままにするとデフォルトを使用します。
  - ペルソナの手順 – チャットエージェントがチャット中にユーザーとやり取りする方法に関する手順を追加します。たとえば、チャットエージェントの主なタスクを定義できます。Amazon Quick Suite は、これらを使用してチャットエージェントのペルソナをカスタマイズします。
2. コミュニケーションスタイルで、「応答スタイルのプリセットを選択」 – 応答スタイルを選択します。次のレスポンススタイルのプリセットから選択することも、カスタム手順を追加することもできます。
  - エグゼクティブ – 高レベルのビジネスコミュニケーションと戦略的インサイトのために最適化されています。
  - 技術的 – 詳細な技術的説明と技術的な問題解決のために最適化されています。
  - クリエイティブ – 汎用インタラクションの標準設定。
  各プリセットには次の設定があります。
  - トーン – 自然言語プロンプトを追加して、エージェントのトーンを定義します。Amazon Quick Suite はこれを使用してチャットエージェントのペルソナをカスタマイズします。
  - レスポンス形式 – 自然言語プロンプトを追加して、チャットエージェントのレスポンススタイルを定義します。Amazon Quick Suite はこれを使用して、チャットエージェントのレスポンススタイルをカスタマイズします。チャットエージェントのレスポンスの形式を定義します。例えば、「3 項目を超えるリストに箇条書きを使用する」です。
  - 長さ – チャットエージェントのレスポンスの長さを指定します。チャットエージェントのレスポンスの長さを定義します。例えば、「100 語未満で回答を保持」です。
  使用するプリセットを選択すると、Amazon Quick Suite は選択したスタイルに基づいてチャットエージェントのレスポンスのトーン、レスポンス形式、長さの手順を自動的に入力します。自然言語を使用して既存のプロンプトをさらにカスタマイズすることも、新しいプロンプトを作成することもできます。
3. リファレンスドキュメントで、チャットエージェントのメモリにアクティブなままのファイルをアップロードして、すべてのインタラクションをガイドします。リファレンスドキュメントが他のコンテキストタイプと連携する方法の詳細については、「エージェントコンテキストのタイプ」を参照してください。
  - ファイルのアップロードを選択するか、ドキュメントをドラッグアンドドロップして、チャットエージェントの応答をガイドするファイルをアタッチします。
  - .pdf、.txt、.html、.md、.csv、.doc、または .docx 形式のドキュメントをアタッチできます。最大 100,000 文字のテキストが抽出され、アップロードされたドキュメントから受け入れられます。
(オプション) ナレッジソースで、次のオプションから選択します。
- ナレッジソースをリンクせずに続行する
  - チャットエージェントは、大規模言語モデル (LLM) の知識と、対話するユーザーがアクセスできるすべての Amazon Quick Suite リソースからレスポンスを生成します。チャット中に焦点を当てる特定のナレッジソースを選択できます。汎用チャットエージェントを作成する場合は、これを選択します。
- 特定の既存のスペースをリンクするには
  - リンクを選択します。
  - リンクスペースモーダルから、チャットエージェントにリンクするスペースを選択し、リンクを選択します。
    
    リンクが成功したことを示す成功メッセージが表示されます。
    
    チャットエージェントをナレッジソースにリンクすると、チャットエージェントは、リンクされたリソースからのみ、大規模言語モデル (LLM) のナレッジとデータからレスポンスを生成します。このチャットエージェントには、チャット中の一時コンテキストとして最大 1 つのナレッジソースを追加できます。
- 新しいスペースを作成してリンクするには
  - [作成] を選択します。
  - 開いたスペースの作成ウィンドウで、スペースに追加するアセットを選択し、作成を選択します。
    
    チャットエージェントをナレッジソースにリンクすると、チャットエージェントは、リンクされたリソースからのみ、大規模言語モデル (LLM) のナレッジとデータからレスポンスを生成します。このチャットエージェントには、チャット中の一時コンテキストとして最大 1 つのナレッジソースを追加できます。
    
    注記
    スペースの作成と使用の詳細については、「Amazon Quick Suite でのスペースの使用」を参照してください。
    
    成功メッセージが表示され、スペースの作成が成功したことを示します。チャットエージェントの作成ウィンドウに戻ります。
  - チャットエージェント作成ウィンドウで、ナレッジソースからリンクを選択します。
  - リンクスペースモーダルから、先ほど作成したスペースを選択し、リンクを選択します。
    
    リンクが成功したことを示す成功メッセージが表示されます。
(オプション) アクションのアクション – 次のオプションから選択します。
- 特定の既存のアクションをリンクするには
  - リンクを選択します。
  - リンクアクションコネクタモーダルから、チャットエージェントにリンクするアクションコネクタを選択し、次へを選択します。
  - アクションで追加するアクションを選択し、リンクを選択します。
    
    リンクが成功したことを示す成功メッセージが表示されます。
- アクションコネクタを作成し、新しいアクションをリンクするには
  - [作成] を選択します。
  - アクションのホームページから、新しいアクションを選択します。
  - 新しいアクションウィンドウから、ソースで追加するアクションコネクタを選択し、次へを選択します。
  - 「アクション」で、使用可能なアクションを確認し、次へを選択します。
  - 接続の詳細で、必要な接続の詳細を入力し、追加を選択します。
    
    注記
    アクションコネクタの作成と使用の詳細については、「Amazon Quick Suite のアクション」を参照してください。
    
    成功したアクションの追加を示す成功メッセージが表示されます。チャットエージェントの作成ウィンドウに戻ります。
  - チャットエージェント作成ウィンドウで、アクションからリンクを選択します。
  - リンクアクションコネクタモーダルから、先ほど作成したアクションコネクタを選択し、リンクを選択します。
    
    リンクが成功したことを示す成功メッセージが表示されます。
カスタマイズで、次の操作を行います。
1. ウェルカムメッセージ – チャットエージェントがエンドユーザーに表示するウェルカムメッセージを追加します。
2. 推奨されるプロンプトの場合 – サンプルプロンプトを会話スターターとして追加し、チャットエージェントの機能をエンドユーザーに通知します。
チャットエージェントの起動 を選択して、カスタムチャットエージェントを作成します。
注記
- チャットエージェントの起動を選択するまで、チャットエージェントはチャットエージェントライブラリでは使用できません。起動せずに作成プロセスを終了すると、プレビューバージョンが削除され、チャットエージェントは保存されません。
- チャットエージェントを起動しても、デフォルトではプライベートのままです。チャットエージェントは、共有後に他のユーザーのライブラリでのみ使用可能になります。共有されると、それ以降の編集と起動は、アクセス権を持つすべてのユーザーに対して同じチャットエージェントに変更を公開します。

チャットエージェントを作成すると、デフォルトで所有者として割り当てられます。次のアクセス許可を使用して、所有しているチャットエージェントを他の Amazon Quick Suite ユーザーと共有できます。

所有者のアクセス許可 – ユーザーはチャットエージェントを編集、共有、使用、削除できます。
ビューワーのアクセス許可 – ユーザーはチャットエージェントを表示して使用できます。

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

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

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

Amazon Quick Suite コンソールにログインします。
左側のナビゲーションメニューから、チャットエージェントを選択します。
次に、共有するチャットエージェントのアクション列から、メニューアイコンを選択し、共有を選択します。
チャットエージェントを共有するモーダルで、チャットエージェントを共有するユーザー名またはグループ名を入力します。ユーザーまたはグループ名が表示されたら、それを選択します。チャットエージェントを共有するすべてのグループまたはユーザーに対してアクションを繰り返します。モーダルには、追加するユーザーとグループが表示されます。
ユーザーまたはグループ名の横にあるドロップダウンを使用して、チャットエージェントを共有する各ユーザーまたはグループのアクセス許可とアクセス情報を割り当てます。次の 2 つのロールのいずれかを割り当てることができます。
- 所有者 – ユーザーはチャットエージェントを編集、共有、削除できます。
- ビューワー – ユーザーはチャットエージェントを表示して使用できます。
[共有] を選択します。

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

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

注記

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

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

Amazon Quick Suite コンソールにログインします。
左側のナビゲーションメニューから、チャットエージェントを選択します。
次に、共有するチャットエージェントのアクション列から、メニューアイコンを選択し、編集を選択します。これにより、公開前に更新してテストするチャットエージェントのプレビューバージョンが作成されます。
エージェントの編集で、チャットエージェントの設定を更新し、起動を選択します。

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

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

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

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

チャットエージェントを表示する

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

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

Amazon Quick Suite コンソールにログインします。
左側のナビゲーションメニューから、チャットエージェントを選択します。
作成したチャットエージェント、またはアクセスできるチャットエージェントは、チャットエージェントのホームページに表示されます。

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

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

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

Amazon Quick Suite コンソールにログインします。
左側のナビゲーションメニューから、チャットエージェントを選択します。
次に、チャットエージェントのリストから名前列で、詳細を表示するチャットエージェントの名前をクリックします。詳細モーダルが開きます。

注記
チャットエージェントの詳細を表示するには、共有するチャットエージェントのアクション列に移動し、メニューアイコンを選択し、チャットエージェントの詳細の表示を選択します。
チャットエージェントの詳細モーダルが開き、次の詳細が表示されます。
1. 説明 – チャットエージェントの説明。
2. 指示の概要 – チャットエージェントに定義された指示の概要。
3. 作成者 – チャットエージェントがユーザーまたは他のユーザーによって作成されたかどうかの詳細。
4. Last modified – チャットエージェントが最後に変更された時刻。
5. 機能の下:
  - ナレッジ – チャットエージェントがアタッチされているか、アクセスできるナレッジソース。チャットエージェントがスペースにリンクされている場合、どのスペースにリンクされているかを確認できます。
  - アクション – チャットエージェントがアタッチされている、またはアクセスできるアクション。これを表示するには、チャット UI エージェントセレクタのエージェント名の横にある情報をクリックします。

カスタムチャットエージェントの複製

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

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

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

Amazon Quick Suite コンソールにログインします。
左側のナビゲーションメニューから、チャットエージェントを選択します。
次に、共有するチャットエージェントのアクション列から、メニューアイコンを選択し、重複を選択します。

事前入力されたフィールドを含むチャットエージェントの重複モーダルにリダイレクトされます。
適切なユーザーおよびグループのアクセス許可の追加、必要なアセットへのリンクなど、必要な変更を加え、起動を選択して重複したチャットエージェントを起動します。

チャットエージェントを削除する

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

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

Amazon Quick Suite コンソールにログインします。
左側のナビゲーションメニューから、チャットエージェントを選択します。
次に、共有するチャットエージェントのアクション列から、メニューアイコンを選択し、削除を選択します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

システムチャットエージェント

カスタムチャットエージェントのコンテキスト設定