ウィジェット ツールを使用すると、ユーザー インターフェース用のリッチでインタラクティブな UI 要素を柔軟に作成できます。このツールを構成する際は、タイプ（カルーセル、比較など）とウィジェット スキーマに関する情報を指定します。クエリへの応答時に、エージェントはこのツールと構成を使用して、ウィジェット データをクライアントに送信することがあります。クライアントはこのデータを処理し、ユーザー インターフェースにウィジェットを表示します。ユーザーが選択を行うと、この情報がエージェントに返送されます。
構成
次の構成設定を使用できます。
- 名前: ツールの一意の名前（必須）。
- 説明: ツールの機能の説明（省略可）。 これにより、エージェントの言語モデルは、このツールを使用するタイミングとデータの入力方法を理解できます。
- ウィジェットのタイプ:
このツールが表すリッチ コンテンツ ウィジェットの特定のタイプ。これにより、ペイロードの想定される構造と、クライアントがペイロードをレンダリングする方法が決まります。型は次のとおりです。
- PRODUCT_CAROUSEL: スクロール可能な商品のカルーセルを表示します。
- PRODUCT_DETAILS: 単一の商品に関する詳細情報を表示します。
- QUICK_ACTIONS: ユーザーが実行できる返信ボタンやアクションの候補のリストを表示します。
- PRODUCT_COMPARISON: 複数の商品を並べて比較したものを表示します。
- ORDER_SUMMARY: 注文の概要を表示します。
- パラメータ: ウィジェット データの入力スキーマ。エージェントは、ツールを呼び出すときにスキーマを使用します。これは、スキーマ オブジェクトを使用して定義され、ウィジェットのコンテンツの想定されるフィールドとデータ型を指定します。
ツールの説明の例
効果的なツール記述の例を次に示します。
| ウィジェット タイプ | ツールの説明の例 |
|---|---|
| 商品カルーセル | UI カルーセル コンポーネントを生成します。ユーザーがオプションやカタログの表示をリクエストした場合は常に必要です。productDetails で商品のリストを指定する必要があります。システムは自動的にビジュアル カードをレンダリングします。 |
| 商品の詳細 | このツールは、商品情報を取得してユーザーに表示しようとした後に呼び出す必要があります。 |
| クイック アクション | このツールは、ユーザーがビジネス、学校、非営利団体かどうかを尋ねられたときに呼び出す必要があります。「私はビジネスです」、「私は学校です」、「私は非営利団体です」と表示されるクイック アクションを 3 つ含めてください。 |
| プロダクトの比較 | このツールは、2 つの商品を比較するよう求められたときに呼び出す必要があります。 |
| 注文の概要 | お客様が購入手続きを完了する準備ができている場合は、このツールを使用します。商品、価格の内訳（税金と送料を含む）、登録されているお支払い方法の構造化された視覚的な概要が生成されます。このツールは、ユーザーが購入手続きに進むことを確認した後にのみ呼び出してください。 |