本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 對客服人員自助服務問題進行故障診斷
<a name="ts-agentic-self-service"></a>

以下是[客服人員自助服務](agentic-self-service.md)特有的問題。

## AI 代理器未回應客戶
<a name="ts-ai-agent-not-responding"></a>

如果您的 AI 代理器正在處理請求，但客戶沒有看到任何回應，協調提示可能缺少必要的訊息格式指示。

協調器 AI 代理器只會在模型的回應包裝在`<message>`標籤中時向客戶顯示訊息。如果您的提示未指示模型使用這些標籤，則不會將回應轉譯給客戶。

**解決方案**：確保您的協同運作提示包含格式化指示，要求模型在`<message>`標籤中包裝回應。如需詳細資訊，請參閱[訊息剖析](use-orchestration-ai-agent.md#message-parsing)。

## MCP 工具調用失敗
<a name="ts-mcp-tool-failures"></a>

如果您的 AI 代理器無法在對話期間叫用 MCP 工具，請檢查下列項目：
+ **安全設定檔許可** – 驗證 AI 代理器的安全設定檔是否授予其所需特定 MCP 工具的存取權。AI 代理程式只能叫用具有明確存取許可的工具。
+ **閘道連線** – 確認 Amazon Bedrock AgentCore Gateway 已正確設定，且探索 URL 有效。確認傳入身分驗證對象已設定為閘道 ID。在 AgentCore 主控台中檢查閘道狀態。
+ **API 端點運作狀態** – 確認 MCP 工具後方的後端 API 或 Lambda 函數正在執行並正確回應。檢查 CloudWatch Logs 是否有目標服務中的錯誤。

## MCP 工具的 IAM 許可
<a name="ts-mcp-iam-permissions"></a>

如果 MCP 工具呼叫傳回存取遭拒錯誤，請確認 IAM 角色具有必要的許可：
+ **Amazon Bedrock AgentCore Gateway 角色** – 閘道的執行角色必須具有叫用 MCP 工具所連線後端 APIs或 Lambda 函數的許可。
+ **Amazon Connect 服務連結角色** – Amazon Connect 服務連結角色必須具有叫用 Amazon Bedrock AgentCore Gateway 的許可。