本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 故障診斷和問答
## 疑難排解
升級程序的錯誤訊息會以不同的方式提供給不同的 MCP 用戶端。在此頁面中，我們會列出一些一般指引，說明使用適用於 Amazon EMR 的 Apache Spark 升級代理程式時可能遇到的常見問題。
**Topics**
+ [錯誤：SMUS Managed 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 Managed MCP 伺服器無法載入
+ 確認您的 MCP 組態已正確設定。
+ **驗證 JSON 語法**：
+ 確保您的 JSON 有效，沒有語法錯誤
+ 檢查是否有遺漏的逗號、引號或括號
+ 驗證您的本機 AWS 登入資料，並確認 MCP IAM 角色的政策已正確設定。
+ 執行 /mcp 以驗證`Kiro-CLI`案例的 MCP 伺服器可用性
### 觀察：工具載入緩慢
+ 第一次嘗試啟動伺服器時，載入工具可能需要幾秒鐘的時間。
+ 如果工具未顯示，請嘗試重新啟動聊天，
+ 執行 `/tools`命令來驗證工具可用性。
+ `/mcp` 如果伺服器啟動時沒有發生錯誤，請執行 。
### 錯誤：工具調用失敗，限流錯誤
如果您達到服務限制，如果您看到調節例外狀況，請等待幾秒鐘發出工具叫用。
### 錯誤：工具回應與使用者錯誤
+ AccessDeniedException - 檢查錯誤訊息並修正許可問題。
+ InvalidInputException - 檢查錯誤訊息並更正工具輸入參數。
+ ResourceNotFoundException - 檢查錯誤訊息並修正資源參考的輸入參數。
### 錯誤：工具回應與內部錯誤
+ 如果您看到 `The service is handling high-volume requests` ，請在幾秒鐘內重試工具叫用。
+ 如果您看到 `INTERNAL SERVICE EXCEPTION`，請記錄分析 ID、工具名稱、mcp 日誌或工具回應中可用的任何錯誤訊息，以及選用的已淨化對話歷史記錄，並聯絡 AWS 支援。
## 問與答
### 1. 根據預設，我應該為工具啟用「信任」設定嗎？
根據預設，請勿開啟所有工具呼叫的「信任」設定，並在 git 版本建置環境中操作。檢閱每個工具執行以了解正在進行的變更，例如在提供同意之前檢閱升級計畫。請勿信任 Kiro 或代理程式`fs_write`的工具 - 此工具會修改您的專案檔案，您應該一律在儲存/遞交變更之前檢閱變更。一般而言，在允許寫入之前，請先檢查所有提議的檔案變更。在整個升級過程中，使用 git 進行版本變更並建立檢查點。逐步建立可信度 - 如果您重複使用系統進行多次升級，並對工具獲得信心，您可以選擇性地信任某些工具。
### 2. 利用升級工具的常見範例提示是什麼？
如需利用升級工具[Spark 升級代理程式的提示範例](emr-spark-upgrade-agent-prompt-examples.md)的提示範例，請參閱 。