這個頁面是排解 Gemini Enterprise Agent Platform 問題的起點。你可以使用這項工具診斷錯誤、查詢特定錯誤、尋找工作指南，或取得支援。
診斷錯誤
尋找特定修正方式前，請先收集下列資訊：
閱讀錯誤訊息
請記下狀態碼 (例如 400 或 429) 和確切的訊息文字。您可以在錯誤目錄中查詢這兩項資訊。
如果錯誤訊息中包含機器可讀取的原因、文件連結或預先篩選的記錄檢視畫面，您也可以從中找出具體失敗原因。
尋找記錄
如要搜尋及篩選代理程式錯誤記錄，請使用 Logs Explorer，將資源類型設為Vertex AI 推論引擎，然後選取對應的資源容器值 (專案編號) 和推論引擎 ID值。
檢查配額和服務健康狀態
間歇性出現的錯誤，或是您未進行任何變更就開始出現的錯誤，通常是由配額或持續發生的事件所導致：
- 比較用量與配額和系統限制。
- 查看Google Cloud Service Health，瞭解您所在區域是否發生事件。
錯誤目錄
請在下表中找出您收到的錯誤訊息。如果錯誤未列出，請使用疑難排解指南，瞭解如何完成您嘗試執行的工作。
| 狀態碼或訊息 | 解析度 |
|---|---|
ImportError: cannot import name 'reasoning_engines',
ImportError: cannot import name 'agent_engines' |
Agent Platform SDK for Python 版本過舊 |
401 Context-Aware Access requirements are not met,
401 Request had invalid authentication credentials |
401 授權錯誤 |
ValueError: Cannot get the Candidate text
|
內容生成錯誤 |
failed to start and cannot serve traffic，在區域中首次部署自訂容器 (BYOC) 時 |
BYOC 首次建立錯誤 |
failed to start and cannot serve traffic 或
Request is prohibited by organization's policy，
位於 VPC Service Controls 範圍內 |
VPC-SC 違規錯誤 |
429、RESOURCE_EXHAUSTED
|
資源耗盡或速率限制錯誤 |
429、RESOURCE_EXHAUSTED、at capacity |
區域暫時達到容量上限 |
429、RESOURCE_EXHAUSTED、max_instances |
執行個體數量上限超過區域限制 |
500 預先建構的範本發生內部伺服器錯誤 |
預建範本錯誤 |
序列化代理時發生 cloudpickle 或 pydantic 版本衝突 |
序列化錯誤 |
NotFound: 404 Can not copy from "gs://..."
|
Cloud Storage bucket 子目錄未建立 |
iam.serviceAccounts.actAs 遭拒，中繼資料伺服器無法使用 |
自訂服務帳戶錯誤 |
400、INVALID_ARGUMENT、
REASONING_ENGINE_SECRET_ACCESS_DENIED、
referenced by spec.deployment_spec.secret_env |
Secret Manager 存取權錯誤 |
InvalidArgument: 400 Provided filter is not valid
|
篩選代理程式清單時發生錯誤 |
google.api_core.exceptions.Unknown: None,
Failed to convert project number to project ID,
啟動期間 |
Agent Runtime 啟動期間發生錯誤 |
403 Forbidden 傳出要求 |
403 Forbidden 錯誤 |
| 憑證驗證失敗，抵達自簽或私人 CA 目的地 | 自行簽署或私人 CA 目的地無法連線 |
| 自訂容器 (BYOC) 代理程式的 TLS 握手失敗 | 使用自訂容器 (BYOC) 部署的代理程式無法連線 |
| 沙箱建立失敗 | 沙箱建立問題 |
| 沙箱中的執行程式碼逾時、檔案 I/O 失敗 | 執行程式碼問題 |
RuntimeError: Failed to generate memory，或工作階段後未傳回任何回憶集錦 |
未生成任何回憶集錦 |
疑難排解指南
如果沒有收到特定錯誤訊息，或錯誤訊息不在錯誤目錄中，請參閱下表，瞭解對應工作適用的指南：
| 工作 | 指南 |
|---|---|
| 安裝 Agent Platform SDK 並設定環境 | 設定 Agent Runtime 環境 |
| 建立代理 | 建立代理 |
| 將代理部署至 Agent Runtime | 代理程式部署 |
| 服務專員呼叫外部服務 | Agent Gateway 連線 |
| 列出、更新或刪除已部署的代理程式 | 管理已部署的代理程式 |
| 在沙箱中執行程式碼 | 執行程式碼 |
| 生成或擷取記憶 | Agent Platform Memory Bank |
| 提供模型或達到模型配額 | 排解機器學習服務問題 |
取得支援
如果這個頁面的指南無法解決問題，請參閱「取得代理商的協助」，瞭解支援方案、社群論壇和錯誤回報。如要瞭解帳單問題，請參閱帳單問題。
如果回報錯誤，請提供下列資訊：
- 狀態碼
- 錯誤訊息
- (選用) 如果錯誤訊息有誤、誤導或無法據以採取行動，請提供意見回饋。