デジタル・アシスタント開発は、そのために設計したペルソナに関するものです。ペルソナは、言語、音声のトーンおよびデジタル・アシスタントの態度を定義します。

設計したペルソナをデジタル・アシスタントが受け入れるようにするには、サポートする言語ごとにボットの送信メッセージを管理する必要があります。リソース・バンドルは、ボット・メッセージを管理する1つの場所を表すため、音声のトーンで一貫性を簡単に確保できます。第2言語をサポートするデジタル・アシスタントを構築する場合、ボット・メッセージを表示するためのリソース・バンドルに代わる現実的な方法はありません。

リソース・バンドル文字列は、Oracle Digital Assistantのスキルおよびデジタル・アシスタントで宣言的に作成されます。Apache FreeMarker式を使用して、会話、エンティティおよびスキル構成設定から参照します。メッセージ文字列を参照するには、次のような式を使用します。

${rb('message_key')}

rbは、リソース・バンドル定義を参照し、指定された名前のメッセージ識別子を検索します。上の例では、message_keyという名前のメッセージ・キーを検索します。

リソース・バンドル・キー名がユーザーの言語に存在しない場合は、デフォルト言語(基本言語)に定義された文字列が使用されます。デフォルト言語のメッセージ文字列がない場合、実行時テスト中に例外がスローされます。

リソース・バンドルを介して出力されるメッセージにデータを渡す必要がある場合は、位置パラメータおよび名前付きパラメータを使用してこれを実行できます。

位置パラメータ: Hello {0}, {1}

名前付きパラメータ: Hello {name}, {greeting}

変数から読み取った値を会話に追加するには、次に示すような式を使用します。

位置パラメータの場合: ${rb('message_key',firstname.value, greetingMessage.value)}

名前付きパラメータの場合: ${rb('message_key','name,greeting',firstname.value, greetingMessage.value)}

位置パラメータは使いやすく見えますが、メッセージに追加されるデータのタイプのコンテキストを提供するため、可能な場合は名前付きパラメータを使用することをお薦めします。文脈を知ることは翻訳者の生活を楽にする。

スキルでリソース・バンドルを包括的に使用することは、エンティティ、ダイアログ・フロー、およびスキルおよびデジタル・アシスタント設定からリソース・バンドルを参照することを意味します。リソース・バンドル文字列参照をスキルおよびデジタル・アシスタントで見つけやすくするために、ネーミング規則を実装して、リソース・バンドル・キー名にコンテキストを追加することをお薦めします。

たとえば、値リスト・エンティティのエラー・メッセージ、あいまい性解消メッセージおよびプロンプトに次の名前を使用できます。

• list.<entity_name>.errorMessage

• list.<entity_name>.disambiguationMessage

• list.<entity_name>.prompt1

• list.<entity_name>.prompt2

コンポジット・バッグ・エンティティの場合、同様のネーミング構造を使用できますが、バッグ・アイテムの名前をそれに追加します。

• cbe.<entity_name>.<bag_item_name>.errorMessage

• cbe.<entity_name>.<bag_item_name>.disambiguationMessage

• cbe.<entity_name>.<bag_item_name>.prompt1

• cbe.<entity_name>.<bag_item_name>.prompt2

ダイアログ・フロー状態のプロンプトからリソース・バンドル文字列を参照する場合、またはダイアログ・フロー状態によってユーザー・メッセージが出力されるのみの場合は、次のものを使用できます。

• <dialog_flow_state_name>.prompt

• <dialog_flow_state_name>.message

共通レスポンス・コンポーネントのページ区切りやヘルプ・ボタンなどのグローバル・アイテムでは、特定のダイアログ・フロー状態の名前を含まないネーミング規則を使用できます。

• button.next

• button.previous

• button.cancel

• button.help

前述の例のようにドット表記法を使用するか、アンダースコアを使用するか、独自の表記法を使用するかについては、厳密なルールはありません。

共通レスポンス・コンポーネントでは、アクション・アイテムのキーワードを定義できるため、ユーザーはキーワードをメッセージとして送信することでキーワードを「事実上押す」ことができます。キーワードは、ユーザー・インタフェースでユーザーがボタンを押すことができない(テキストのみのチャネルや音声を使用する場合など)場合に特に重要です。

優しいが明らかなリマインダとして、ドイツ語、ポルトガル語、フランス語、アラビア語、およびボットでサポートしている他のすべての言語で「送信」とは呼ばれません。そのため、共通レスポンス・コンポーネントのアクション・アイテムのkeywordプロパティは、リソース・バンドル・キーから読み取ることができます。リソース・バンドル・メッセージは、使用するキーワードのカンマ区切りリストになります。

このリソース・バンドル・メッセージの例では、リソース・バンドル・キー名の参照時にregionの引数が渡されることを想定しています。この例では、異なる方法で処理される値は、region1およびregion2として定義されています。これらの値は、国コードなど、必要に応じて設定できます。

{region, select,
  region1 {message for region 1}
  region2 {message for region 2}
  other {message for all other regions}
}

いずれかのリージョンのリソース・バンドル内のメッセージを参照するには、ダイアログ・フロー、エンティティまたはスキル構成で次の式を使用します:

${rb('the_key_name','region','<VARIABLE_CONTAINING_REGION_VALUE>.value')}

<VARIABLE_CONTAINING_REGION_VALUE>は、異なるメッセージが定義されている値を保持するスキルの変数名に置き換える必要があります。