インテリジェント・アドバイザ・サービスは、Oracle Digital Assistantのインテリジェント・アドバイザ・ダイアログ・フロー・コンポーネントと連携して、Oracle Intelligent Advisorインタビューをスキルに統合できます。

スキルがインタビューを実施するときは、会話でのアーティファクトの表示方法で説明されているように、チャネルに適した方法で各フィールドが表示されます。インタビューを進めるには、顧客は質問に回答するか、次のスラッシュ・コマンドのいずれかを使用します:

スキルとインタビューの統合は、3ステップのプロセスです。

1. インテリジェント・アドバイザ・サービス統合を追加します。
2. インタビューの会話らしいバリエーションを作成します(オプションですが強く推奨します)。
3. スキルのダイアログ・フローにインテリジェント・アドバイザ・コンポーネントを追加します。

スキルからOracle Intelligent Advisorインタビューにアクセスするには、インテリジェント・アドバイザ・サービスを追加する必要があります。これによって、Oracle Digital Assistantとインテリジェント・アドバイザ・ハブのAPIクライアント間の接続が構成されます。

インテリジェント・アドバイザ・ハブからAPIクライアント情報を取得し、デジタル・アシスタントでインテリジェント・アドバイザ・サービスを作成するステップを説明します。インテリジェント・アドバイザ・ハブのステップは、ハブ管理者が完了する必要があります。

1. インテリジェント・アドバイザ・ハブで、をクリックしてサイド・メニューを開き、「権限」をクリックして、「ワークスペース」タブをクリックします。

2. 目的のコレクションをクリックし、「チャット・サービス」が選択されていることを確認して、コレクション内のデプロイメントがアクティブ化されたときに、それらがデフォルトでチャット・サービスに対してアクティブ化されるようにします。

3. 「APIクライアント」タブをクリックします。

4. チャット・サービス・ロールを持つクライアントが表示されない場合は、そのロールを既存のクライアントのいずれかに割り当てるか、チャット・サービス・ロールを有効にしてクライアントを作成します。

5. APIクライアントを開き、クライアントが有効になっていることを確認し、シークレットとAPIクライアントの識別子をメモします。これらはインテリジェント・アドバイザ・サービスを作成するために必要になります。

6. ページの「ハブ管理者」を選択するか、ワークスペースの「マネージャ」を選択します。これらのいずれも選択されていない場合、インテリジェント・アドバイザ・サービス・ページからハブのアクティブなチャット・デプロイメントを表示できなくなります。また、サービス・ページから新しいスキルを直接作成することもできません。

7. ハブからサインアウトできます。

   デジタル・アシスタントで、をクリックしてサイド・メニューを開き、「設定」、「追加サービス」、「インテリジェント・アドバイザ」タブの順にクリックします。

8. 「+サービス」をクリックします。

9. 「新規インテリジェント・アドバイザ・サービス」ダイアログで、サービスの一意の名前を指定します。

   これは、スキルのダイアログ・フローでインテリジェント・アドバイザ・コンポーネントの「インテリジェント・アドバイザ・サービス名」プロパティに使用する名前です。

10. インテリジェント・アドバイザ・ハブのホストを入力します。https://接頭辞は省略します。例: myhub.example.com。

11. 「クライアントID」および「クライアント・シークレット」に、前にメモしたAPIクライアント識別子とシークレットを設定します。

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

13. 「設定の検証」をクリックして、入力した設定を使用して接続できることを確認します。

サービスを使用するスキルを作成すると、インテリジェント・アドバイザ・サービス・ページにスキルの名前と、スキルが使用するハブ・デプロイメントが表示されます。サービスのページのこれらのスキルのスキル・テスターを直接開くことができます。また、このページでスキルを直接作成することもできます。「インテリジェント・アドバイザ・サービス・ページからのスキルの作成およびテスト」を参照してください。

APIクライアントの詳細は、インテリジェント・アドバイザ・ドキュメント・ライブラリのプロジェクトのアクティブ化およびAPIクライアントの詳細の更新を参照してください。

インテリジェント・アドバイザ・サービス・ページには、Hubのアクティブなチャット・デプロイメントを使用するすべてのスキルがリストされ、リストされたスキルのいずれかに対してスキル・テスターを実行できます。また、このページでは、アクティブなデプロイメントにアクセスするスキルを作成できます。

リストにあるスキルをテストするには、スキルの名前の横に表示される「このスキルのテスト」アイコンをクリックします。会話テスターが開いたら、会話を開始します。一般的なスキルでは、hiと入力して[Enter]を押すだけで開始できます。ただし、スキルが特定のフレーズを探している場合があります。その場合、理解できないフレーズを入力した場合は、何を入力するかを指示する必要があります。

インテリジェント・アドバイザ・サービス・ページからスキルを作成するには、匿名ユーザーのサービスを選択し、「+新規スキル」をクリックします。(スキルは、ポータル・ユーザーまたはエージェント・ユーザーに対して有効なデプロイメントにアクセスできません。)スキルの表示名を指定し、ドロップダウンからデプロイメントを選択して、「作成」をクリックします。新しいスキルが、サービスを使用するスキルのリストに表示されます。

スキルからアクセスできるハブのデプロイメントのリストを表示するには、「追加サービス」に移動し、「インテリジェント・アドバイザ」をクリックしてハブのサービスを選択し、「デプロイメント」をクリックします。

デプロイメントがWeb対応の場合は、名前の横に「Webインタビューの開始」アイコンが表示されます。アイコンをクリックすると、新しいブラウザ・タブでインタビューを実行できます。

ハブでデプロイメントにアクセスするには、「デプロイメントの管理」をクリックします。

図ia-deployments.pngの説明

サービスのAPIクライアントにハブ管理者またはマネージャが選択されていない場合は、ページにデプロイメントを表示できず、操作を実行する権限がないという通知が表示されます。インテリジェント・アドバイザ・サービスの追加を参照してください。

これは実際の要件ではありませんが、会話技術を取り入れることで、チャットベースのOracle Intelligent Advisorインタビューの有効性を大幅に向上させることができます。

ほとんどのインタビューは、Webページのフォーム用に最適化されており、画面ラベル、セクション・ラベルおよびコンポーネント・タイプ(ドロップダウン・リストやチェック・ボックスなど)によって、質問のコンテキストと何を選択できるかが視覚的にわかります。スキルの会話は従来のWebインタフェースとは異なるため、フォームベースのインタビューを会話では使用できない場合があります。ポイントを説明するために、1人が参加して連続して座り、1人がボットとして機能し、もう1人がインタビュー対象者として機能するようにします。フォームベースのインタビューを声に出して(すべてのラベルとプロンプトを読み取ります)、これが顧客がボットとやりたいと思う会話かどうか自問します。

Webページ専用に設計されたインタビューを再利用するのではなく、より会話らしいバリエーションを設計することを検討してください。真の単一ソースと同じポリシー・モデルを使用したい場合には、Oracle Intelligent Advisorの包含機能を使用して、そのポリシー・モデルに対して追加のインタビューを作成します。インテリジェント・アドバイザ・ドキュメント・ライブラリの包含を参照してください。または、独自の属性を使用することを除き、Intelligent Advisorドキュメント・ライブラリの様々なユーザー・タイプのマルチチャネル・インタビューのカスタマイズで説明されているステップと同様に、インタビューがスキルで行われ、それに応じてアーティファクトを非表示または表示するようにインタビューにシード・データを渡すことを検討してください。属性値と接続パラメータの引渡しを参照してください。

次に例を示します。次のインタビューでは、一連のイメージ・トグルが示されます。Webページでは、ユーザーは該当するイメージをクリックできます。

インタビューがスキル内で実施されるとき、各イメージを提示して、その標識が存在するかどうかをユーザーに尋ねます。次の例に示すように、ユーザーは標識ごとに「はい」または「いいえ」を回答する必要があります。

このインタビューのルールでは標識が存在するかどうかのみが考慮されるため、すべての標識を含む1つのイメージを表示して、「これらの標識のどれかがありますか」という1つの質問だけを尋ねるように、スキルに対してインタビューを最適化することができます。ルールの変更に必要なのは、次のようにthere is any sign presentの条件を追加するだけです。

dangerous goods need to be handled if  
  there is a combustibles sign present or
  there is an explosives sign present or
  there is a flammable gas sign present or
  there is an inhalation sign present or
  there is a nonflammable sign present or
  there is an oxygen sign present or
  there is a flammable solid sign present or
  there is any sign present

また、導入用のテキストはこのスキル会話の動作に当てはまらないため、変更するか表示されないようにする必要があります。

スキルから匿名インタビューにアクセスする前に、デジタル・アシスタント管理者に依頼してインスタンスにインテリジェント・アドバイザ・サービスを追加し、ハブ・マネージャに依頼してインテリジェント・アドバイザ・ハブにインタビューをデプロイしてチャット・サービス用にアクティブ化します。これらのタスクが完了したら、インテリジェント・アドバイザ・コンポーネントをダイアログ・フローに追加して、スキルからインタビューにアクセスできます。

ヒント:

「インテリジェント・アドバイザ」サービス・ページからスキルをすばやく作成できます。をクリックしてサイド・メニューを開き、「設定」、「追加サービス」、「インテリジェント・アドバイザ」タブ、「+新規スキル」の順にクリックします。スキルに表示名を付け、ドロップダウンからデプロイメントを選択します。

次のステップでは、ビジュアル・ダイアログ・モード用に作成されたスキルでのコンポーネントの使用を順を追って説明します。

1. スキルで、「エンティティ」をクリックして「エンティティ」ページを表示し、「DATE」エンティティを選択します。

2. 「エンド・ユーザー・ロケールの考慮」を「オン」に切り替え、「次として解決する日付」ドロップダウンから「直近」を選択します。

   インタビューでは、これらの設定を使用して入力日付書式を決定し、「時間と日付の一致の曖昧性解決ルール」および「ロケールベースの日付解決」の説明に従って、あいまいな日付を解釈します。

3. CURRENCYおよびNUMBERエンティティの「エンド・ユーザー・ロケールの検討」が「オン」に切り替わっていることを確認します。

4. 「フロー」をクリックし、インテリジェント・アドバイザ・コンポーネントの挿入先となるフローを選択します。

5. 新しいコンポーネントを挿入する2つのコンポーネントを接続する線の上にマウスを置き、次をクリックします。
   
   
   
   .
6. 「状態の追加」ダイアログの「検索」フィールドにintellと入力し、表示されるインテリジェント・アドバイザ・コンポーネントを選択します。
7. 「名前」フィールドと「説明」フィールドに入力し、「挿入」をクリックします。

8. 新しく追加されたコンポーネントのプロパティ・インスペクタで、コンポーネントの「インテリジェント・アドバイザ・サービス名」プロパティを、「設定」>「追加サービス」>「インテリジェント・アドバイザ」ページに追加されたサービスの名前に設定します。

9. 「デプロイメント・プロジェクト名」を、インテリジェント・アドバイザ・ハブにデプロイされた匿名インタビューの名前に設定します。

   ヒント:

   名前の正確なスペルが不明な場合は、「追加サービス」に移動し、「インテリジェント・アドバイザ」をクリックしてハブのサービスを選択し、「デプロイメント」をクリックしてデプロイメント名のリストを表示します。

10. コンポーネントでスクリーン・タイトルを非表示にする場合は、「すべてのスクリーン・タイトルの非表示」をtrueに設定します。デフォルトでは、インタビューには画面タイトルが表示されます。

11. デフォルトでは、インタビューに説明は表示されません。「説明の表示」プロパティをalwaysに設定して説明を毎回表示するか、askに設定して説明を表示するかどうかを選択できます。

12. インタビューの属性の値をスキルがすでに取得している場合は、「データのシード」プロパティを使用して値を渡すことができます。それ以外の場合は、プロパティを削除します。

    シード・データを渡す方法およびインタビューでデータを使用する方法については、属性値と接続パラメータの受渡しを参照してください。

13. デフォルトでは、スキルはインタビューのHTMLおよびCSSマークアップを出力します。インタビューにHTMLおよびCSSマークアップが含まれ、不要な空白行が会話に含まれる原因となる場合は、「出力からのHTMLタグの削除」をtrueに設定することを検討してください。

14. インタビューで特定の通貨が想定される場合は、「予想通貨のインタビュー」を予想通貨のISO-4217コードに設定します。コードが指定されている場合、ユーザーはその通貨に対して許可されているフォーマットでのみ通貨値を入力できます。

15. インテリジェント・アドバイザの統合に問題がある場合にスローされるエラーを処理するための状態を追加します。
    • プロパティ・インセクターで、「トランジション」タブを選択します。
    • 新しいアクションを作成し、errorという名前を付けます。
    • 「遷移先」フィールドで、「状態の追加」を選択します。
    • 「メッセージの送信」テンプレートまたは「ユーザー・メッセージング」テンプレートのいずれかを選択し、「名前」および「説明」を入力して、「挿入」をクリックします。

      インテリジェント・アドバイザ・コンポーネントに接続するエラー遷移を使用して、新しいコンポーネントをフロー・ダイアグラムに挿入する必要があります

    • 新しく挿入したコンポーネントを選択し、エラーなどの場合にユーザーに表示するテキストを挿入して入力します。

      We are having a problem with a connection. Can you please send email to contact@example.com to let them know that the loan advisor isn't working? Thank you.
16. (オプション)ラベルおよび標準メッセージに対してコンポーネントで使用される文字列を微調整します。インテリジェント・アドバイザのリソース・バンドル・エントリを参照してください。

17. スキルにテキストのみのチャネルからアクセスできる場合は、スキルの「タスク・フローのポストバック・アクションでの自動採番の有効化」構成設定がtrueに設定されているか、テキストのみのチャネルの場合はtrueに解決される式(次の式など)に設定されていることを確認します:

    ${(system.channelType=='twilio'||system.channelType=='osvc' )?then('true','false')}

    これにより、ユーザーはオプションの全文ではなく数字を入力するだけでオプションを選択できます。

    この設定にアクセスするには、スキルの左側のナビゲーションで
    
    を選択し、「構成」タブを選択します。

18. (オプション)「プレビュー」をクリックし、スキルにアクセスできるすべてのチャネルでインタビューをテストします。

各コンポーネント・プロパティの詳細は、インテリジェント・アドバイザ・プロパティを参照してください。

コンポーネントのYAMLバージョンの各プロパティとその使用例の詳細は、System.IntelligentAdvisorを参照してください。

インタビューの属性の値をスキルがすでに取得している場合は、インテリジェント・アドバイザ・コンポーネントの「データのシード」プロパティを使用して、インタビューに値を渡すことができます。インタビューにWebサービス・コネクタのパラメータが必要な場合は、「接続パラメータ」プロパティを使用して値を渡すことができます。

「シード・データ」プロパティを使用して、「URLパラメータからのシード」オプションが有効になっているインタビュー属性の値を渡すキーと値のペアを定義します。このオプションは、Oracle Policy Modelingの「属性の編集」ダイアログにあります。

インタビューは、「シード・データ」値を使用して、デフォルト値として表示されるデフォルト値を設定します。

シード・データが指定されている場合、インタビューで画面またはステップをスキップする場合は、ポリシー・モデリングで次のステップに従います。

1. シード・データが提供されたかどうかを判断するルールを追加します。

   • ブール属性の場合は、次のルールを使用します。

     The <screen name> screen should be shown if
           <attribute name> is uncertain or
           <attribute name> is currently unknown

   • 非ブール属性の場合は、次のルールを使用します。

     The <screen name> screen should be shown if
           <attribute name> is currently unknown

2. 「インタビュー」タブで、画面を選択し、「次の場合に画面を表示」をクリックして、「次の場合に表示」ドロップダウン・リストからルールを選択します。

   
   
   図ia-show-screen-if.pngの説明
   

   画面に複数の質問があり、質問のみを非表示にする場合は、「次の場合に画面を表示」ボタンを使用するかわりに質問を選択し、「必須」をクリックして、「次の場合に表示」ドロップダウン・リストからルールを選択します。

シード・データおよびインタビューでのシード・データの使用方法の詳細は、インテリジェント・アドバイザ・ドキュメント・ライブラリの次の記事を参照してください:

アプリケーション・データへのデータ・マッピングを含むWebサービス・コネクタをインタビューで使用する場合は、「接続パラメータ」プロパティを使用して、コネクタにデータを渡すためのキーと値のペアを定義します。

パラメータについて学習するには、Intelligent Advisorドキュメント・ライブラリのデータ統合を参照してください。

インタビュー中に設定された名前付き属性の値にアクセスする必要がある場合は、「インタビュー結果の変数」プロパティを使用してリスト変数の名前を渡すことができます。名前付き属性値は、その変数にキーと値のペアの配列として格納されます。

ユーザーが完了前にインタビューを終了すると、「インタビュー結果の変数」によって指定された変数は作成されません。