本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
故障診斷和問答
疑難排解
Spark 故障診斷代理程式的錯誤訊息會以不同的方式提供給不同的 MCP 用戶端。在此頁面中,我們會列出一些一般指引,說明使用適用於 Amazon EMR 的 Apache Spark 故障診斷代理程式時可能遇到的常見問題。
主題
錯誤: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 版本建置環境中操作。檢閱每個工具執行以了解正在進行的變更。
2. 利用故障診斷工具的常見範例提示是什麼?
如需利用故障診斷工具提示範例的提示範例,請參閱 。
3. 哪些資料會傳輸至 LLM,以及如何處理?
客戶資料和檔案會保留在您選擇的 AWS 區域內,不會跨區域傳輸。當代理程式在從 Amazon Bedrock 使用全域跨區域推論的區域中操作時,服務可能會根據需求,將請求路由到具有可用容量的最近區域。在這種情況下,只會傳輸從客戶日誌擷取的中繼資料和已處理的推論結果,而不是基礎客戶資料或檔案。所有資料都會在傳送到 LLM 進行處理之前被 PII 遮罩,無論推論是在相同區域內發生或路由到另一個區域。如需跨區域推論的運作方式和受影響區域的詳細資訊,請參閱 Apache Spark 故障診斷代理程式的跨區域處理。