次に、ネイティブ・サポート言語モードでデジタル・アシスタントを設定する最初のステップを示します:

1. をクリックしてサイド・メニューを開き、「開発」→「デジタル・アシスタント」を選択して、「新規デジタル・アシスタント」をクリックします。

2. 次のフィールドに特に注意して、ダイアログの指定を完了します:
   • プラットフォーム・バージョン: プラットフォーム・バージョンは、自然言語理解(NLU)エンジンによるインテントの解決方法やネイティブでサポートされる言語など、デジタル・アシスタントの動作に影響します。

     ネイティブ・サポート言語モードの場合は、20.12以降に設定する必要があります。

     プラットフォーム・バージョンを参照してください。

   • プライマリ言語: これにより、デジタル・アシスタントのデフォルト言語と、デジタル・アシスタントがその言語のネイティブ・サポートを使用するか、翻訳サービスを利用するかの両方が決まります。

     このフィールドでは、ドロップダウンの「ネイティブ・サポート」セクションで言語を1つ選択する必要があります。

3. デジタル・アシスタントに言語を追加する必要がある場合:
   1. 新しく作成したデジタル・アシスタントの左側のナビゲーションで、をクリックします。
   2. 「言語の追加」をクリックし、追加する言語を選択します。

Oracle Digital Assistantのネイティブ言語サポートに基づくデジタル・アシスタントでは、デジタル・アシスタント用に構成する言語が、スキル用に構成する言語と一致する必要があります。

スキルとデジタル・アシスタントに対して構成された言語が一致しているかどうかをモニターするために、言語またはスキルをデジタル・アシスタントに追加するたびにチェックが実行され、各言語が「完了」または「進行中」としてマークされます:

• 完了した言語とは、その言語に対してデジタル・アシスタントの各スキルが構成されている言語です。
• 進行中の言語とは、1つ以上のスキルが構成されていない言語です。

完了した言語および進行中の言語のリストは、デジタル・アシスタントの「設定」ページ()の「一般」タブにあります。

翻訳サービスの使用がすでに構成されたデジタル・アシスタントでOracle Digital Assistantネイティブ言語サポートを利用する場合は、次の一般的なステップに従います:

1. デジタル・アシスタントのすべてのスキルについて、ネイティブ言語サポートを使用するバージョンを作成します。

   ネイティブ・サポート言語を使用するスキルの作成を参照してください。

   ネイティブ・サポート言語のリストは、ネイティブ・サポート言語を参照してください。(サポートしようとする言語がそのリストにない場合は、引き続き翻訳サービス・モードを使用する必要があります。)

2. デジタル・アシスタントの新規バージョンまたはクローンを作成します。

   1. をクリックしてサイド・メニューを開き、「開発」→「デジタル・アシスタント」を選択します。

   2. バージョンまたはクローンを作成するデジタル・アシスタントのタイルで、をクリックして「バージョン」または「クローン」を選択します。

   3. 必須フィールドに入力し、「作成」をクリックします。

3. 作成された新しいバージョンまたはクローンから、すべてのスキルを削除します。

   デジタル・アシスタントに翻訳サービス・モードのスキルが含まれている場合は、ネイティブ言語サポートを使用するようにデジタル・アシスタントを切り替えることができないため、これは必須です。

4. そのように変更したデジタル・アシスタントの新しいバージョンまたはクローンを作成し、プラットフォーム・バージョン20.12以降を選択し、「ネイティブ・サポート」言語モードを選択します。

   このステップにより、スキルを個別に処理する必要がある場合でも、デジタル・アシスタントに対して行った構成を保持できます。

5. ネイティブ言語サポート・バージョンのスキルをデジタル・アシスタントに追加します。

複数のネイティブ・サポート言語を使用するデジタル・アシスタント(またはスタンドアロン・スキル)では、デジタル・アシスタントはセッションの開始時にユーザーの言語を自動的に検出できます。この仕組みは次のとおりです:

• 複数のネイティブ・サポート言語を使用するように構成されているデジタル・アシスタントおよびスキルでは、言語が自動的に検出されます。
  • デジタル・アシスタントに(ネイティブ・サポート)言語が1つしかない場合、言語検出はオフになります。
  • デジタル・アシスタントが翻訳サービスを使用する場合、デジタル・アシスタントではなく翻訳サービスが言語検出を処理します。
• profile.languageTagまたはprofile.locale変数が設定されたチャネルからデジタル・アシスタントがアクセスされている場合、言語は自動的に検出されません。
• 言語は会話の最初の発話で検出され、ユーザーが言語を切り替えてもセッション中には更新されません。
• デフォルトでは、チャネル・セッションは7日継続してから有効期限が切れます。

次に、翻訳サービス言語モードで英語以外の単一言語デジタル・アシスタントを設定する最初のステップを示します:

1. をクリックしてサイド・メニューを開き、「開発」→「デジタル・アシスタント」を選択して、「新規デジタル・アシスタント」をクリックします。

2. 次のフィールドに特に注意して、ダイアログの指定を完了します:
   • プラットフォーム・バージョン: プラットフォーム・バージョンは、自然言語理解(NLU)エンジンによるインテントの解決方法やネイティブでサポートされる言語など、デジタル・アシスタントの動作に影響します。

     新しいデジタル・アシスタントを使用して始める場合は、入手可能な最新バージョンを選択してください。そのバージョンがサポート期間が最も長くなるためです。

     プラットフォーム・バージョンを参照してください。

   • プライマリ言語: このフィールドが表示されるのは、プラットフォーム・バージョン20.12以降を選択した場合のみです。

     このフィールドでは、ドロップダウンの「翻訳サービス」セクションでターゲット言語を選択する必要があります。

     注意:

     必ず「翻訳サービス」セクションから選択してください。「ネイティブ・サポート」セクションから選択すると、デジタル・アシスタントがネイティブ・サポート・モードを使用するスキルしか受け入れられなくなります。

     このフィールドが表示されない場合は、デジタル・アシスタントに追加する最初のスキルの言語によってデジタル・アシスタントの言語が決まります。このケースでは、この言語はプライマリ言語ではなく、主言語と呼ばれます。

次に、翻訳サービス言語モードで複数言語デジタル・アシスタントを設定する最初のステップを示します:

1. をクリックしてサイド・メニューを開き、「開発」→「デジタル・アシスタント」を選択して、「新規デジタル・アシスタント」をクリックします。

2. 次のフィールドに特に注意して、ダイアログの指定を完了します:
   • プラットフォーム・バージョン: プラットフォーム・バージョンは、自然言語理解(NLU)エンジンによるインテントの解決方法やネイティブでサポートされる言語など、デジタル・アシスタントの動作に影響します。

     新しいデジタル・アシスタントを使用して始める場合は、入手可能な最新バージョンを選択してください。そのバージョンがサポート期間が最も長くなるためです。

     プラットフォーム・バージョンを参照してください。

   • プライマリ言語: このフィールドが表示されるのは、プラットフォーム・バージョン20.12以降を選択した場合のみです。

     このフィールドでは、ドロップダウンの「翻訳サービス」セクションで「英語」を選択する必要があります。

     注意:

     必ず「翻訳サービス」セクションから選択してください。「ネイティブ・サポート」セクションから選択すると、デジタル・アシスタントがネイティブ・サポート・モードを使用するスキルしか受け入れられなくなります。

     このフィールドが表示されない場合は、デジタル・アシスタントに追加する最初のスキルの言語によってデジタル・アシスタントの言語が決まります。このケースでは、この言語はプライマリ言語ではなく、主言語と呼ばれます。

1. まだ実行していない場合は、次の方法でデジタル・アシスタント・インスタンスに翻訳サービスを構成します:
   1. をクリックしてサイド・メニューを開き、「設定」→「翻訳サービス」を選択します。
   2. 「+サービス」をクリックします。
   3. 「翻訳サービス」ダイアログにMicrosoft TranslatorサービスのURLと認可トークンまたはGoogle Translation APIを入力します。
   URLおよびアクセス・トークンの取得方法については、Microsoft TranslatorおよびGoogle Translation APIのドキュメントを参照してください。

   ノート
   
   Google Translation APIを使用するには、APIキーを生成する必要があります。このキーは、GCP Console (「APIs & services」→「Credentials」)から作成します。詳細は、Google Cloud Platformのドキュメントを参照してください。
2. デジタル・アシスタントで次のように翻訳サービスを設定します:
   1. をクリックしてサイド・メニューを開き、「開発」→「デジタル・アシスタント」を選択して、デジタル・アシスタントを選択します。
   2. デジタル・アシスタントの左側のナビゲーション・バーで、「設定」()アイコンをクリックし、「一般」タブを選択します。
   3. 「翻訳サービス」ドロップダウンに移動し、翻訳サービスを選択します。

デフォルトでは、デジタル・アシスタントが翻訳サービスで設定されている場合、デジタル・アシスタントは言語の検出コンポーネントが設定されているスキルと同じ方法でユーザーの言語を検出します。

ただし、デジタル・アシスタントのスキルが、デジタル・アシスタントによって検出された言語を使用していることを確認する必要もあります。スキルがデジタル・アシスタントの一部である場合、デジタル・アシスタントはユーザー入力を英語に翻訳し、翻訳された英語テキストをスキルに渡します。したがって、デフォルトでは、スキルの「言語の検出」コンポーネントは英語を言語として検出し、ユーザーが英語以外のテキストを入力した場合でもprofile.LanguageTag変数を英語に設定します。

ビジュアル・モードで開発されたダイアログ・フローを使用してスキルでこの英語に切り替えられないようにするには、各スキルの「言語の検出」コンポーネントの「既存のプロファイル言語タグ」プロパティをTrueに設定する必要があります。

これにより、スキルでは、デジタル・アシスタントによって設定されるprofile.LanguageTag変数の値が受け入れられます。

YAMLベース・スキルでこの英語への切替えを防ぐには、各スキルでSystem.DetectLanguageコンポーネントに次のプロパティを追加する必要があります。

      useExistingProfileLanguageTag: true

useExistingProfileLanguageTagが設定されたYAMLベースのスキルのSystem.DetectLanguageコンポーネントの例を次に示します:

  detectLang:
    component: "System.DetectLanguage"
    properties:
      useExistingProfileLanguageTag: true
    transitions:
      ...

翻訳サービスを使用するデジタル・アシスタントのユーザー表示テキストには、次のいずれかの翻訳アプローチを使用できます:

• デジタル・アシスタント用に構成された翻訳サービスを使用します。

  このアプローチを使用する場合、英語の出力メッセージのみが必要です。その他の構成は不要です。構成した翻訳サービスは、出力メッセージをユーザーの言語に自動的に翻訳します。

• リソース・バンドルを使用して、出力メッセージを自分で翻訳します。
  ノート
  
  リソース・バンドル・キーへの参照がない出力メッセージの場合は、翻訳サービスがメッセージの翻訳に自動的に使用されます。

翻訳サービスを使用するデジタル・アシスタントでは、スキルの明示的な起動は、検出された言語と英語の両方でデジタル・アシスタントによって認識されます。

翻訳可能な文字列は、次の2つの場所にあります:

• デジタル・アシスタントの「スキル」()ページ。

  ここには主に、ユーザーがデジタル・アシスタントでヘルプを要求したとき、およびデジタル・アシスタントがユーザーを初めて迎えたときに表示されるヘルプ・カードに使用される文字列があります。

  スキルごとに、次を翻訳できます

  • 「1文の説明」、「説明」および「起動」の各フィールド。
  • 「発話例」。
• 「設定」 ()ページの「構成」タブ内の「会話パラメータ」セクション。プラットフォーム・バージョン21.04以降、これらの設定に対してリソース・バンドル・エントリが自動的に作成されます。

リソース・バンドル・キーを使用して、翻訳が必要な出力テキストを識別し、1つ以上の言語で値を提供します。プラットフォーム・バージョン21.04以降を使用するデジタル・アシスタントの場合、デジタル・アシスタントの構成設定に対してキーが自動的に生成されます。その他の文字列(およびプラットフォーム・バージョン21.02以前のデジタル・アシスタントの構成設定)の場合は、キーを手動で作成する必要があります。

デジタル・アシスタントでは、ユーザーを歓迎したり、含まれるスキルのヘルプ情報を表示するときに、デジタル・アシスタントの「スキル」ページの値を使用してウェルカム・カードおよびヘルプ・カードに移入します。これらのヘルプ・カードに表示される情報は、「スキル」ページのフィールドの一部を編集すると翻訳できます。

1. デジタル・アシスタントの左側のナビゲーションで、をクリックします
2. スキルを選択します。
3. 「1文の説明」、「説明」および「起動」の各フィールドを、次の形式のリソース・バンドルへの参照で更新します:

   ${rb.BundleKeyName}

   たとえば、ピザ・スキルの1行の説明のキーへの参照には、次を使用できます。

   ${rb.PizzaSkillShortDescription}

4. ページの「例」セクションで、例の上にカーソルを置き、「編集」アイコンをクリックして、前述のリソース・バンドル・キーへの参照でテキストを置き換えます。
5. スキルの他の発話例について、前のステップを繰り返します。
6. スキルごとに、前4つのステップを繰り返します。

デジタル・アシスタントには、様々なプロンプトおよびメッセージの表示に使用される構成プロパティが多数あります。

構成プロパティの出力を設定するには、リソース・バンドル変数およびメッセージ・キーを参照します。たとえば: ${rb('WhatType')}。ドット表記法を使用することもできます。例: ${rb.WhatType}

1. デジタル・アシスタントの左側のナビゲーション・バーで、「設定」()アイコンをクリックし、「構成」タブを選択します。

2. ページの「会話パラメータ」セクション内のプロパティについて、それぞれに定義したリソース・バンドル・キーへの参照を入力します。

   たとえば、「確認応答」プロパティのdaAcknowledgementResponseというリソース・バンドルにキーがある場合は、「確認応答」フィールドに次のように入力します:

   ${rb('daAcknowledgementResponse')}

バンドル・キーの値でパラメータを使用することもでき、これにより、出力でシステム変数を使用できます。たとえば、「フロー終了の確認」プロパティのデフォルト値は次のとおりです:

Exited ${system.routingFromIntent} in ${system.routingFromSkill}.

システム変数(この場合はsystem.routingFromIntentおよびsystem.routingFromSkill)への参照を翻訳されたレスポンスで保持するには、次を実行します:

1. 対応するリソース・バンドル・キーの値に、各システム変数の置換コードとして{0}、{1}などを挿入します。たとえば、「フロー終了の確認」プロパティ用に作成した英語(またはデフォルト)のエントリでは、次のテキストを使用できます:

   Exited {0} in {1}.

2. 次に、プロパティの値に、バンドル・キーへの参照を次のフォーマットで入力します:

   ${rb('bundleKey', '${systemVariableForParam0}', '${systemVariableForParam1}')}

   たとえば、「フロー終了の確認」プロパティでは次のようになります(daExitFlowConfirmationは対応するバンドル・キーです):

   ${rb('daExitFlowConfirmation', '${system.routingFromIntent}', '${system.routingFromSkill}')}

リソース・バンドルはCSVファイルの形式でエクスポートおよびインポートできるため、バンドルをオフラインで操作できます。

CSVファイルには次の列が必要です:

• languageTag
• key
• message
• annotation

既存のリソース・バンドルを含むCSVファイルをエクスポートするには:

• スキルまたはデジタル・アシスタントの「リソース・バンドル」ページで、をクリックして既存のリソース・バンドルを含むCSVファイルをエクスポートします。

  リソース・バンドルにまだキーを追加していない場合でも、必要なフォーマットのCSVでファイルがエクスポートされます。

リソース・バンドル・ファイルをインポートするには:

• スキルまたはデジタル・アシスタントの「リソース・バンドル」ページで、をクリックします。

プラットフォーム・バージョン21.04以降、デジタル・アシスタント構成設定用にリソース・バンドル・エントリが自動的に作成されます。デジタル・アシスタントがプラットフォーム・バージョン21.02以前に基づいている場合は、21.04以上にアップグレードして、これらのエントリを生成できます。

デジタル・アシスタントのすべてのシステム・リソース・バンドル・エントリとそのデフォルト値のリストを次に示します。

デジタル・アシスタントのプラットフォーム・バージョンを21.04以上にアップグレードせずに、構成設定にリソース・バンドル・エントリを使用する場合は、翻訳可能なカスタマイズ・プロパティと、バンドル・キーの推奨名、およびそれらのバンドル・キーをプロパティのフィールドから参照するために使用する式のリストを次に示します。