View a markdown version of this page

エージェントセルフサービスの問題のトラブルシューティング - Amazon Connect
AI エージェントが応答しないMCP ツールの障害MCP IAM アクセス許可

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

エージェントセルフサービスの問題のトラブルシューティング

以下の問題は、エージェントセルフサービスに固有の問題です。

AI エージェントが顧客に応答しない

AI エージェントがリクエストを処理しているが、お客様にレスポンスが表示されない場合、オーケストレーションプロンプトに必要なメッセージフォーマット手順が欠落している可能性があります。

オーケストレーター AI エージェントは、モデルのレスポンスが<message>タグでラップされている場合にのみ、顧客にメッセージを表示します。プロンプトがモデルにこれらのタグを使用するように指示しない場合、レスポンスは顧客にレンダリングされません。

解決策: オーケストレーションプロンプトに、モデルがレスポンスを<message>タグでラップする必要があるフォーマット手順が含まれていることを確認します。詳細については、「メッセージ解析」を参照してください。

MCP ツール呼び出しの失敗

AI エージェントが会話中に MCP ツールを呼び出せない場合は、以下を確認してください。

  • セキュリティプロファイルのアクセス許可 – AI エージェントのセキュリティプロファイルが、必要な特定の MCP ツールへのアクセスを許可していることを確認します。AI エージェントは、アクセス許可が明示的に付与されているツールのみを呼び出すことができます。

  • ゲートウェイ接続 — Amazon Bedrock AgentCore Gateway が正しく設定され、検出 URL が有効であることを確認します。インバウンド認証対象者がゲートウェイ ID に設定されていることを確認します。AgentCore コンソールでゲートウェイのステータスを確認します。

  • API エンドポイントのヘルス — MCP ツールの背後にあるバックエンド API または Lambda 関数が実行され、正しく応答していることを確認します。CloudWatch Logs でターゲットサービスのエラーを確認します。

MCP ツールの IAM アクセス許可

MCP ツール呼び出しがアクセス拒否エラーを返す場合は、IAM ロールに必要なアクセス許可があることを確認します。

  • Amazon Bedrock AgentCore Gateway ロール – ゲートウェイの実行ロールには、MCP ツールが接続するバックエンド APIs または Lambda 関数を呼び出すアクセス許可が必要です。

  • Amazon Connect サービスにリンクされたロール – Amazon Connect サービスにリンクされたロールには、Amazon Bedrock AgentCore Gateway を呼び出すためのアクセス許可が必要です。