SMS Gateway 用の Watson Assistant サービスまたはサービス・オーケストレーション・エンジンの動的構成

SMS Gateway API を使用することで、チャット・セッション中に IBM Watson™ Assistant サービスまたはサービス・オーケストレーション・エンジンを動的に構成できます。 構成を変更するには、Watson Assistant ダイアログ・ツリー内のノード応答の output に smsActSetConversationConfig アクションを定義します。 元の会話ターンでテキストが提供された場合、そのテキストは、ユーザーにメッセージが送信される前に提供された新規テキストと連結されます。 このアクションは、アクションの詳細で定義されたすべてのパラメーターをサポートします。 詳しくは、『SMS Gateway 用の API』を参照してください。

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

smsActSetConversationConfig アクションの定義例については、以下のセクションを参照してください。

• Watson Assistant サービス
• サービス・オーケストレーション・エンジン

Watson Assistant サービス

重要: スキル API 詳細 (Skill API Details) により指定されたとおり、ユーザー名とパスワードの組み合わせか、API 鍵を指定してください。

以下の例では、Watson Assistant ワークスペースを定義する方法を示します。

{
  "output": {
    "smsAction": {
      "command": "smsActSetConversationConfig",
      "parameters": {
        "url":"https://gateway.watsonplatform.net/conversation/api",
        "workspaceID":"a23de67h-4e92-4565-c1b5-ebd59a2ffcad",
        "username":"9h7f54cb-5epb-80d6-45c3-da41d2bf7a71",
        "password":"asxNzDLpIJ6F"
      }
    }
  }
}

      "parameters": {
        "url": "https://gateway.watsonplatform.net/assistant/api",
        "password": "luLaaaaaaa-XLuCeIz-FUaizkj-L8n8t8WcccccYITi6T",
        "username": "apikey",
        "workspaceID": "cxxxxxc-4ea2-4234-b600-3xxxxxx0764ba",
        "tokenServiceProviderUrl": "https://gateway.watsonplatform.net/authorization/api/v1/token"
      }

サービス・オーケストレーション・エンジン

サービス・オーケストレーション・エンジンの構成では、Watson Assistant サービスの構成と同じ環境変数を使用するため、smsActSetConversationConfig アクションでもこの構成を変更します。

重要: 直接構成された Watson Assistant サービスとサービス・オーケストレーション・エンジンとの間で切り替えを行う場合は、workspaceID 属性を空値に設定して、構成からの値が使用されないようにします。

{
  "output": {
    "smsAction": {
      "command": "smsActSetConversationConfig",
      "parameters": {
        "url":"https://soe-example.net",
        "username":"adminuser",
        "password":"XgUCZZItgZD0"
      }
    }
  }
}