Amazon Connect インスタンスで Amazon Lex 統合に失敗した場合のトラブルシューティング方法を教えてください。

簡単な説明

Amazon Lex ボットを問い合わせワークフローに統合できない最も一般的な理由は次のとおりです。

• リソースクォータを超えています。
• AWS コマンドラインインターフェイス (AWS CLI) を使用して Amazon Lex V2 ボットを関連付けることはできません。
• Amazon Connect で AWS Lex にアクセスしようとしています。
• Amazon Lex のインテントが問い合わせフローで特定されていないか、カスタマー入力が認識されていません。
• Amazon Lex セッションがタイムアウトしました。
• 問い合わせフローが、エラーフローを実行しています。

解決方法

Amazon Lex と Amazon Connect の統合をトラブルシューティングするには、まず Amazon Lex ボットが独立して動作するかどうかを検証します。たとえば、Amazon Lex コンソールで動作することを確認します。これにより、問題の原因が基盤となる Amazon Lex ボットにあるのか、Amazon Connect にあるのかを判断できます。

次に、フローログと Amazon Lex 会話ログを有効にして、他の統合問題のトラブルシューティングを行います。

最後に、Amazon Lex ボットを問い合わせワークフローに統合できない最も一般的な理由をトラブルシューティングします。

リソースクォータを超えている

次のエラーメッセージが表示されます。「Resource quota exceeded」(リソースクォータを超えています)

これは、次の Amazon Connect サービスのうち、少なくとも 1 つが制限を超えているためです。

• インスタンスあたりの Amazon Lex ボットのデフォルトクォータは 70 です。70 以上の Amazon Lex ボットをサポートするには、Amazon Lex V2 に移行してください。詳細については、「Amazon Lex V1 から V2 への移行ガイド」を参照してください。
• インスタンスごとの Amazon Lex V2 ボットエイリアスのデフォルトは 100 です。
• Amazon Lex ボット統合チャットのタイムアウトは 6 秒です。これは、Amazon Lex ボットがカスタマーのチャットプロンプトに応答しなければならない最大時間です。この数字を引き上げることはできません。

詳細については、「Amazon Connect のサービスクォータ」を参照してください。

AWS CLI を使用して Amazon Lex V2 ボットを関連付けることはできない

AWS CLI associate-lex-bot は Amazon Lex V2 では動作しませんが、AWS CLI associate-bot は Amazon Lex V1 と Amazon Lex V2 の両方で動作します。したがって、Amazon Lex V2 を使用している場合は、AWS CLI associate-bot を使用してください。

注: AWS コマンドラインインターフェイス (AWS CLI) コマンドの実行中にエラーが発生した場合は、AWS CLI の最新バージョンを使用していることを確認してください。

Amazon Connect で AWS Lex にアクセスしようとしている

クロスアカウントアクセスがサポートされていません。Amazon Connect と Amazon Lex ボットは、統合を行うために同じ AWS アカウントである必要があります。ただし、Amazon Lex ボットは別の AWS リージョンにあってもかまいません。

注: Amazon Lex ボットを接続インスタンスと同じリージョンに配置するのがベストプラクティスです。別のリージョンの Amazon Lex ボットを使用すると、パフォーマンスが最適化されない可能性があります。

Amazon Lex のインテントが問い合わせフローで特定されていないか、カスタマー入力が認識されていない

Amazon Lex V2 を使用している場合は、必ず正しい言語属性を設定してください。音声の設定ブロックを問い合わせフローに使用するのがベストプラクティスです。それをユーザー入力の取得ブロックの前に配置します。たとえば、Amazon Lex ボットのロケールが en, GB の場合、音声の設定ブロックの言語を英語、英国に設定します。次に、音声の設定ブロックで、言語属性の設定をオンにします。

重要: Amazon Lex V2 ボットの場合、Amazon Connect の言語属性は Amazon Lex ボットの構築に使用された言語モデルと一致する必要があります。これは Amazon Lex V1 とは異なります。Amazon Connect の言語モデルを指定するには、音声の設定 ブロックを使用するか、問い合わせ属性の設定 ブロックを使用してください。

Amazon Lex セッションがタイムアウト

音声問い合わせのタイムアウト値を設定するときは、Amazon Lex ボットを呼び出すカスタマー入力の取得ブロックに必ず適切なセッションの属性を使用してください。タイムアウト機能の制御の詳細については、「設定のヒント」を参照してください。

問い合わせフローが、エラーフローを実行している

Amazon Lex ボットのエイリアスが、問い合わせフローの必須項目であるカスタマー入力の取得フィールドで指定されたエイリアスと一致していることを確認してください。

重要: Amazon Lex ボットが**インスタンス問い合わせフローで正しいエイリアスに関連付けられていることを確認してください。**また、エイリアスが Amazon Lex ボットに使用する予定のエイリアスの正しいバージョンに対応していることを確認してください。

上記のステップを完了しても問題が解決しない場合は、AWS サポートにお問い合わせください。AWS サポートへのアクセス方法については、「Amazon Connect の管理サポートを受ける」を参照してください。

チケットと共に、以下の情報を提供するのがベストプラクティスです。

• 問い合わせセンターのインスタンス ID/ARN。インスタンス ARN を確認するには、「Amazon Connect インスタンス ID/ARN を検索する」を参照してください。
• この問題の詳細な説明。
• 受け取ったすべてのエラーメッセージ。
• エラーのスクリーンショット。
• 問い合わせフローログ (該当する場合)。

---