チャットボットでナレッジエージェントを使用する

早期アクセス

チャットボット・エディター(/automation-studio/chatbots/build-chatbots)のエージェント・コネクタエレメントを使用して、ナレッジ・エージェントをチャットボットに追加します。

エージェントは、接続されたナレッジソースから回答を取得することで、エンドユーザーの質問を処理します。

始める前に

エージェントコネクタエレメントが質問を処理する前に、チャットボットはエンドユーザーのメッセージを属性でキャプチャする必要があります。次のいずれかのオプションを使用します。

エージェントコネクタ エレメントをチャットボットのダイアログに追加します。エレメントごとに選択できるナレッジエージェントは 1 つだけですが、ダイアログ間で複数のエージェントコネクタ要素を追加できます。

エージェントコネクタには、リクエスト、レスポンス、フォールバックの3つのタブがあります。

フィールド	説明
AIエージェントを選択	ドロップダウンからナレッジエージェントを選択します。
ユーザーメッセージ	値を定義するか、エンドユーザーのメッセージを含む属性を選択します。チャットボットは、この値をナレッジエージェントに渡します。
エージェントのバージョンを選択	使用するエージェントのバージョンを選択します。
エージェントコンテキスト(オプション)	追加のコンテキストとしてエージェントに渡す属性を選択します。新しい属性を作成する場合は、属性の作成を選択します。

**エージェントコンテキスト(オプション)**で、新しい属性の作成を選択します。
属性の Name を入力します。
タイプは自動的にJSONに設定されます。
(オプション)既定値 を入力します。
スコープを選択します。
- チャットボット — 属性値は、チャットボットのすべてのダイアログで保持されます。
- ダイアログ — 会話が別のダイアログに移動すると、属性値がリセットされます。
(オプション)エージェントが利用可能 を選択して、Conversations のライブエージェントに属性を表示します。
(オプション)機密データを選択して、チャットボットと受信トレイの属性値を非表示にします。
Save (保存) を選択します。

フィールド	説明
応答コード	(オプション)HTTP 応答コードを保存する属性を選択します。
応答本文の属性	応答本文から値を抽出します。応答コード JSON スキーマの表示を選択して応答構造を表示し、属性の追加を選択して JSON パスを属性にマップします。`$.content` を使用して、エージェントの応答を抽出します。
タイムアウト	フォールバックをトリガーする前に応答を待機する最大時間 (秒単位)。

フィールド	説明
フォールバックアクション	フォールバックがトリガーされたときに実行するアクションを選択します。ダイアログに移動は、エンドユーザーを別のダイアログにルーティングします。エージェントに接続は、会話を受信トレイのライブエージェントに転送します。
ダイアログ	ルーティング先のダイアログを選択します。
フォールバックメッセージ(オプション)	フォールバックがトリガーされたときにエンドユーザーに送信するメッセージを入力します。
リンクプレビュー	フォールバックメッセージ内のリンクのプレビューを表示する場合に有効にします。
API の失敗にも使用	タイムアウトの失敗に加えて、APIの失敗にもフォールバックを適用できます。

テキスト エレメントを使用して、ナレッジエージェントの応答を保存した属性を追加します。

より高度な会話フローを作成するには、各応答の後に会話をナレッジエージェントにルーティングします。