Amazon LexV2クイックスタートガイド

Google と Genesys は、AI と Google の音声インタラクションテクノロジとコール センターの自動化を組み合わせることで、組織がカスタマー エクスペリエンスを向上させる高度な機能を提供Genesys支援するパートナーシップを開発しました。

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

クイックスタート手順

このクイックスタート記事は、Google Dialogflow統合の実装をガイドします。 ここでは、次の手順を実行する方法について説明します。

  1. Amazon LexV2ボットを作成します。
  2. GenesysにAmazonLexV2ボットを呼び出す権限を付与します。
  3. Genesys AppFoundryからAmazon Lex統合をインストールする
  4. Genesys CloudでのLexインテグレーションの設定とアクティブ化
  5. Genesys Cloud Architectフローを作成し、Google Dialogflowボットで構成する
  6. Genesys Cloudを使用して、Architectのインバウンドコールフローを呼び出します。

ステップ 1:   Amazon LexV2ボットを作成する

Lexボットを作成するプロセスは Amazonによってドキュメント化されています。 プロセスが変わる可能性があるので、チャットボットを作成するときはAmazonのドキュメントを参照してください。 この例では、簡単なボットを作成する方法を説明します。 その後、ビジュアルビルダーまたはエディタで、インテントを追加し、スロットを構築する方法を学びます。 このボットを作成するには、アマゾンウェブサービス ( AWS )(AWS)のBotsインターフェースを使用します。  

前提条件

初期ボットを作成し、名前、言語、音声、基本情報を追加するには、次の手順に従います。

  1. AWSマネジメントコンソールにサインインして、 Amazon LexV2コンソール
  2. ボットの作成をクリックします。
  3. 作成方法作成を選択します。
  4. ボット構成、ボットに名前とオプションの説明を付けます。 たとえば、「BankBot」。
  5. [IAMアクセス許可]で、ボットのアクセス許可を定義するロールを選択します。 ここで、既存の役割を選択します。
  6. 児童オンラインプライバシー保護法(COPPA)、適切な応答を選択します。 この例では、 番号
  7. アイドルセッションタイムアウト、Amazon LexV2がユーザーとのセッションを開いたままにする期間を選択します。 Amazon Lex V2は、ボットが同じ変数で会話を再開できるように、セッション中にセッション変数を維持します。 この例では、デフォルト設定のままにします。
  8. 他のすべての設定は変更しないでください。
  9. ボットを作成して言語の追加を続けるには、をクリックします 。 [ボットへの言語の追加]ページが開きます。
  10. ボットが使用する言語と音声を追加します。
    1. 言語を選択する、ボットに適切な言語を選択します。 ここでは、デフォルトのままにします 英語 言語。 
    2. 音声対話、ボットがユーザーとの対話に使用するテキスト読み上げ音声を選択します。 ここで、 ケンドラ
    3. 意図分類信頼スコアのしきい値、インテントが正しいインテントであるかどうかを判断するためにAmazonLexが使用する値を設定します。 この例では、デフォルト値をそのままにします 4.0
    4. クリック 完了。 タスク エディターを開きます。

    この例では、AWSのビジュアルビルダーを使用しています。 2つのインテントを作成します。 単純な発話と1つのスロットを持つ口座残高インテントと、空のクロージングスロット。 次に、ボットをビルドします。 

    インテントとスロットを追加し、ビジュアルビルダーでボットを構築するには、次の手順に従います。

    注意: 最初のインテントで統合を終了することはできないので、空のインテントを使用してセッションを終了してください。

    1. エディタの下部で、Visual builder をクリックします。
    2. 空のインテントを追加し、"ClosingIntent "と入力します。 このインテントには設定が含まれておらず、ボットはこれを利用して会話を終了します。
    3. アカウントの残高インテントを追加します。
      1. インテントの追加 をクリックします。
      2. 空のインテントを追加する をクリックします。 
      3. インテント名 の下に、「CurrentBalance」と入力し、Add をクリックします。
      4. Start ブロックを編集します。
        1. をクリック 編集 .
        2. Include initial response チェックボックスを有効にします。
        3. メッセージ ボックスに、"Thank you for calling "と入力します。 銀行業務のルーティングを手伝うことができます。 どのように私はあなたを支援することができますか?"
        4. サンプル発話 ボックスに、"What is my account balance?" と入力します。
        5. 発言の追加 をクリックします。 
      5. 1つのスロットを作成し、設定する。
        1. ツールバーから、Get slot value ブロックをビジュアルビルダーにドラッグします。
        2. の中に 名前 ボックスに「AccountNumber」と入力します。
        3. スロットタイプ、 選択する AMAZON.number
        4. Slot Prompts の下に、"Please enter your account number" と入力します。
        5. Start ブロックとAccountNumber スロットブロックを接続します。
      6. 2つのインテント・ブロックを作成し、設定する。
        1. ツールバーから、2つの「Go to Intent」ブロック をビジュアルビルダーにドラッグします。
        2. 最初のGo to Intent ブロックをクリックし、Intent Name で、ステップ 1 で作成したClosingIntent を選択します。
        3. 2 番目のIntent ブロックをクリックし、Intent Name で、FallbackIntent を選択します。
        4. AccountNumber スロットブロックのSuccess パスをClosingIntent ブロックに接続してください。
        5. AccountNumber スロットブロックのFailure パスをFallbackIntent ブロックに接続します。
    4. 目的をクリックします。
    5. クリックします。 視覚障害者.
    6. バージョンとエイリアスを作成します。

    この例では、2つのインテントを作成します。 ウェルカムメッセージインテントとアカウントバランスインテント、シンプルな発話と単一のスロット。 次に、ボットをビルドします。

     メモ:   必ずウェルカムインテントを追加してください。 このインテントはボットから最初の音声を要求しようとし、除外された場合、リソースエラーが発生します。

    インテントとスロットを追加し、エディタでボットを構築するには、次の手順に従います。

    1. ウェルカムメッセージのインテントを追加します。 このインテントにはスロットがありませんが、終了メッセージがあります。 このメッセージは、発信者に最初に聞こえるメッセージです。
      1. クリック インテントを追加 次にクリックします 空のインテントを追加する。 
      2. インテント名、「WelcomeMessage」と入力して、 追加
      3. クロージングレスポンス、 の中に メッセージ ボックスタイプ「お電話ありがとうございます。 銀行業務のルーティングを手伝うことができます。 どのように私はあなたを支援することができますか?"
      4. 残りの設定は変更しないでください。
      5. 目的をクリックします。
    2. アカウントの残高インテントを追加します。
      1. クリック インテントを追加 次にクリックします 空のインテントを追加する。 
      2. インテント名、「CurrentBalance」と入力してクリックします 追加。 タスク エディターを開きます。
      3. サンプル発話、「口座残高」と入力します。
      4. の中に サンプル発話 テキストボックスに、「アカウントの残高はいくらですか?」と入力します。次にクリックします 発話を追加する。 
      5. スロット、 クリック スロットを追加
      6. の中に 名前 ボックスに「AccountNumber」と入力します。
      7. スロットタイプ、 選択する AMAZON.number
      8. プロンプト、「アカウント番号を入力してください」と入力します。
      9.    [追加] をクリックします。
      10. 目的をクリックします。
    3. クリックします。 視覚障害者.
    4. バージョンとエイリアスを作成します。

      ステップ 2:   GenesysにAmazonLexV2ボットを呼び出す権限を付与します

      Amazon Lex Botにアクセスするには、Genesys CloudがAmazon Web Services(AWS)でリソースを使用する許可を持っている必要があります。 この手順では、AWSでIAM役割を設定する方法について説明します。 この役割は、Genesys Cloudでアプリケーションを設定およびアクティブ化するときに、後でAmazon Lexに割り当てられます。

       メモ:   ボットには、DRAFTのデフォルトバージョンとTestBotAliasのデフォルトエイリアスが含まれています。 限定的なテストには、このエイリアスを使用してください。 リアルタイムで使用すると、制限を超えて通話に失敗する可能性があります。

      前提条件

      IAM役割を設定するには

      1. AWSにログインします。
      2. に移動します AWSサービス ページを選択して選択します わたし
      3. ダッシュボードを選択 役割
      4. 役割 ページ、クリック ロールを作成
      5. 選択する 別のAWSアカウント 信頼できるエンティティのタイプとして。
      6. アカウントID」ボックスに、「765628985471 」(コア/サテライト地域)または「325654371633 」(FedRAMP地域(US-East-2))を入力してください。 この番号はGenesys CloudプロダクションアカウントIDです。
      7. セキュリティを強化するために、Genesysは、 外部IDを要求する ボックスをクリックして組織のIDを入力します。
      8. クリックします。 次.  権限
      9. 次に、役割に権限ポリシーを割り当てます。 検索ボックスに、次のように入力します。 レックス。 それから AmazonLexReadOnly そして AmazonLexRunBotsOnly ポリシーチェックボックス。
      10. クリックします。 次.  タグ
      11. (オプション)タグをキーと値のペアとして添付して、役割にメタデータを追加します。 
      12. クリックします。 次.  レビュー…
      13. の中に 役割名 ボックスに名前を入力します。 たとえば、DemoLexRoleです。
      14. の中に 役割の説明 ボックスに、役割についての説明文を入力します。
      15. 次のアカウント番号を確認します。 信頼されたエンティティ は、手順6で入力したGenesys CloudプロダクションアカウントIDと一致します。
      16. クリック 役割を作成
      17. リストページで、役割の名前をクリックします。 このリンクは、入力した名前です。 役割名 手順12のボックス。 役割に関する要約詳細が表示されます。
      18. に注意してください ロールARN。 後でこの認証情報が必要です。 あ Amazonリソースネーム (ARN)は、リソースを明確に識別する一意の識別子です。
      19. クリック コピーする ARNをクリップボードにコピーするには、アイコン(Role ARNの右側)をクリックします。 

      AWSコンソールでJSON形式のLexV2ポリシーを作成し、それをIAMロールに割り当てます。 このポリシーにより、Genesys CloudArchitectがAmazonLexV2ボットと対話できるようになります。

      1. AWSマネジメントコンソールにサインインして、 IAMコンソール
      2. 左側のナビゲーションペインで、をクリックします ポリシー
      3. クリック ポリシーを作成する
      4. SSO タブをクリックします。
      5. Type or paste the following JSON content: 
        {
              "Version": "2012-10-17",
             "Statement": [
                  {
                       "Sid": "VisualEditor0",
                       "Effect": "Allow",
                       "Action": [
                            "lex:List*",
                            "lex:Describe*",
                            "lex:StartConversation",
                        ],
                        "Resource": "*"
                  }
             ]
        }
      6. ポリシー検証によって生成されるセキュリティ警告、エラー、または一般的な警告を解決し、[ ポリシーの確認
         メモ:   ビジュアルエディターとJSONタブはいつでも切り替えることができます。 ただし、変更を加えるか、[次へ]を選択した場合: ビジュアルエディタータブのタグであるIAMは、ポリシーを再構築してビジュアルエディター用に最適化する場合があります。
          
      7. クリックします。 次.  タグ
      8. (オプション)タグをキーと値のペアとして添付して、役割にメタデータを追加します。 
      9. ポリシーの確認 ページに、 名前説明 (オプション)ポリシー用。 ポリシーの概要を確認して、ポリシーが付与するアクセス許可を確認します。
      10. クリック ポリシーを作成する
      11. ポリシーを作成したら、 IAMロールにアタッチします 上で作成したもの。

      例: 

      ステップ 3:   Genesys AppFoundryからAmazon Lex統合をインストールする

      このセクションでは、GenesysCloudにAmazonLexV2統合を取得してインストールする方法について説明します。

      前提条件

      • Genesys Cloud Salesに連絡して、サブスクリプションの更新をリクエストしてください。

      組織に Amazon Lex をインストールするには :

      1. Amazon Lexを追加する組織のGenesys Cloudにログインします。
      2. 管理をクリックします。
      3. 統合統合をクリックします。
      4. [統合] をクリックします。
      5. 検索ボックスに、次のように入力します。Amazon Lex。 Amazon Lex 用のカードが表示されます。
      6. Amazon Lex カードをクリックします。 アプリに関する情報が表示されます。
      7. インストールをクリックします。

      Amazon Lexは、Genesys Cloudから設定およびアクティブ化できるようになりました。管理 > 統合 ページ。 

      詳細を表示

      Amazon Lexのドキュメント

        ステップ 4: Genesys CloudでのLexインテグレーションの設定とアクティブ化

        このセクションでは、GenesysCloudでAmazonLexV2統合を有効にしてセットアップする方法について説明します。

        ArchitectでCall Lex Botアクションにアクセスするには、まずAmazon Lex統合を追加して設定してから、組織内のAWSリソースにアクセスするためのアクセス許可を付与する必要があります。 

        1. Genesys Cloudで、 管理.
        2. 統合 統合をクリックします。
        3. クリック 統合の追加。 
        4. Amazon Lexの統合を見つけます。
        5. Amazon Lexタイルで、をクリックします インストール。 Genesys Cloudは統合をインストールします。
        6. クリック 統合
        7. 隣です アマゾンレックスクリック もっとその  を選択し、 統合の編集.
        8. をクリックします。 構成 タブし、 資格 情報 タブ.
        9. クリック 構成
        10. の中に 役割ARN ボックス、を押します Ctrl + V クリップボードに保存したARNをに貼り付ける 役割ARN 箱。 Macを使用している場合は、 Command + V 貼り付けます。 
        11. 追加するをクリックし、次に 保存するクリックします。
        12. 詳細タブを選択します。
        13. 統合をアクティブ化するには、 非活性. [ステータスの変更]ダイアログが表示され、AmazonLexをアクティブ化するかどうかを確認するように求められます。
        14. [はい] をクリックします。  ステータスが アクティブになります。

        ステップ5: Genesys Cloud Architectフローを作成し、Google Dialogflowボットで構成する

        これらの手順により、ボットとフローの間の一貫性が保証されます。

         メモ:   デフォルトでは、DefaultまたはGenesysTTSのみを選択できます。 Amazon Pollyを使用する前に、統合をインストールして設定する必要があります。 詳細については、を参照してください。 AmazonPolly入門 AmazonPolly開発者ガイドと AmazonPolly統合をインストールします Genesys Cloud ResourceCenterにあります。

        前提条件

        • AWSコンソールで設定されたAmazonLexV2ボット。 

        Architectフローを作成するには、次の手順を実行します。

        1. Genesys Cloudで、管理をクリックします。
        2. Architectクリック Architect。 Architect のホームページが表示されます。
        3. Architectホームページで、をクリックするか、 フローメニューと選択 着信通話。
        4. クリック 追加 .  [フローの作成]ダイアログボックスが開きます。
        5. の中に フィールドに、フローの一意の名前を入力します。 ここに「BankingBot」と入力します。
        6. (省略可能) このオプションを選択します。の 説明 フィールドには、このフローを説明する短い文または語句を含めます。
        7. をクリックします。 既定の言語 をクリックし、フローのサポートされている言語デフォルト選択します。 この例では、デフォルトの英語のままにします。
        8. クリック 部署 フローを配置する部門をリストして選択します。 この例では、デフォルトのホーム部門を使用します。
        9. クリックします。 フローを作成します。.  フロー構成ページが開きます。

        これらの手順により、ボットとフローの間の一貫性が保証されます。

        1. 下 設定クリック サポートされている言語。
        2. の中に サポートされている言語 パネル、下 テキスト読み上げ、 選ぶ アマゾンポリー
        3. ボイス、 選択する ケンドラ

        例: 

        新しいタスクを作成し、LexV2ボットを呼び出します。

        1. 再利用可能なタスク、 クリック ここに再利用可能なタスクを追加します。 次にクリックします ツールボックス 選択します タスク
        2. タスクエディタの上で、タスクの名前を「セルフサービス」に変更し、[ 終わり
        3. クリック その他 表示されたメニューから、 これを開始タスクとして設定します.
        4. Architectツールボックスから、展開します データ カテゴリーとドラッグ ダイアログエンジンボットの呼び出し タスクエディターへのアクション。
        5. Call Lex V2 Botパネルで、アクションを構成します。
          1. ボット名、 選択する BankBot
          2.  下 ボットエイリアス、 選択する TestBotAlias
          3. 初期インテント名 の下に、以前に作成したウェルカムメッセージインテントを指定します。
            • ビジュアルビルダーでインテントを作成した場合、CurrentBalance を選択します。
            • エディターでインテントを作成した場合、WelcomeMessage を選択します。

        [インテント]の下に、アーキテクトが一致する可能性のある各インテントのパスを含めていることに注意してください。 

        1. アカウント番号をアーキテクト変数に取り込むには、 経常収支 「Task.AccountBalance」と入力します。
        2. CurrentBalanceパスにオーディオシーケンスを追加します。
        3. ツールボックスから、 オーディオ カテゴリをドラッグして オーディオアクションを再生する CurrentBalanceパスの下のタスクエディタに移動します。
        4. [オーディオの再生]パネルで、[オーディオ]の横にあるをクリックします オーディオシーケンス 。 [オーディオ シーケンスの編集]ダイアログボックスが開きます。
        5. の中に テキスト読み上げ ボックスに「あなたの口座番号はわかりました」と入力します。
        6. クリック データの追加、および データ ボックスタイプTask.AccountNumber。
        7. クリック オプションを選択 と選択します 各キャラクターを話す
        8.   [閉じる] をクリックします。
        9. 各インテントの結果パスを引き続き追加します。 例:  
          • アカウントの残高を顧客に読み戻すCurrentBalanceパスの下に別のPlayAudioアクションを追加します。
          • 追加する ACDアクションに転送 フローが失敗パスをたどる場合に備えて、コールをサポートチームに転送します。
        10. を追加 切断する タスクを終了するためのアクション。
        11. 公開するクリックします。

        例: 

          ステップ6: GenesysCloudを使用してインバウンドコールフローを呼び出す

          次に、Genesys CloudでBankingBotフローを呼び出し、ボットをテストします。

          コール ルート エントリを設定するには、次の手順を実行します。

          1. Genesys Cloudで、 呼び出し パネルクリック 呼び出し
          2. の中に 名前と番号を入力してください フィールド、タイプ BankingBot
          3. クリック 電話 ボタンをクリックするか、Enterキーを押します。
          4. プロンプトに従います。

          サマリー

          おめでとうございます! これで、Genesys CloudArchitectで呼び出すAmazonLexV2ボットに音声インタラクションをルーティングする準備が整いました。 また、Amazon Lex V2ボットを使用して、インタラクションを操作し、GenesysCloudのライブエージェントへのエスカレーションを設定することもできます。