排解 Gemini Enterprise Agent Platform 問題

本頁面是排解 Gemini Enterprise Agent Platform 問題的起點。您可以使用這個頁面診斷錯誤、查詢特定錯誤、尋找工作指南或取得支援。

診斷錯誤

尋找特定修正方法前，請先收集下列資訊：

讀取錯誤

記下狀態碼 (例如 400 或 429) 和確切的訊息文字。您可以在錯誤目錄中查詢這兩項資訊。

如果錯誤訊息中包含機器可讀的原因、說明文件連結或預先篩選的記錄檢視畫面，您也可以從中找出具體失敗原因。

尋找記錄

如要搜尋及篩選代理錯誤記錄，請使用記錄檔探索工具，將「Resource type」(資源類型) 設為「Vertex AI Reasoning Engine」，然後選取對應的「Resource container」(資源容器) 值 (專案編號) 和「Reasoning engine ID」(推論引擎 ID) 值。

查看配額和 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 內容生成錯誤
在某個區域首次部署自訂容器 (BYOC) 時，可獲得 failed to start and cannot serve traffic BYOC 首次建立錯誤
VPC Service Controls 範圍內的 failed to start and cannot serve traffic 或 Request is prohibited by organization's policy 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 存取錯誤
504、DEADLINE_EXCEEDED、REASONING_ENGINE_BUILD_TIMEOUT 容器映像檔建構作業逾時
504、DEADLINE_EXCEEDED、REASONING_ENGINE_CONTAINER_START_TIMEOUT 容器未及時啟動
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 禁止錯誤
憑證驗證失敗，無法連至自行簽署或私人 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
提供模型或達到模型配額 機器學習服務疑難排解

取得支援

如果本頁面的指南無法解決問題，請參閱「取得代理程式相關協助」，瞭解支援套件、社群論壇和錯誤報告。如有帳單問題，請參閱「帳單問題」。

提交錯誤時，請提供下列資訊：

  • 狀態碼
  • 錯誤訊息
  • (選用) 如果錯誤訊息有誤、具誤導性或無法採取行動，請提供意見回饋。