Virtual Agent の動的構成

注: 2018 年 6 月 19 日以降は、Watson Virtual Agent の新規インスタンスを作成できません。 このサービスは、2019 年 3 月 19 日に IBM Cloud カタログから削除されました。

IBM® Voice Gateway API を使用して、IBM Watson™ Virtual Agent を通話中に動的に構成できます。 構成を変更するには、IBM Watson™ Assistant ダイアログ・ツリー内のノード応答の outputvgwActSetWVAConfig アクションを定義します。 この API の使用について詳しくは、『アクション・タグおよび状態変数の定義』を参照してください。

vgwActSetWVAConfig アクションに対して定義できる属性は、SIP Orchestrator 構成環境変数にそれぞれ対応しています。 属性が Watson Assistant サービスで定義されていない場合は、関連する環境変数の値が使用されます。

重要: vgwActSetWVAConfig アクションおよび vgwActSetConversationConfig アクションは、両方をアクション・シーケンスに定義することはできません。 一度に構成できるのは、単一の Watson Assistant ワークスペースまたは Virtual Agent チャットボットのみです。

次の例は、vgwActSetWVAConfig アクションを使用して Virtual Agent チャットボットを動的に構成する方法を示しています。

{
  "output": {
    "vgwAction": {
      "command": "vgwActSetWVAConfig",
      "parameters": {
        "wvaURL":"https://dev.api.ibm.com/virtualagent/test/api",
        "wvaBotID":"9h7f54cb-69e7-49cd-ae8b-0d39967ba829",
        "wvaClientId":"a23de67h-22d4-4ac0-92b4-a64981928c7f",
        "wvaClientSecret":"rM8bI2gP4pV4sT0gB4xH4iP1mM8dF1xG0vN0hP1gD6wE6tM0qX"
      }
    }
  }
}
表 1. Virtual Agent の属性
属性 説明 関連する環境変数
wvaURL Watson Virtual Agent API の url の資格情報。 WATSON_VA_URL
wvaBotID Watson Virtual Agent API の bot_id の資格情報。 WATSON_VA_BOT_ID
wvaClientId Watson Virtual Agent に対する API 呼び出しのための X-IBM-Client-Id ヘッダー・フィールドの認証キー。 WATSON_VA_CLIENT_ID
wvaClientSecret Watson Virtual Agent に対する API 呼び出しのための X-IBM-Client-Secret ヘッダー・フィールドの認証キー。 WATSON_VA_CLIENT_SECRET