チャネルの基本

デジタル・アシスタントとスタンドアロン・スキルをユーザーに公開するには、デジタル・アシスタントでチャネルを構成します。チャネルは、様々なメッセージング・プラットフォーム上のユーザーとデジタル・アシスタントおよびその様々なスキルとの間のチャットを伝送します。ユーザー・エージェントのエスカレーションとテストのチャネルもあります。

左側のメニューで「チャネル」をクリックしてアクセスする「チャネル」ページから、次のチャネル・タイプを作成および管理できます。タイプごとに1つのタブがあります。

ユーザーに表示されるチャネルそれぞれを、デジタル・アシスタントまたはスキルの1つのバージョンにルーティングできます。

1つのチャネルで実行できるスキルまたはデジタル・アシスタントのバージョンは常に1つのみです。スキルの新しいバージョンを作成する場合、古いバージョンへのルーティングを停止し、更新されたバージョンへのルーティングを割り当てることができます。

それぞれに個別のチャネルを作成することで、スキルまたはデジタル・アシスタントの2つのバージョンの同時実行をサポートできます。たとえば、ベータ・テスト担当者が1つのチャネルを介してスキルにアクセスしている間に、顧客は別のチャネルを介してチャットを中断することなく続行できます。

HTMLタグを使用して、チャネル固有のマークアップまたはマークダウンがあるチャネルでも、スキル・メッセージを書式設定できます。メッセージがチャネルに渡されると、含めるHTMLタグは、その特定のチャネルに対して適切なマークアップまたはマークダウンに置き換えられます。これにより、複数のチャネルに対してメッセージを1箇所に書き込むことができます。

タグがチャネルで直接同等でない場合、最も近いものが使用されます。たとえば、メッセージに<h1>Title 1</h1>および<h2>Title 2</h2>タグがある場合、Slackチャネルに送信されると、*Title 1*および*Title 2*に変換されます。

チャネル内のタグに相当するものがない場合は、チャネルに送信されるときにメッセージからタグが取り除かれます。

構成するチャネルごとに、「セッションの有効期限」フィールドを使用して、非アクティブ・ユーザー・セッションのタイムアウトを設定します。ほとんどのチャネル・タイプで、デフォルト値は1日(1440分)です。セッションが期限切れになると、会話は終了し、その事実をユーザーに通知するメッセージが送信されます。

また、変数がユーザー・スコープ変数として宣言されていない場合、スキルのダイアログ・フローで設定された変数は破棄されます。「YAMLダイアログ・フローでのユーザー・スコープ変数」を参照してください。

必要に応じて、「セッションのリセット」ボタンをクリックすることにより、ユーザー・チャネルにおける現在の会話を中止できます。

「セッションのリセット」ボタンにアクセスするには:

• をクリックしてサイド・メニューを開き、「開発」→「チャネル」を選択して、ユーザー・チャネルを選択します。

時折、チャネルを無効にしてメンテナンスや構成の更新を行った後、チャネルを再度有効にすることが必要になる場合があります。

これを行うには、次のスイッチを使用できます:

• チャネル有効
• 対話が有効(エージェント統合の場合)
• アプリケーション有効(アプリケーションの場合)

スキル・テスターをサポートするシステム・チャネルを無効にすると、チャネルが使用できないというアラートが開発者に表示されます。

これらのオプションにアクセスするには:

• をクリックしてサイド・メニューを開き、「開発」→「チャネル」を選択して、チャネルを選択します。

複数のチャネルにわたってレンダリングするためにダイアログ・フローで使用できる汎用要素に加えて、チャネル・タイプに固有の機能を利用することもできます。そのためには、共通レスポンス・コンポーネントのchannelCustomPropertiesメタデータ要素を使用します:

...
            channelCustomProperties:
            - channel: "CHANNEL_NAME" // can be facebook, slack, cortana, twilio, androidsdk, iossdk, websdk, test
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

コンポーネントのメタデータ内のchannelCustomPropertiesは、指定されたプロパティに応じて、globalActions、responseItems、およびresponseItemsの要素のレベルで適用できます。

レスポンス・アイテム・レベルとカード・レベルで定義されたカスタム・プロパティの例を次に示します:

responseItems:
  - type: "cards"
    cardLayout: "vertical"
    cards:
      - title: "${pizzas.name}"
        description: "${pizzas.description}"
        imageUrl: "${pizzas.image}"
        url: "${pizzas.moreInfo}"
        iteratorVariable: "pizzas"
        channelCustomProperties:
          - channel: "facebook"
            properties:
              webview_height_ratio: "compact"
              fallback_url: "https://www.example.com"
    channelCustomProperties:
      - channel: "facebook"
        properties:
          top_element_style: "large"
..

channelCustomProperties要素は配列を受け取ります。各エントリは特定のチャネルのプロパティを指定します。カスタム・プロパティの中には、特定の共通レスポンス・コンポーネント要素、あるいは特定のレスポンス・アイテム・タイプにのみ適用可能なものもあります。上の例では、top_element_styleはcardsタイプのレスポンス・アイテムにのみ適用されます。

また、Freemarker式を使用してチャネル・カスタム・プロパティの値を指定することもできます。

コンポジット・バッグ・エンティティであるexpenseの解決時に経費日付アイテムの入力を要求された場合に日付ピッカーがSlackにのみ表示される例を次に示します:

responseItems:
  - type: "text"
    text: "${system.entityToResolve.value.prompt}"
    channelCustomProperties:
      - channel: "slack"
        properties:
          showDatePicker: "${system.entityToResolve.value.name=='Date'}"
...

使用可能なプロパティは、チャネルによって異なります。それぞれのチャネルで使用可能なカスタム・プロパティのリストは、次の各トピックを参照してください:

• Facebook Messengerチャネルの拡張機能
• Slackチャネルの拡張機能
• Microsoft Teamsのアダプティブ・カード
• Cortanaチャネルの拡張機能
• Twilioチャネルの拡張機能
• Oracle Webチャネルの拡張機能
• Oracle iOSチャネルの拡張機能
• Oracle Androidチャネルの拡張機能

ここでは、チャネルおよび各チャネルでサポートされている機能を比較します(すべてを網羅しているわけではありません)。