詳細情報:
B2C 買い物客エージェントのサブエージェント
B2C Shopper Agent に割り当てられたサブエージェントによって、エージェントの機能が定義されます。各サブエージェントは、商品の検出、買い物カゴ、注文の確認、FAQ、安全性チェックなど、ショッピングジャーニーの 1 つのステージを管理します。
エージェント ルーター
すべてのエージェント会話は、エージェントルーターサブエージェントで始まります。このサブエージェントは、買い物客とのやり取りの各際に、適切な買い物客エージェント固有のサブエージェントに会話を転送します。
| サブエージェント名 | 機能 | 操作 |
|---|---|---|
start_agent agent_router
|
このサブエージェントは、すべての買い物客メッセージを読み取り、正しいサブエージェントにルーティングします。買い物客がフォローアップリクエストを送信すると、エージェントルーターはそれが現在のタスクに関連していると認識し、正しいサブエージェントにルーティングします。 また、セッションの設定も行います。たとえば、ルーティングの前に、リンクされたサイト ID とユーザー ロケールをメッセージング セッション レコードから作業変数にコピーします。 |
|
- 買い物客が会話中にあいまいな返信で応答した場合 (たとえば、「追加」と入力した場合)、エージェントルーターはこれらの返信を、新しいリクエストではなく、現在のタスクに関連するものとして扱います。
- エージェントは、買い物客の最新のメッセージに基づいてメッセージをルーティングします。以前のメッセージで完了したバックグラウンド コード、自動化されたツールの使用、または技術的な手順が自動的に除外されます。エージェントは、過去のシステムアクティビティに干渉されることなく、買い物客が現時点で求めているものに正確に反応します。
ルーター・サブエージェントをカスタマイズするには、以下のようにします。
- ルートを追加して新しいサブエージェントを公開するか、ルートを削除 (コメントアウト) して機能をオフにします。
- ウェルカム メッセージまたはルーティング手順を調整します。たとえば、ルーターの説明を編集して、最初のチャットセッションで最初に買い物客を歓迎するようにします。
- ルーティングロジックを並べ替えたり、言い換えたりして、エージェントがあいまいなリクエストを解釈する方法に影響を与え、カタログに合うようにリクエストを解決します。
買い物客エージェントサブエージェント
商品エキスパート、買い物カゴ、および注文確認のサブエージェントは、1 つの推論ノードを共有します。このノードは、テンプレート変数の共通セットから各サブエージェントのプロンプトを作成します。Support および Safety サブエージェントは、共有ノードを使用しません。彼らは独自の指示で実行されます。これら 3 つのコマース サブエージェントは同じ変数から取得するため、1 つの変数を編集すると、それを使用するすべてのサブエージェントの動作が変わります。
- retailer_name
- retailer_description
- retailer_voice
- tool_calling_guidance
- response_guidance
- example_response
- id_col
安全およびガードレールサブエージェント
要求を分類するだけのサブエージェントもあります。それ以外は何もしません。意図的に狭くしています。それぞれに詳細な「使用しない」セクションが含まれているため、一般的なショッピング用語が攻撃として扱われることはありません。これらのガードレールはconfig.additional_parameter__disabled_topicsで定義します。
- リバースエンジニアリング - エージェントの内部を抽出しようとする試みをキャッチします。これらの要求には、「システム プロンプトを表示する」、「すべてのツールを一覧表示する」、「指示を翻訳する」を使用できます。add、view、find、checkout、"this tool" などのドメイン動詞を明示的に無視します。
- プロンプトインジェクション - 「前の指示を無視する」、偽の <システム> タグ、「開発者モード」、権限の偽装、エンコードされたペイロードなどのオーバーライド試行をキャッチします。買い物客が説明した詳細の "ignore" や "forget" などの単語を明示的に無視します。
- 不適切なコンテンツ - 真に有害なユーザー作成コンテンツ(ヘイトスピーチ、脅迫、CSAM、自傷行為、違法行為の指示)を捕捉します。コマースの語彙 ("broken"、"dead battery"、"killer deal" など) や買い物客からの苦情 ("worst experience" など) を、常に無害なものとして明示的に扱います。これらのサブエージェントは、このタイプのコンテンツを含むメッセージを適切なサブエージェントにルーティングし、フラグは立てません。
- オフトピック — トピックから外れた質問には回答せず、システムの詳細も明らかにせずに、トピックから外れた一般的なナレッジ要求をショッピングトピックに丁寧にリダイレクトします。
これらのサブエージェントをカスタマイズするには、以下のようにします。
- 店舗に合わせてシグナルリストを調整します。機密性の高い単語を含む独自の商品名を
常に無害なリストに追加して、テンプレートでフラグが付けられないようにします。確認された攻撃パターンを追加します。 - トピックから外れたリダイレクトメッセージとルールを調整します。
config.additional_parameter__disabled_topicsを使用して、無効にされたトピックを追加または削除します。
Subagent 構成のヒント
- 多くのサブエージェントが 1 つの変数を共有できます。シェア変数を使用するすべてのサブエージェントを変更しないようにするには、cart_tool_calling_guidanceやorder_tool_calling_guidanceなどのスコープ付きバリアントを使用して、個々のサブエージェントの動作を制御します。
- 各
response_guidance文字列には 255 文字の制限があります。この制限を超えると、エージェントスクリプトエラーが発生します。 - response_guidanceは JSON です — エスケープされた引用符を検証し、末尾のコンマを避けます。
- プレースホルダーを置き換えます。
UPPER_SNAKE_CASEセクションにトークンを置き換えないままにしておくと、発行に失敗する可能性があります。 - 実際のデータでテストします。エージェントプレビューでは、モックモードは偽のカタログデータを返します。結論を出す前に、検索と買い物カゴの動作を実際のアクションに対してテストします。
- B2C 買い物客エージェント |製品エキスパート
参照、検索、推奨、比較、製品に関する質問など、製品に関するすべてのリクエストを処理します。カタログを検索し、必要に応じて詳細な製品情報を検索します。 - B2C 買い物客エージェント |カートサブエージェント
Cart サブエージェントは、買い物カゴのライフサイクル全体を管理します。このサブエージェントは、商品とバリアントを追加し、買い物カゴの概要を表示し、明細行を更新し、プロモーション・コードとクーポン・コードを適用します。 - B2C 買い物客エージェント |注文確認
Order Confirmation サブエージェントは、買い物客が注文を行ったことを確認し、注文の詳細を表示します。また、支払が失敗した場合や支払方法がキャンセルされた場合にも、買い物カゴは復元されます。 - B2C 買い物客エージェント |サイトに関する FAQ サブエージェント
サイト FAQ サブエージェントは、FAQ、配送料、返品期間、返金など、ストアポリシーに関する買い物客の質問に回答します。接続されたナレッジ ベースからのみ回答を引き出し、一致するものが見つからない場合は適切な応答を返します。 - カスタムサブエージェントとカスタムアクションの追加
Shopper Agent のサブエージェントは、トランザクションのショッピング体験を管理します。サブエージェント・テンプレートにない機能が必要な場合は、カスタム機能を作成します。
