Zoom Virtual Agentツールの作成

• 非パラメトリックソースからデータを取得して処理すること。
• ユーザーのリクエストを満たすためにバックエンドアクションを実行すること。
• 言語生成を超えてエージェントの機能を強化すること。

• 位置情報の検索: IPベースのデータを使用して、近くの店舗をユーザーに表示します。
• 情報の取得: ユーザーのクエリに基づいて、API呼び出しまたはカスタムスクリプトを使用して注文の詳細やアカウント情報を取得します。
• 情報の更新: レコーディングを修正し、ユーザーに更新を確認します。

Zoom Virtual Agentツールの作成要件

• アカウントオーナーまたは管理者の特権、または関連するロール / 特権
• ベーシック、プロ、ビジネス、教育機関向け、またはエンタープライズアカウント
• Zoom Virtual AgentおよびZoom Contact Centerライセンス

Zoom Virtual Agentツールの作成方法

1. Zoomウェブポータルにサインインします。
2. ナビゲーションメニューで、[AI Studio] > [ツールライブラリ] 順にクリックします。
   次のタブが表示されます：
   • すべてのツールタイプ: 利用可能なすべてのツールを表示します。
   • 内蔵: Zoomが提供するツール。
   • カスタム: ユーザーが作成するツール。
3. [すべてのツールタイプ]または[カスタム] タブで、[ツールを作成] をクリックします。
4. ツールタイプを選択します: [API呼び出し] または [カスタムスクリプト]。
5. 選択したツールタイプの設定を構成します。
6. [作成] をクリックします。

API呼び出しの設定

• 名前: API呼び出しツールの表示名を入力します。
• 説明: ツールをいつ、なぜ使用すべきかについて簡潔な説明を提供します。これにより、LLMがAPI呼び出しをトリガーするための適切なコンテキストを理解するのに役立ちます。例: 「ユーザーが最近の注文のステータスを尋ねたときにこのツールを使用します。」
• エンドポイントURL: APIエンドポイントを入力します。パス変数には波括弧内のスペースホルダーを使用します。例: /api/user/ {userId}
• 方式: HTTP方式（GET、POST、PUT、またはDELETE）を選択します。
• 認証（オプション）: APIで必要な場合は、認証方法（たとえば、BearerトークンまたはAPIキー）を追加します。
• APIタイムアウト値: 呼び出しがタイムアウトするまでに応答を待つ最大時間（秒単位）を指定します。
• パラメータ（オプション）: APIに必要な入力パラメータを定義します。これらのパラメータは、ユーザー入力または事前定義された値に基づいて、ZVAがAPI呼び出しを動的に構築するのを支援します。[パラメータの追加] をクリックし、以下を指定します。
  • 名前: APIによって想定されるパラメータの名前。
  • 説明: パラメータの目的を説明します。LLMがその値を指定する方法を決定できるように、具体的に記述してください。
  • 場所: パラメータが配置される場所（パス、クエリ、ヘッダー、または本文）。
  • タイプ: データタイプ（たとえば、文字列、数値、ブール値）。
  • 値のソース: 値の取得元（手動で設定、またはLLMを介して収集）。
  • 値を設定 / 値: 値がどのように導出されるかを定義します（たとえば、user.phoneNumber、「12345」）。
• デバッグ: 設定をテストするには:
  • [実行] ボタンをクリックします。
  • 入力パラメータ: 定義したパラメータの値を表示します。
  • 結果: 必要に応じて正確性を検証し、トラブルシューティングを実行できるように、生のAPI応答を表示します。
• 応答（オプション）: APIから返されるデータをどのように解釈して使用するかを定義します。[パラメータを追加] をクリックし、各応答属性について以下を入力します。
  • 名前: JSON応答からのキー。
  • 説明: 値の重要性を説明します。これにより、LLMが返信でそれをどのように使用するかを理解するのに役立ちます。
  • タイプ: データタイプ（たとえば、文字列、数値、ブール値）。
  • 変数にマッピング（オプション）: 後で参照できるように、応答値をZVAまたはスキルレベルの変数にマッピングします。

カスタムスクリプトの設定

• 名前: カスタムスクリプトツールの表示名を入力します。
• 説明: このツールをどのようなシナリオで使用すべきかを説明します。LLMがスクリプトをトリガーするタイミングを決定できるように、具体的に記述してください。例: 「時間帯やユーザーの場所に基づいてパーソナライズされた挨拶をユーザーが求めたときに、このツールを使用します。」
• JavaScript: JavaScriptを使用して、ツールが実行するロジックを記述します。このスクリプトは、安全で隔離された環境で実行されます。
• スクリプトを記述した後、[コードをフォーマット] ボタンをクリックして、可読性を向上させ、コード構造が維持されるようにします。
• パラメータ（オプション）: 入力パラメータを定義してスクリプトを動的にします。これらの値は、ユーザーの入力、スキルコンテキスト、または他のツールから渡すことができます。[パラメータの追加] をクリックし、以下を指定します。
  • 名前: スクリプト内で使用される変数名。
  • 説明: このパラメータが何であり、どのように使用されるかについての明確な説明。LLMが何を渡すかを決定するのに役立ちます。
  • タイプ: データタイプ（たとえば、文字列、数値、ブール値）。
  • 値のソース: 値の取得元（手動で設定、またはLLMを介して収集）。
  • 値を設定 / 値: 値がどのように導出されるかを定義します（たとえば、user.phoneNumber、「12345」）。
• 応答（オプション）: スクリプトがどのデータを返し、それがどのように使用されるべきかを指定します。[パラメータを追加] をクリックし、以下を入力します。
  • 名前: スクリプトから返されるキー名（たとえば、メッセージ、スコア）。
  • 説明: 値の意味または用途を説明します。これにより、LLMが返信にそれを自然に組み込むのに役立ちます。
  • タイプ: 返される値のフォーマット（たとえば、文字列、数値、ブール値）。
  • 変数にマッピング（オプション）: 後でスキル、返信、またはレポートで使用できるように、出力を再利用可能な変数に割り当てます。

Zoom Virtual Agentツールを作成するためのベストプラクティス

• 検出可能性を向上させ、LLMをガイドするために、明確で一貫した名前と説明を使用します。
• エージェントの応答に必要な必須の応答属性のみをマッピングします。
• スキルや返信での参照を簡素化するために、意味のある変数名を使用します。
• 公開する前に、デバッグツールですべてのAPI呼び出しをテストします。
• エラーを阻止するために、モジュール式でテスト可能なスクリプトを記述し、入力パラメータを検証します。
• ユーザーのリクエストを効果的に満たすために必要なデータのみを返します。

この記事は、Zoom Virtual Agentの音声およびチャット・エージェントに適用されます。Zoom Virtual Agentの従来のチャットボットを使用している場合は、セットアップと展開の手順について、このドキュメントを参照してください。