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

# 故障診斷和問答
<a name="spark-troubleshooting-agent-troubleshooting"></a>

## 疑難排解
<a name="spark-troubleshooting-common-issues"></a>

Spark 故障診斷代理程式的錯誤訊息會以不同的方式提供給不同的 MCP 用戶端。在此頁面中，我們會列出一些一般指引，說明使用適用於 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 以驗證`Kiro-CLI`案例的 MCP 伺服器可用性

### 觀察：工具載入緩慢
<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. 哪些資料會傳輸至 LLM，以及如何處理？
<a name="qa-data-transmitted-to-llm"></a>

客戶資料和檔案會保留在您選擇的 AWS 區域內，不會跨區域傳輸。當代理程式在從 Amazon Bedrock 使用全域跨區域推論的區域中操作時，服務可能會根據需求，將請求路由到具有可用容量的最近區域。在這種情況下，只會傳輸從客戶日誌擷取的中繼資料和已處理的推論結果，而不是基礎客戶資料或檔案。所有資料都會在傳送到 LLM 進行處理之前被 PII 遮罩，無論推論是在相同區域內發生或路由到另一個區域。如需跨區域推論的運作方式和受影響區域的詳細資訊，請參閱 [Apache Spark 故障診斷代理程式的跨區域處理](spark-troubleshooting-cross-region-processing.md)。