

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

# 疑难解答和问答
<a name="emr-spark-upgrade-agent-troubleshooting"></a>

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

不同的 MCP 客户端可以通过不同的方式获得升级过程中的错误消息。在本页中，我们列出了一些一般指南，说明您在使用适用于 Amazon EMR 的 Apache Spark 升级代理时可能会遇到的常见问题。

**Topics**
+ [错误：SMUS 托管 MCP 服务器加载失败](#spark-upgrade-agent-mcp-server-failed)
+ [观察：工具加载缓慢](#spark-upgrade-agent-slow-tool-loading)
+ [错误：工具调用失败，出现限制错误](#spark-upgrade-agent-throttling-error)
+ [错误：工具响应用户错误](#spark-upgrade-agent-user-error)
+ [错误：工具响应内部错误](#spark-upgrade-agent-internal-error)

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

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

### 错误：工具调用失败，出现限制错误
<a name="spark-upgrade-agent-throttling-error"></a>

如果您达到服务限制，请等待几秒钟以发出工具调用（如果您看到限制异常）。

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

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

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

### 1. 我是否应该在默认情况下为这些工具启用 “信任” 设置？
<a name="spark-upgrade-agent-qa-trust-setting"></a>

最初不要为所有工具调用打开 “信任” 设置，而要在 git 版本化的构建环境中进行操作。查看每个工具的执行情况，以了解正在进行哪些更改，例如在提供同意之前查看升级计划。永远不要信任 Kiro 或你的 Agent 的`fs_write`工具——这个工具会修改你的项目文件，你应该在保存/提交更改之前随时对其进行审查。通常，在允许写入文件之前，请先检查所有建议的文件更改。在整个升级过程中使用 git 进行版本更改并创建检查点。逐步建立信心-如果您反复使用系统进行多次升级，并且对这些工具有了信心，则可以有选择地信任某些工具。

### 2. 使用升级工具的常见示例提示有哪些？
<a name="spark-upgrade-agent-qa-prompt-examples"></a>

有关利用升级工具[Spark 升级代理的提示示例](emr-spark-upgrade-agent-prompt-examples.md)的提示示例，请参阅。