ボットフローを作成し、サードパーティ製ASR文法を使用するクイックスタートガイド

1. 管理をクリックします。
2. 下 統合、クリック 統合.
3. [統合] をクリックします。
4. Search ボックスに、 Nuance Recognizer as a Service と入力します。 Nuance Recognizer as a Serviceのカードが表示されます。
5. インストールをクリックします。

1 つの Nuance 言語グループに対して Nuance Recognizer as a Service 統合を構成するには、次の手順を実行します。

1. Nuance Recognizer as a Service統合を開きます：
   • Genesys Cloud組織に統合をまだインストールしていない場合は、今すぐインストール。 
   • 統合をインストールした場合は、Genesys Cloud Adminメニューを開き、統合、 クリック統合。 次に、Nuance Recognizer as a Service 統合を検索して開きます。
2. Nuance Recognizer as a Service 統合ページで、Configuration タブをクリックします。
3. 下プロパティ、見つけてください認識エンドポイント URLセクション。
4. の中に価値フィールドに、ボットがサポートする Nuance 言語グループの地域エンドポイントを入力します。
   • For example, if you want to use Nuance Recognizer as a Service for en-US, ja-JP, and zh-CN, use nr-apac4.api.nuance.com.
   • If your bot only supports one language, use the URI of a language group that includes the language and is closest to your organization’s location. For example, if your bot supports fr-FR by default and your organization exists in Switzerland, use nr-wu2.api.nuance.eu. For more information, see Language groups by region in the Nuance Recognizer documentation.
5. クリック 資格情報 タブ。Genesys Cloudは資格情報をリストしますさまざまな Nuance 言語グループに関連付けられたエンドポイントへの認証に使用できるすべての認証エンドポイント URL です。 資格情報を設定しますデフォルトの認識エンドポイントのみ。
    メモ：   特定の言語グループに対して構成する資格情報を決定するには、対応するエンドポイント URL に基づいて、言語グループが属する Nuance リージョンを確認します。 詳細については、地理Nuance Mix のドキュメントをご覧ください。
   画像をクリックして拡大します。
6. クリック構成、設定のためにデフォルトの認識エンドポイント URL の Nuance 認識資格情報。 Configure Credentials ダイアログ ボックスが開きます。
7. OAuth設定から「client_id」の値をNuanceにコピーします。クライアントID分野。 使用ボットが AU、EU、または US Nuance 地域の言語を使用しているかどうかに応じて、AU、EU、または US クライアント ID を入力します。
   Note: For example, if the regional endpoint URI you specified in step 4 ends in nuance.eu, use the client ID of your mix.nuance.eu credentials. If the URI ends in nuance.com, use the client ID of your mix.nuance.com credentials.
   画像をクリックして拡大します。
8. OAuth設定から「client_secret」の値をNuanceにコピーします。クライアントシークレット分野。 ボットが AU、EU、または US Nuance 地域の言語を使用するかどうかに応じて、AU、EU、または US クライアント シークレットを使用します。
   1. JSONファイルから「private_key_id」をNuance Private Key ID フィールドにコピーする。
   2. JSON ファイルの「private_key」値をNuance Private Key フィールドにコピーします。
9.   [OK] をクリックします。
10. 保存するをクリックします。
11. Nuance Recognizer をサービスステータスとしてアクティブにするには、Status 列で、Inactive をクリックします。 [ステータスの変更] ダイアログボックスが開きます。
12. [はい] をクリックします。  Nuance Recognizer as a Service の統合ステータスがActive に変更されます。

1. Nuance Recognizer as a Service統合を開きます：
   • Genesys Cloud組織に統合をまだインストールしていない場合は、今すぐインストール。 
   • 統合をインストールした場合は、Genesys Cloud Adminメニューを開き、統合、 クリック統合。 次に、Nuance Recognizer as a Service 統合を検索して開きます。
2. Nuance Recognizer as a Service 統合ページで、Configuration タブをクリックします。
3. 下プロパティ、見つけてください認識エンドポイント URLセクション。
4. の中に価値フィールドに、次の基準に基づいてリージョン エンドポイントを入力します。
   • If a language group includes all the languages that your bot supports, use its corresponding URI. For example, if you want to use Nuance Recognizer as a Service for en-US, ja-JP, and zh-CN, use nr-apac4.api.nuance.com. If your bot only supports one language, use the URI of a language group that includes the language and is closest to your organization’s location. For example, if your bot supports fr-FR by default and your organization is based in Switzerland, use nr-wu2.api.nuance.eu. For more information, see Language groups by region in the Nuance Recognizer documentation.
   • ボットがサポートし、Nuance Recognizer as a Service を使用したい言語が複数の言語グループに属している場合は、URIを使用します。ボットがデフォルトでサポートする言語を含む言語グループ。 他の言語グループのURIを指定します。高度なタブ。 詳細については、地域別の言語グループNuance Recognizer のドキュメントをご覧ください。 
5. クリック 高度な タブ 。
6. にNuanceが以前に指定したデフォルトのエンドポイントを通じて提供していない言語のマッピングを設定します。認識エンドポイント URLセクションでは、次の手順に従ってください。
   メモ: 

   • デフォルトの地域エンドポイントがカバーする言語を除き、すべての言語を適切な Nuance エンドポイントにマッピングするようにしてください。
   • 言語を地域のNuanceエンドポイントにマッピングする場合は、その言語地域の資格情報を設定する必要があります。資格デフォルトの地域エンドポイントとそれに対応する資格情報がその言語をカバーしている場合でも同様です。
   • 言語にマッピングされた値がない場合、高度な設定セクションの場合、Genesys Cloud はデフォルトの資格情報を使用してデフォルトの地域エンドポイントを使用しようとします。
   1. (オプション) Genesys Cloudが高度な設定を検証するJSONスキーマをダウンロードして検査するには、スキーマをダウンロード。
   2. 「endpointMappings」という名前のプロパティをオブジェクトとして追加します。
   3. サポートされている言語の言語タグと対応するNuanceエンドポイントを次のように追加します。オブジェクトへのキーと値のペア: 次の例をコピーして詳細構成エディターに貼り付け、必要に応じて変更できます。

      {
      "endpointMappings": {
      "ca-ES": "nr-wu1.api.nuance.eu",
      "es-ES": "nr-wu1.api.nuance.eu",
      "es-US": "nr-na1.api.nuance.com",
      "gl-ES": "nr-wu1.api.nuance.eu",
      "va-ES": "nr-wu1.api.nuance.eu",
      "fr-FR": "nr-wu5.api.nuance.eu",
      "en-GB": "nr-wu1.api.nuance.eu",
      "eu-ES": "nr-wu1.api.nuance.eu"
      }
      }
      

       メモ：   ユーザー インターフェイスは、オブジェクトを期待される JSON スキーマに対して検証し、オブジェクトが準拠していない場合は通知します。
7. クリック 資格情報 タブ。Genesys Cloudは資格情報をリストしますさまざまな Nuance 言語グループに関連付けられたエンドポイントへの認証に使用できるすべての認証エンドポイント URL です。
    メモ：   特定の言語グループに対して構成する資格情報を決定するには、対応するエンドポイント URL に基づいて、言語グループが属する Nuance リージョンを確認します。 詳細については、地理Nuance Mix のドキュメントをご覧ください。
   画像をクリックして拡大します。
   
8. クリック 構成. Configure Credentials ダイアログ ボックスが開きます。
9. OAuth設定から「client_id」の値をNuanceにコピーします。クライアントID分野。 使用ボットが AU、EU、または US Nuance 地域の言語を使用しているかどうかに応じて、AU、EU、または US クライアント ID を入力します。
   Note: For example, if the URI of the regional endpoint you want to configure credentials for ends in nuance.eu, use the client ID of your mix.nuance.eu credentials. If the URI ends in nuance.com, use the client ID of your mix.nuance.com credentials.
   画像をクリックして拡大します。
10. OAuth設定から「client_secret」の値をNuanceにコピーします。クライアントシークレット分野。 ボットが AU、EU、または US Nuance 地域の言語を使用するかどうかに応じて、AU、EU、または US クライアント シークレットを使用します。
    1. JSONファイルから「private_key_id」をNuance Private Key ID フィールドにコピーする。
    2. JSON ファイルの「private_key」値をNuance Private Key フィールドにコピーします。
11.   [OK] をクリックします。
12. 設定する必要がある他のすべての資格情報に対して手順 8 を繰り返します。
    メモ: 

    • 言語のエンドポイントマッピングを設定した場合、高度なタブを選択した場合は、言語のグループが関連付けられている特定の Nuance 認証エンドポイント URL の資格情報を構成する必要があります。
    • 言語のエンドポイントマッピングを設定していない場合は、高度なタブで、以前に指定したデフォルトの地域エンドポイントの資格情報を設定する必要があります。プロパティタブ。
13. 保存するをクリックします。
14. Nuance Recognizer をサービスステータスとしてアクティブにするには、Status 列で、Inactive をクリックします。 [ステータスの変更] ダイアログボックスが開きます。
15. [はい] をクリックします。  Nuance Recognizer as a Service の統合ステータスがActive に変更されます。

Nuance Recognizer as a Serviceのインストール

画像をクリックして拡大します。

サービスとしてのNuance Recognizerを構成する

画像をクリックして拡大します。

• Nuance Recognizer as a Serviceの概要
• AppFoundry から Nuance Recognizer as a Service をインストールする。
• Nuance ASRをArchitectで使用するための設定を行います。

<?xml version="1.0"?>
<grammar xmlns="http://www.w3.org/2001/06/grammar" xml:lang="en-US" version="1.0" root="fruits"> 
     <rule id="fruits" scope="public">
          <one-of>
               <item>apple</item>
               <item>banana</item>
               <item>blueberry</item>
               <item>cherry</item>
               <item>grape</item>
               <item>peach</item>
               <item>pear</item>
               <item>pineapple</item>
               <item>strawberry</item>
               <item>watermelon</item>
          </one-of>
     </rule>
</grammar>

1. 管理をクリックします。
2. 下 Architectクリック Architect。アーキテクトは新しいタブで開きます。
3. クリックグラマー.
4. [追加] をクリックします。  新しい文法の作成」ダイアログボックスが表示されます。
5. 文法名フルーツ 。
6. 文法の説明］で、文法に関する説明的な詳細を追加します。 例えば、"販売する果物のリスト "などです。
7. 開始言語 をクリックし、文法に使用させたい初期言語を選択します。
8. 作成するをクリックします。 Grammar Editorが開きます。
9. 追加する文法の種類に応じて、以下のタブのいずれかをクリックします：
   • 音声
   • DTMF
10. Nuance Recognizer ASR 文法から GRXML コンテンツを手動で追加するには、エディターに構文を入力します。
     メモ：   文法がXMLの検証に合格すると、緑色のメッセージが表示され、文法に誤りがないことを知らせます。 赤いメッセージが表示された場合、ArchitectはGRXMLの中でエラーまたはエラーが存在する場所を知らせます。
11. 拡張子 .gram を持つ文法ファイルをアップロードするには、次の手順に従います。
     メモ：   .grxml ファイル タイプから .gram ファイル タイプに切り替えると、Architect は既存の .grxml ファイルを削除します。
    1. クリック.grxmlそして選択します。グラム。
    2. クリックファイルを選ぶ。 「文法ファイルの追加」ダイアログボックスが開きます。
    3. クリック.gramファイルを選択適切なファイルをアップロードします。
    4. クリックファイルの追加。 Architect はファイルをアップロードしますが、エラーはチェックしません。
12. 保存するをクリックします。

DTMF用文法エディター

本記事の例では、DTMFの文法を使用しています。 音声文法の詳細と例については、アーキテクトでボットフローの文法を追加する をご覧ください。

画像をクリックして拡大します。

• Architectでボットフローの文法を追加する

1. 新しいボットフローを作成します。
   1. Architect のホーム ページで、 フロー メニューを選択し、ボットフロー.
   2. クリック 追加. [フローの作成]ダイアログボックスが開きます。
   3. の中に 名前 フィールドに、フローの一意の名前を入力します。
   4. (オプション) 説明 このフローを説明する短い文またはフレーズを追加します。
   5. クリック 既定の言語 フローのデフォルトサポートされている言語をリストして選択します。
   6. クリック 部門 リストし、フローを配置する部門を選択します。
   7. クリックします。 フローを作成します。.  フローの設定ページが開きます。
2. 「自然言語の理解」の下にある 意図.
3. 最初のインテントを追加します：
   1. クリック 意図の追加.
   2. 意図に名前を付ける未払いの請求書を支払う。
   3. インスタンスを追加をクリックします。
   4. Utterancesページで、発話を追加します。 例えば、"payment "です。 
   5.    [追加] をクリックします。
   6. ステップa～eを繰り返し、別の発話を追加します。 ベストプラクティスでは、5つ以上の発話を追加することを推奨しています。 
4. 2つ目のインテントを追加します：
   1. クリック 意図の追加.
   2. インテントの名称フルーツオーダー.
   3. インスタンスを追加をクリックします。
   4. Utterancesページで、発話を追加します。 例えば、"place order"。 
   5.    [追加] をクリックします。
   6. ステップa～eを繰り返し、さらに発話を追加する。 ベストプラクティスでは、5つ以上の発話を追加することを推奨しています。 
5. スロットを追加します：
   1. Natural Language Understanding」メニューで、「Slots」 をクリックします。
   2. Add Slot をクリックすると、Add Slot ダイアログボックスが表示されます。
   3. スロット名PickFruit.
   4. Associated Slot Type」で、「New List」 を選択します。
   5. Engine をクリックし、サードパーティ製 ASR エンジンを選択します。 この例では、Nuance Recognizer as a Service を選択します。
   6. 文法 をクリックし、上記ステップ2の項目で追加した文法「果物 」を選択します。
   7. 保存するをクリックします。
   8. 手順 a ～ g を繰り返してスロットを追加します支払いそしてそれを組み込み:金額既存のスロットタイプ。
   9. 手順a～cを繰り返してスロットを追加します顧客アカウント番号そしてそれを新しい正規表現スロットタイプ。
6. 果物の例のスロットタイプを追加します：
   1. 自然言語理解」メニューで、「スロットタイプ」 をクリックします。
   2. Add Slot Type をクリックします。 スロットタイプの追加]ダイアログボックスが表示されます。
   3. スロット名ピックフルーツタイプ をクリックし、保存.
   4. イチゴ、パイナップル、梨、桃、ブドウ、チェリー、ブルーベリー、バナナ、リンゴ、スイカなどのさまざまなスロット タイプの値を追加します。
       メモ：   ペイメントスロットは、すでにビルトインスロットタイプに関連しています。
7. 作成した正規表現スロットタイプを設定します。顧客アカウント番号スロット。有効な口座番号を識別できる正規表現を指定します。
8. ボットフローを保存し、ステップ4に進みます。

インテント

画像をクリックして拡大します。

スロットを追加する

画像をクリックして拡大します。

スロットリスト

画像をクリックして拡大します。

スロット タイプ

画像をクリックして拡大します。

• ボットフローでインテントを持って作業する
• ボットフローで組み込みのスロットタイプを使用する
• ボットフローでカスタムリストスロットタイプを使用する
• ボットフローで組み込みのスロットタイプを使用する
• ボットフローでカスタムリストスロットタイプを使用する

1. ボットの起動」で、「デフォルトのボット」 をクリックします。
2. Toolbox の下にあるAsk メニューを展開し、タスクエディターの start の下にAsk for Intent アクションを追加します。
3. Ask メニューから、Fruit order path の下にAsk for Slot アクションを追加し、アクションを構成する：
   1. Slot リストをクリックし、PickFruit を選択します。
   2. クリック質問テキストを「どのような種類のフルーツを注文しますか? 「」をクリックし、保存。このアクションの文法ではスロットの文法が使用されることに注意してください。
4. から聞くメニュー 追加スロットをリクエストするフルーツ注文パスの下にアクションを追加し、アクションを構成します。
   1. クリックスロットリストと選択顧客アカウント番号。
   2. クリック質問テキストを「口座番号は何ですか？ 「」をクリックし、保存。
5. 顧客が有効な口座番号を入力したかどうかを確認するには、決定アクションから論理的フルーツ注文パスのアクションの下のメニューをクリックし、ニーズに基づいてカスタム式を使用してアクションを構成します。
6. から通信するメニュー追加行動を伝える決定アクションの「はい」と「いいえ」のパスの下に、口座番号が有効かどうかを顧客に通知するメッセージが表示されます。
7. ツールボックスで、「転送」メニューを展開し、「未払いの請求書を支払う」パスの下に「ACD に転送」アクションを追加します。 
8. Pay my billの失敗パスの下に、ご希望のアクションを追加してください。 例えば、コミュニケートアクション.
9. フローを保存して公開する。

画像をクリックして拡大します。

• タスクおよび状態エディタのアクション
• 意図的な行動を求める
• スロットアクションを要求

1. Architectホームページで、クリックするか、 流れ メニューと選択 着信通話.
2. 「追加」をクリックします。 [フローの作成]ダイアログボックスが開きます。
3. の中に名前フィールドに、着信コールフローの一意の名前を入力します。 
4. (オプション) 説明 このフローを説明する短い文またはフレーズを追加します。
5. クリック 部門 リストし、フローを配置する部門を選択します。
6. クリックします。 フローを作成します。. フローの設定ページが開きます。
7. 下再利用可能なタスク、 クリックタスク。
8. フロー設計領域で、タスクの名前をクリックし、タスクの固有の名前を入力します。
9. ツールボックスから、ボットメニューを追加して設定するコールボットフローアクションタスク エディターで開始します。
   1. ボットフローで、作成したボットを検索して選択します。セクション3 。
   2. 「出力」で、出力変数を追加します。ピックフルーツセクション 3 で設定したスロット。
   3. 「出力」の下に、別の出力変数を追加します。顧客アカウント番号セクション 3 で設定したスロット。
   4. 下実行結果を保存する変数を追加終了理由そしてその意図。
10. ツールボックスから、論理的メニューを追加して設定する決定アクションコールボットフローアクションの下:
    • To determine whether the invoked bot flow exited because the customer requested agent assistance, add the expression Task.ExitReason == "AgentRequestedByUser" in the Decision action’s Expression field.
11. 決定アクションのはいパスを追加して設定するACDアクションへの転送。ツールボックスから、移行メニューから「ACD に転送」アクションをタスク エディターにドラッグします。
    • [キュー] で、インタラクションを転送するキューを選択します。
12. 決定アクションの道なし、別のものを追加して設定する決定アクションボットフローが返したインテントに基づいてアクションを構成するには:
    • To determine whether Architect detected the intent to place an order, add the expression Task.Intent == "Fruit order" in the Decision action’s Expression field.
13. ツールボックスから、移行メニューから「Transfer to Secure」フローアクションをタスク エディターにドラッグします。
    1. [セキュア コール フロー] で、インタラクションを転送するセキュア コール フローを選択します。
    2. Under Invocation Data,  add the variables you configured for the Pickfruit and CustomerAccountNumber slots to pass the information these variables contain to the secure flow that you want to use for the order. You can use the Append function to append the two strings together: Append(Task.FruitToOrder, ",", Task.CustomerAccountNumber)and then in the secure call flow, you can use the following to access them separately:

       Split(Flow.InvocationData, ",")[0] -> Fruit Type 
       Split(Flow.InvocationData, ",")[1] -> Account Number

        メモ：   追加して設定することができますコールデータアクション顧客のアカウント番号に基づいて安全な通話フローで検索を実行し、誰が注文を行っているかを判断します。
14. 再利用可能なタスクの設計についてエリア、 クリッククリックこれを開始タスクとして設定する。再利用可能なタスクが上に移動して開始タスクになり、最初の挨拶が開始タスク領域に表示されるようになったことに注意してください。また、メイン メニューは、ページの下の再利用可能なメニューに移動します。メニューは使用しないので削除できます。
15. フローを保存して公開する。

これで、Architect 着信コール フローでサードパーティの ASR 文法を使用するボット フローをテストおよび実装できるようになりました。

画像をクリックして拡大します。

• ボットフローアクションの呼び出し
• フローを作成する