「ユーザー・メッセージング」カテゴリのテンプレートの大部分は、共通レスポンス・コンポーネントに基づいています。このコンポーネントでは、コンポーネント・プロパティおよびメタデータを使用して、テキスト、アクション・ボタン、イメージおよびカードを含む特殊なユーザー・インタフェースを作成できます。

「マルチメディア・メッセージの表示」サブカテゴリのテンプレートなど、多くの場合は、共通レスポンス・コンポーネントの「メタデータ」プロパティに主な違いがあります。

その他の場合(「表およびフォームの表示」サブカテゴリなど)、テンプレートは、変数の設定コンポーネントに先行する共通レスポンス・コンポーネントで構成されます。

「チャネル固有の機能」サブカテゴリには、SlackおよびMicrosoft Teamsチャネルで使用可能な拡張機能の使用例があります。

ユーザー・フィードバック・コンポーネントを使用すると、トランザクション・フローの完了後に評価スケールをユーザーに提示することで、インサイトのフィードバック・データを収集できます。ユーザー・フィードバック・コンポーネントでは順不同の入力が許可されていないため、ユーザーは自分の評点を変更できません。21.10 SDK以降を使用している場合、このコンポーネントは水平星評価システムを出力します。

このコンポーネントの動作はコンポーネント・プロパティを使用して変更できますが、SDK (バージョン21.10以降)を使用するときにルック・アンド・フィールを変更できます。たとえば、フィードバック・ボタンに使用されるデフォルトの星アイコンを別のアイコンに置き換えることができます。

このコンポーネントは、次のアクションを返すことができます:

遷移状態によって出力されるメッセージには、次のシステム変数を使用できます。

• system.userFeedbackRating– ユーザーの評価を返します。
• system.userFeedbackText– enableTextFeedbackがtrueに設定されている場合、評価がthreshold値を下回ったときにスキルがフィードバックを要求できます。system.userFeedbackTextはユーザーの入力(${system.userFeedbackText.value})を返します。

コンポーネントの標準表示テキストは、リソース・バンドル・エントリに格納されます。これらのバンドル・エントリにはデフォルトのテキストがありますが、カスタマイズできます。このコンポーネントのエントリは次のとおりです。

変数間で値をコピーします。

これらのプロパティの定義は、相互にミラー化する必要はありません。宛先変数とソース変数の両方を変数のリストとして定義できますが、ソース変数を単一の変数で定義し、宛先をリストとして定義することもできます。追加の宛先変数を設定すると、指定した続行ソース値の変数値が継承されます。

このコンポーネントは、指定された変数の値をnullにリセットします。

変数の設定コンポーネントは、事前定義済の変数の値を設定します。

言語の検出コンポーネントは、翻訳サービスを使用して、ユーザー入力からユーザーの言語を検出します。

このコンポーネントは、ロケール文字列を使用してprofile.languageTagという名前の変数を設定します。この変数を値式(${profile.languageTag})で使用すると、現在の言語で変数を設定できます。

このコンポーネントは、指定されたテキストをスキルの翻訳サービスに送信し、英語翻訳を格納します。これは、翻訳サービスで構成されているスキルに依存します。翻訳サービスは、ユーザーの入力から言語を認識し、英語に翻訳します。このコンポーネントは、ネイティブ・サポート言語モードを使用するスキルでは機能しません。

このコンポーネントは、生の入力テキストを翻訳する前に処理する必要がある場合に使用します。たとえば、翻訳サービスに送信する前に、ユーザー入力から個人データを削除できます。

このコンポーネントは、ユーザーの言語をすでに検出している翻訳サービスを利用するため、このコンポーネントは言語を検出または設定する状態に従う必要はありません。

出力の翻訳コンポーネントを使用すると、指定したテキストをユーザーの言語に翻訳できます。このコンポーネントは、「式」プロパティに対して定義された値を取得します。スキルの翻訳サービスを使用して、テキストを言語の検出コンポーネントまたはprofile.locale変数によって検出された言語に翻訳し、「変数」プロパティで指定された変数に格納します。

このコンポーネントは、ネイティブ・サポート言語モードを使用するスキルでは機能しません。

「エンティティの照合」コンポーネントは、「ソース変数」プロパティに保持されているテキストからエンティティ情報を抽出するためにインテント・エンジンを呼び出します。変数のエンティティ・タイプに一致が存在する場合、「変数」プロパティで指定された変数にこのエンティティ値が設定されます。

このコンポーネントには、matchおよびnomatchという2つの事前定義済の遷移もあります。

このコンポーネントを使用して、LinkedIn、Twitter、Google、Microsoftなど、認可コード権限付与フローによって保護されているサービスの認可コードを取得します。スキルのカスタム・コンポーネントは、認可コードをアクセス・トークンと交換でき、これを使用して終了サービスを起動します。

最初に、コンポーネントによってアイデンティティ・プロバイダのログイン・ページがユーザーに表示されます。ログインの成功後、コンポーネントによって認可コードが変数で返され、それを使用して認可コードをカスタム・コンポーネントに渡します。カスタム・コンポーネントAPIは、OAuthユーザー・アクセス・トークンの認可コード、クライアントIDおよびクライアント・シークレットを交換する必要があります。

認可を起動する前に必要な状態ごとに、その「認可が必要」設定をTrueに設定します。これを設定する手順については、User Authorizationを参照してください。

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

このコンポーネントは、次のアクションを返すことができます:

コンポーネントの標準表示テキストは、リソース・バンドル・エントリに格納されます。これらのバンドル・エントリにはデフォルトのテキストがありますが、カスタマイズできます。このコンポーネントのエントリは次のとおりです。

リソース・バンドル・エントリのデフォルト・メッセージを変更するステップは、リソース・バンドル・エントリの変更を参照してください。

ダイアログ・エンジンがこのコンポーネントを検出すると、スキル・ボットが2つのリンク(LoginとCancel)を使用してユーザーに入力を求めます。

図fb-oauth.pngの説明

このコンポーネントから遷移する方法はいくつかあります:

• ユーザーが取消しボタンをクリックすると、コンポーネントはfailアクションによって指定された状態に遷移します。

• ユーザーはボタンをクリックしませんが、かわりにテキストを入力します。コンポーネントはtextReceivedアクションによって指定された状態に遷移します。

• ユーザーがログイン・リンクをクリックすると、次の例に示すように、チャネルによってアイデンティティ・プロバイダのログイン・ページまたは認証ダイアログがWebビューとしてレンダリングされます。認可が成功すると、コンポーネントはpassアクションによって指定された状態(または、passアクションがない場合は次の状態)に遷移します。これは通常、認可コードをアクセス・トークンと交換するカスタム・コンポーネントをコールします。

図webview-login.pngの説明

テスト・ウィンドウでWebビューがレンダリングされない場合は、リンク・テキストを切り取ってブラウザに貼り付けてください。

このコンポーネントを使用して、OCI IAM、Oracle Access Manager (OAM)、Microsoft IDプラットフォームまたはGoogle OAuth 2.0認可によって保護されているリソース用のOAuth2ユーザー・アクセス・トークン(権限付与タイプが認可コード)を取得します。このコンポーネントは、3-legged OAuth2フローのすべてのステップを完了し、OAuth2アクセス・トークンを返します。

認可を起動する前に必要な状態ごとに、その「認可が必要」設定をTrueに設定します。これを設定する手順については、User Authorizationを参照してください。

クライアント・リソースにアクセスするために権限付与タイプがクライアント資格証明のアクセス・トークンを取得する必要がある場合は、OAuth 2.0クライアントを参照してください。

このコンポーネントをスキルで使用する前に、次のタスクを実行する必要があります:

1. まだ登録されていない場合は、アイデンティティ・プロバイダ登録の説明に従って、クライアントをアイデンティティ・プロバイダに登録します。
2. 認証サービスの説明に従って、アイデンティティ・プロバイダの認証サービスを追加します。

一部のアイデンティティ・プロバイダは、リフレッシュ・トークンを発行します。このコンポーネントを使用すると、デジタル・アシスタントにより、認証サービスに対して指定されている保持期間の間、リフレッシュ・トークンが格納されます。デジタル・アシスタント・バックエンドはリフレッシュ・トークンを使用して(使用可能な場合)、ユーザーが再度サインインしなくても新しいアクセス・トークンを取得できます。

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

このコンポーネントは、次のアクションを返すことができます:

コンポーネントの標準表示テキストは、リソース・バンドル・エントリに格納されます。これらのバンドル・エントリにはデフォルトのテキストがありますが、カスタマイズできます。このコンポーネントのエントリは次のとおりです。

リソース・バンドル・エントリのデフォルト・メッセージを変更するステップは、リソース・バンドル・エントリの変更を参照してください。

ダイアログ・エンジンがコンポーネントを検出すると、スキル・ボットによって「アクセス・トークンの取得」と「取消」という2つのリンクがユーザーに表示されます(linkLabelとcancelLabelを使用してリンク・テキストを変更できます)。

アクセス・トークンを取得するリンクをユーザーがクリックした場合は、認証サービスで指定されたアイデンティティ・プロバイダのログイン・ページまたは認証ダイアログを表示します。ログインが成功すると、アクセス・トークンを取得し、accessTokenVariableNameおよびauthenticatedUserVariableNameで指定された変数の値を設定し、passアクションによって指定された状態(またはpassアクションがない場合は次の状態)に移行します。ユーザーが取り消した場合、ポストバック・アクションはfailに設定されます。ユーザーがテキストを入力した場合、textReceivedアクションを返します。

前述のように、状態にrequiresAuthorizationを設定すると、ユーザーが認可されてから状態のコンポーネントを起動するようになります。ユーザーがまだ認可されていない場合は、ダイアログによって「ユーザーの認可」イベントが起動されます。

このコンポーネントを使用して、権限付与タイプがクライアント資格証明のOAuth2アクセス・トークンを取得します。つまり、これを使用して、ユーザーの名前やパスワードではなく、クライアントの資格証明に基づいたアクセス・トークンを取得します。このコンポーネントを使用して、Oracle Identity Cloud ServiceまたはOracle Access Manager (OAM)によって保護されているクライアント・リソースへのアクセスを可能にするトークンを取得できます。

ユーザーのかわりにリソースにアクセスする必要がある場合は、OAuth 2.0アカウント・リンクおよびOAuthアカウント・リンクを参照してください。

このコンポーネントをスキルで使用する前に、次のタスクを実行する必要があります:

1. まだ登録されていない場合は、アイデンティティ・プロバイダ登録の説明に従って、クライアントをアイデンティティ・プロバイダに登録します。
2. 認証サービスの説明に従って、アイデンティティ・プロバイダのクライアント資格証明認証サービスを追加します。

このコンポーネントにはアクションはありません。発生する可能性のあるシステムの問題に対処するには、そのようなエラーを処理できる状態に移行する次の遷移を追加します。

このコンポーネントを使用して、認証サービスが示すアイデンティティ・プロバイダから、ログイン・ユーザーのすべてのリフレッシュ・トークンおよびユーザー・アクセス・トークンを取り消します。また、リフレッシュ・トークンをデータベースから削除します。このコンポーネントを使用するには、認証サービスUIでアイデンティティ・プロバイダのリフレッシュ・トークンの取消URLを指定する必要があります。

スキルには、同じ認証サービスのOAuth 2.0アカウント・リンク・コンポーネントを使用する状態が含まれている必要があり、このコンポーネントを使用する状態の前に呼び出す必要があります。

このコンポーネントは、次のアクションを返すことができます:

このコンポーネントを使用して、変数値に基づいて状態を切り替えます。

このコンポーネントは、変数または式を解決し、フロー内の状態にマップされる対応する遷移アクションをトリガーすることによって、実行パスを決定します。

遷移アクションは、プロパティ・インスペクタの「遷移」タブで定義およびマップします。

このコンポーネントでは、現在のフローから子フローをコールし、オプションで入力パラメータを渡します。子フローが完了すると、アクションおよびオプションの出力パラメータが親フローに返されます。

設定できる遷移アクションは、子フローの「終了フロー」コンポーネントで設定されるアクションによって異なります。

このコンポーネントでは、別のスキルのフローをコールし、オプションで入力パラメータを渡します。コールされたフローが完了すると、コール・フローにアクションおよびオプションの出力パラメータが返されます。

このコンポーネントを使用する前に、コールするスキルでパブリック・フローが使用可能である必要があります。フローからの別のスキルの起動を参照してください。

ParamName: ParamValue

このコンポーネントは、フローを明示的に終了するために使用されます。

この状態に達すると、フローのすべての変数がクリアされ、制御が親フローに戻されます(または、親フローがない場合はメイン・フロー)。

フローから親フローまたはメイン・フローにパラメータまたはアクションを戻す必要がない場合は、フローの終了フロー状態は必要ありません。

このテンプレートは、エージェント開始コンポーネントとエージェント会話コンポーネントで構成されます。これらのコンポーネントを一緒に使用して、スキルの会話をOracle B2C Serviceエージェントに転送します。

• エージェント開始コンポーネントは、コンポーネントの「エージェント統合チャネル」プロパティで指定されたエージェント統合チャネルを使用してハンドシェイクを開始します。
• エージェントの会話コンポーネントは、スキルとライブ・エージェントの間のやり取りを管理します。

このテンプレートは、スキルで発生した会話用です。デジタル・アシスタント(エージェント)のフレームワークの動作の説明に従って、このテンプレートをOracle B2C Serviceチャットで発生した会話に使用しないでください。

DA (エージェント)デジタル・アシスタントでエージェント転送コンポーネントを使用して、会話をチャット・サービスに戻します。会話は、チャット・サービスで構成されているチャット・ルールによってライブ・エージェントにルーティングされます。

このコンポーネントは、デジタル・アシスタント(エージェント)のフレームワークの動作で説明されているように、サービスのチャットで発生した会話用です。スキルで発生した会話の場合は、かわりにエージェント通信テンプレートを使用します。

DA-as-agentデジタル・アシスタントのエージェント転送条件コンポーネントを使用して、エージェントが使用可能かどうか、および可能であれば予想される待機時間を判断できます。

コンポーネントのプロパティを使用して転送条件を指定し、条件が満たされたかどうかを示すアクションを返します。さらに、名前付きマップ変数の値を設定します。

エージェント可用性ステータス変数の値とその中に格納される情報の構造を次に示します:

queueId (integer, optional): The engagement queue ID,
expectedTotalWaitSeconds (integer, optional): Expected wait time in the queue in seconds
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitSeconds (integer, optional): The number representing the "ss" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitMinutes (integer, optional): The number representing the "mm" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
availableAgentSessions (integer, optional): Total number of sessions available across all agents.,
totalAvailableAgents (integer, optional): Total number of agents whose status is available.,
totalUnavailableAgents (integer, optional): Total number of agents whose status is unavailable.,
totalAgentsRequestingNewEngagement (integer, optional): Total number of agents who are available and have capacity.
outsideOperatingHours (boolean, optional): True if outside operating hours. False if inside operating hours.,
engagementsInQueue (integer, optional): The number of engagements currently in the queue.
sessionId (string, optional): The session ID.,
clientId (integer, optional): The client ID.

This might take {minutes, plural,
     =-1 {}
     =0 {}
     =1 {1 minute and }
     other {# minutes and }
}{seconds, plural,
     =-1 {a while}
     =0 {{minutes, plural,
          =0 {a short wait time}
          other {0 seconds}
        }}
     =1 {1 second}
     other {# seconds}
} to connect. Are you willing to wait?

このコンポーネントを使用して、APIサービス設定で構成したRESTエンドポイントにHTTPリクエストを送信します。

コンポーネント・プロパティは次のとおりです。

コンポーネントは次のアクションを返します。

さらに学習するには、RESTサービス・コンポーネントを使用したバックエンドへのアクセスを参照してください。

このコンポーネントを使用して、Oracle B2C Service Knowledge FoundationまたはOracle Fusion Service Knowledge Managementで特定の検索語に関する情報を検索し、結果を表示します。

Oracle B2C Serviceの場合、検索結果は、回答が公開されているかどうか、およびアクセス・レベル、製品、カテゴリの設定によって異なります。

このコンポーネントを使用するには、ナレッジ検索サービスを作成する必要があることに注意してください。ナレッジ検索サービスの追加を参照してください。

ナレッジ検索コンポーネントのプロパティは次のとおりです。

カスタマ・サービス・サイトでインシデント・レポートを作成するには、インシデント作成テンプレートを使用します。インスタンスでこのコンポーネントを使用するには、「設定」→「追加サービス」→「カスタマ・サービス統合」ページからカスタマ・サービス統合を作成する必要があります。

このコンポーネントを使用して、スキルからOracle Intelligent Advisorインタビューにアクセスします。

このコンポーネントを使用する前に、インテリジェント・アドバイザ・サービス統合を作成する必要があります。インテリジェント・アドバイザ・サービスの追加を参照してください。また、インタビューがインテリジェント・アドバイザ・ハブにデプロイされ、チャット・サービス・チャネルでアクティブ化されている必要があります。インタビューは匿名ユーザー向けである必要があります。ポータル・ユーザーまたはエージェント・ユーザーのインタビューにはアクセスできません。

コンポーネントのプロパティを使用して、次のインタビュー設定を指定できます:

• タイトルと説明を表示するかどうか
• 肯定、否定、不確実のボタンのラベル
• リセット、前の質問に戻る(元に戻す)、インタビューの終了のために、ユーザーが入力する文字列
• インタビューの終了時に表示するテキスト
• 説明を表示するかどうかという質問を表現する方法
• ファイルのアップロードが完了したことを示すためにユーザーが入力する文字列
• インタビューに渡す属性値とコネクタ・パラメータ
• 使用するプロジェクトロケール

Webビュー・コンポーネントは、Webビューをスキル内で、またはWebチャネルで実行されるスキルの場合はブラウザ・タブで開きます。

このコンポーネントを使用して、Oracle Digital Assistantに登録されているタイプのクラウドベースのイベントが発生したときにユーザーに通知を送信します。イベント・タイプの登録およびイベントを使用するためのデジタル・アシスタントの構成の詳細は、外部イベントを参照してください。

このコンポーネントを使用して、Oracle Digital Assistantに登録されているタイプのクラウドベースのイベントを外部に公開します。イベント・タイプの登録およびイベントを公開および消費するためのデジタル・アシスタントの構成の詳細は、「外部イベント」を参照してください。

データ・プロパティの値として使用できるペイロードの例を次に示します:

{
    "size": "Large",
    "type": "Veggie"
}

        "system.postbackActions": {
          "small": {
            "postback": {
              "variables": {
                "size": "Small"
              },
              "system.botId": "44F2405C-F317-4A3F-8250-617F54F01EA6",
              "action": "Small",
              "system.state": "size"

この時点で、受信ポストバック・アクションのペイロードのsystem.stateプロパティが現在の状態と比較されます。2つが一致しなくなっている場合、スキルはダイアログ・フローの構成に応じて、ユーザーのリクエストを受け入れるか拒否できる遷移を実行します。

順序外メッセージ・システム遷移イベントを、順序外メッセージを処理するために指定したフローをコールする呼出しフロー・コンポーネントにマップすることで、順序外メッセージ処理のデフォルト動作を変更できます。