View a markdown version of this page

故障診斷和問答 - Amazon EMR

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

故障診斷和問答

疑難排解

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 故障診斷代理程式的跨區域處理