本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 故障排除和问答
<a name="spark-troubleshooting-agent-troubleshooting"></a>

## 问题排查
<a name="spark-troubleshooting-common-issues"></a>

对于不同的 MCP 客户端，来自 Spark 故障排除代理的错误消息有不同的可用方式。在本页中，我们列出了一些使用适用于 Amazon EMR 的 Apache Spark 疑难解答代理时可能遇到的常见问题的一般指南。

主题
+ [错误：MCP 服务器加载失败](#mcp-server-failed-to-load)
+ [观察：工具加载缓慢](#slow-tool-loading)
+ [错误：工具调用失败，出现限制错误](#throttling-error)
+ [错误：工具响应用户错误](#user-error)
+ [错误：工具响应内部错误](#internal-error)

### 错误：MCP 服务器加载失败
<a name="mcp-server-failed-to-load"></a>
+ 验证您的 MCP 配置是否正确配置。
+ **验证 JSON 语法**：
  + 确保你的 JSON 有效且没有语法错误
  + 检查是否缺少逗号、引号或方括号
+ 验证您的本地 AWS 证书并验证 MCP IAM 角色的策略配置是否正确。
+ 运行 /mcp 以验证 MCP 服务器的可用性 `Kiro-CLI`

### 观察：工具加载缓慢
<a name="slow-tool-loading"></a>
+ 首次尝试启动服务器时，可能需要几秒钟才能加载工具。
+ 如果工具未出现，请尝试重新开始聊天。
+ 运行`/tools`命令以验证工具可用性。
+ `/mcp`如果服务器启动时没有出错，则运行。

### 错误：工具调用失败，出现限制错误
<a name="throttling-error"></a>
+ 如果您达到服务限制，请等待几秒钟以发出工具调用（如果您看到限制异常）。

### 错误：工具响应用户错误
<a name="user-error"></a>
+ AccessDeniedException -检查错误消息并修复权限问题。
+ InvalidInputException -检查错误消息并更正刀具输入参数。
+ ResourceNotFoundException -检查错误消息并修复资源引用的输入参数。

### 错误：工具响应内部错误
<a name="internal-error"></a>
+ 如果您看到，`The service is handling high-volume requests`请在几秒钟后重试工具调用。
+ 如果您看到，`INTERNAL SERVICE EXCEPTION`请记录分析 ID、工具名称、mcp 日志或工具响应中提供的任何错误消息以及可选的经过清理的对话历史记录，然后联系支持人员。 AWS 

## 问答
<a name="spark-troubleshooting-qa"></a>

### 1. 我是否应该默认为工具启用 “信任” 设置？
<a name="qa-trust-setting"></a>

接受代码建议时，请勿在默认情况下为所有工具调用打开 “信任” 设置，也不要在 git 版本化的构建环境中进行操作。查看每个工具的执行情况，以了解正在进行哪些更改。

### 2. 使用故障排除工具的常见示例提示有哪些？
<a name="qa-example-prompts"></a>

有关利用故障排除工具的提示示例，请参阅。[提示示例](spark-troubleshooting-agent-prompt-examples.md)

### 3. 哪些数据会传输到法学硕士学位以及如何处理这些数据？
<a name="qa-data-transmitted-to-llm"></a>

客户数据和文件保留在您选择的 AWS 区域内，不会跨区域传输。当代理在使用来自 Amazon Bedrock 的全球跨区域推理的区域运营时，该服务可能会根据需求将请求路由到最近的具有可用容量的区域。在这种情况下，仅传输从客户日志中提取的元数据和经过处理的推理结果，而不传输底层客户数据或文件。无论推理发生在同一区域内还是路由到另一个区域，所有数据在发送到 LLM 进行处理之前都经过了 PII 屏蔽。有关跨区域推理的工作原理以及哪些区域受到影响的更多详细信息，请参阅。[Apache Spark 故障排除代理的跨区域处理](spark-troubleshooting-cross-region-processing.md)