デジタル・アシスタント(またはスタンドアロン・スキル)を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
   

9. 左側のナビゲーション・バーで、「ボット管理」の下にある「設定」を選択します。

10. 「Microsoft アプリ ID」の値をコピーして、安全な場所に保存します。

11. クライアント・シークレットを生成して保存します。これは次のようにして行うことができます:

    1. アプリケーションIDの横にある「管理」ボタンをクリックします。

       これにより、Microsoft Bot Frameworkコンソールに移動します。

    2. 「このアプリを Azure ポータルに表示する」をクリックします。

       これにより、Azureに戻ります。

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

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

12. クライアント・シークレットをコピーしたら、「証明書とシークレット」ダイアログを閉じます。

13. ブラウザでAzureポータルを開いたままにします。

    後で、デジタル・アシスタントでチャネルを作成するときに取得するWebフックURLを使用して登録を完了します。

1. デジタル・アシスタントで、左側のメニューの「チャネル」をクリックして、「ユーザー」を選択します。

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

3. チャネルの名前を指定します。

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

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

6. Microsoftボット・パスワード(クライアント・シークレット値)に、ボット登録から取得したクライアント・シークレット値を入力します。

7. 「作成」をクリックします。

8. 「チャネル」ページで、WebフックURLをコピーして、システム上の便利な場所に貼り付けます。

9. をクリックし、チャネルに関連付けるデジタル・アシスタントまたはスキルを選択します。

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

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

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

3. 「メッセージング エンドポイント」フィールドに、デジタル・アシスタントでチャネルを作成したときに取得したWebフックURLを貼り付けます。

4. 変更を保存します。

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

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

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

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

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

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

  この方法を使用してテストする場合は、チャット・ウィンドウに何かを入力するたびにボット名(Azureポータルで登録したもの)を含める必要があります。そうしないと、Cortanaは、Oracleのデジタル・アシスタントと会話しようとしていることを必ずしも認識しません。

デジタル・アシスタントのCortanaチャネルでは、次の機能がサポートされています:

• テキスト(送信と受信の両方)
• イメージ(送信の完全サポート、受信のサポートなし)
• ファイル(送信の完全サポート、受信のサポートなし)
• 絵文字(送信の完全サポート、受信のサポートなし)
• リンク
• カスタム・コンポーネント
• カルーセル・コンポーネント
• リスト・コンポーネント
• 入力インジケータ

デジタル・アシスタントの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
• アタッチメント・メッセージ
  • サポートの有無: はい
  • 許可されるアクションのタイプ: ポストバック、コール、URL
• アクション・ボタン
  • グローバル・アクション・ラベルの最大長: 1行(約50文字)
  • グローバル・アクションの最大数: 6
  • 許可されるグローバル・アクションのタイプ: ポストバック、コール、URL

Cortanaチャネルの場合、Cortanaに固有の機能でCommon Responseコンポーネントの機能を拡張できます。

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

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

Cortanaチャネルで使用可能なカスタム・プロパティを次に示します:

channelCustomPropertiesの使用方法の詳細は、チャネル固有の拡張を参照してください。