Oracle Cloud Infrastructureドキュメント

Cortana

コーンをチャネルに設定すると、ユーザーは、Cortanaユーザー・インタフェースを使用してデジタル・アシスタント(スタンドアロン・スキル)とチャットできます。

チャネルを設定するプロセスを次に示します:

  1. Azureにボット登録を作成して、デジタル・アシスタントと統合します。
  2. ボット登録からアプリケーションIDとパスワードを使用して、Digital Assistantにチャネルを作成します。
  3. チャネルの作成時に生成されたwebフックURLをコピーし、ボット登録に追加します。
  4. Skypeユーザー・インタフェースのチャット・ウィンドウでデジタル・アシスタントをテストします。

ステップ1: Azureでのボットのチャネル登録の作成

デジタル・アシスタント(またはスタンドアロン・スキル)をCortanaで使用可能にするには、Azure Bot Serviceで登録しておく必要があります。

この登録を作成する前に、Microsoftアカウントが必要です。

登録を作成する手順は、次のとおりです:

  1. https://portal.azure.com/に移動し、Microsoftアカウントでログインします。

  2. 検索フィールドで、チャネル登録を検索して選択します。

  3. チャネル登録ページで、Cortanaチャネルを介してデジタル・アシスタントにアクセスする際に起動名として使用するテキストをボット名フィールドに入力します。

  4. 残りの必須フィールドに入力します。

  5. 下にスクロールしてアプリケーションIDとパスワードを自動作成を選択し、表示されたパネルでアプリケーションIDとパスワードを自動作成のボタンをクリックします。

  6. 「作成」(コールバック)をクリックします。

  7. ボット登録の作成とデプロイを1分または2時間待機します。

    完了すると、デプロイメントが成功したことが通知されます。

  8. 通知で、リソースに移動をクリックします。

    通知がクリックされる前に消えた場合は、ページの上部にある通知アイコンをクリックして、再び通知を開くことができます。
    azure-notification.pngの説明は以下のとおりです
    図azure-notification.pngの説明

  9. 左側のナビゲーション・バーのBot Managementの下にある設定を選択します。
  10. MicrosoftアプリIDの値をコピーし、安全な場所に保存します。

  11. クライアント・シークレットを生成し、保存します。 これには次のようにします。
    1. アプリケーションIDの横にあるManageボタンをクリックします。

      Microsoft Bot Frameworkコンソールが表示されます。

    2. Azureポータルでこのアプリケーションを表示をクリックします。

      これで、Azureに戻ります。

    3. 左側のナビゲーションで、証明書&のシークレットをクリックします。
    4. +新規クライアント・シークレットをクリックします。
    5. 追加をクリックします。
    6. クライアント・シークレットをコピーし、システムの安全な場所に保存します。

    チャネルをDigital Assistantで構成するには、アプリIDとクライアント・シークレットの両方が必要です。

  12. クライアント・シークレットがコピーされたので、証明書&のシークレットダイアログを閉じます。
  13. Azure Portalはブラウザで開いたままにします。

    Digital Assistantでチャネルを作成するときに表示されるWebフックURLの登録を、後で完了します。

ステップ2: Digital Assistantでのチャネルの作成

  1. Digital Assistantの左側のメニューでチャネルをクリックして、ユーザーを選択します。

  2. +チャネルをクリックして「チャネルの作成」ダイアログを開きます。

  3. チャネルの名前を指定してください。

  4. チャネル・タイプとしてCortanaを選択します。

  5. Azureにボット登録を作成したときに取得したMicrosoftアプリケーションIDをMicrosoftアプリケーションidに入力します。

  6. ボット登録から取得したクライアント・シークレットを使用して、Microsoftアプリケーション・パスワードに入力します。

  7. 「作成」(コールバック)をクリックします。

  8. チャネル・ページで、WebHook URLをコピーして、システム上の都合のよい場所に貼り付けます。

  9. ルート先...ドロップダウンのアイコンをクリックし、チャネルに関連付けるデジタル・アシスタントまたはスキルを選択します。

  10. チャネル有効コントロールに切り替えます。

ステップ3: WebフックURLを構成し、Cortanaにデプロイ

  1. Azure Portalを開いているブラウザ・タブで、検索フィールドを使用してボット登録に戻ります。

  2. 左側のナビゲーション・バーで、設定を選択します。

  3. メッセージング・エンドポイントフィールドに、Digital Assistantでチャネルを作成したときに取得したwebフックURLを貼り付けます。

  4. 変更を保存します。
  5. 左側のナビゲーション・バーのBot Service内で、「Bot管理」セクションまでスクロールし、チャネルをクリックします。

  6. Cortanaのアイコンをクリックします。

  7. チャネルを構成したら、Cortanaにデプロイをクリックします。

ステップ4: Cortanaでのボットのテスト

Cortanaチャネルとメッセージの構成が完了した状態で、ボット(デジタル・アシスタントまたはスキル)をCortanaでテストできます。

次のいずれかのオプションを使用してテストできます:

  • Azure Portal内で、Webチャットでのテスト機能 (ボット管理の下)があります。
  • Cortanaアプリケーション(デスクトップまたはモバイル)で、Azureでボット登録を設定するときに使用したのと同じユーザーIDを使用します。

    このメソッドでテストする場合、何かをチャット・ウィンドウに入力するたびに、(Azure Portalに登録されている)ボット名を含める必要があります。 それ以外の場合は、Cortanaは、Oracle digital assistantと話し合うことを必ずしも認識しません。

サポートされている機能

チャネルをDigital Assistantで入力すると、次の機能がサポートされます:

  • テキスト(送信と受信の両方)
  • イメージ(送信の完全サポート、受信のサポートなし)
  • ファイル(送信の完全サポート、受信のサポートなし)
  • emojis (送信の完全サポート、受信のサポートなし)
  • links
  • カスタム・コンポーネント
  • carouselコンポーネント
  • リスト・コンポーネント
  • タイピング・インジケータ

メッセージの制約

Digital AssistantのCortanaチャネルには、次のメッセージ制約があります:

  • テキスト・メッセージ
    • テキスト・アクション・ラベルの最大長: 1行(約50文字)
    • 許可されるテキスト・アクションのタイプ: ポストバック、コール、URL
  • 水平カード
    • タイトルの最大長: 2行(約80文字)
    • 摘要の最大長: 25,000文字
    • カード処理ラベルの最大長: 1行(約50文字)
    • カードの最大数: 10
    • カード処理の最大数: 6。 カード処理の数が6を超える場合、カードが複製され、残りのカード処理がレンダリングされます。
    • カード処理の最小数: 0
    • カード・リスト・アクションの最大数: 6
    • 少なくとも1つの説明、イメージまたはアクションが必要ですか: いいえ
    • 許可されているカード処理のタイプ: ポストバック、コール、URL
    • カード・リスト処理のタイプ許可: ポストバック、コール、URL
  • 垂直カード
    • タイトルの最大長: 2行(約80文字)
    • 摘要の最大長: 25,000文字
    • カード処理ラベルの最大長: 1行(約50文字)
    • カードの最大数: 10
    • カード処理の最大数: 3
    • カード処理の最小数: 0
    • カード・リスト・アクションの最大数: 6
    • 少なくとも1つの説明、イメージまたはアクションが必要ですか: いいえ
    • 許可されているカード処理のタイプ: ポストバック、コール、URL
    • カード・リスト処理のタイプ許可: ポストバック、コール、URL
  • アタッチメント・メッセージ
    • サポート対象: Yes
    • 許可されるアクションのタイプ: ポストバック、コール、URL
  • 処理ボタン
    • グローバル・アクション・ラベルの最大長: 1行(約50文字)
    • グローバル・アクションの最大数: 6
    • 許可されるグローバル・アクションのタイプ: ポストバック、コール、URL

Cortanaチャネル拡張

Cortanaチャネルでは、Cortana固有の機能でSystem.CommonResponseコンポーネントの機能を拡張できます。

拡張機能にアクセスするには、System.CommonResponseコンポーネントのchannelCustomProperties要素を使用し、適切なプロパティを設定します。 コードの書式は次のとおりです:

...
            channelCustomProperties:
            - channel: "cortana"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Cortanaチャネルで使用可能なカスタム・プロパティは次のとおりです:

名前 指定できる値 適用対象... 説明
speak
  • フリー・テキスト
  • SSML (Speech Synthesis Markup Language)
textタイプのレスポンス・アイテム。 Cortanaがユーザーに読み取るテキストまたはSSML。 https://docs.microsoft.com/en-us/azure/bot-service/nodejs/bot-builder-nodejs-cortana-skill?view=azure-bot-service-3.0を参照してください。

channelCustomPropertiesの全般的な情報は、「チャネル固有の拡張」を参照してください。