這個頁面是排解 Gemini Enterprise Agent Platform 問題的起點。你可以使用這項工具診斷錯誤、查詢特定錯誤、尋找工作指南或取得支援。
診斷錯誤
尋找特定修正方式前，請先收集下列資訊：
閱讀錯誤訊息
請記下狀態碼 (例如 400 或 429) 和確切的訊息文字。您可以在錯誤目錄中查詢這兩項資訊。
如果錯誤訊息中包含機器可讀取的原因、文件連結或預先篩選的記錄檢視畫面，您也可以從中找出具體失敗原因。
尋找記錄
如要搜尋及篩選代理程式錯誤記錄，請使用記錄檢視器，將「資源類型」設為「Vertex AI Reasoning Engine」，然後選取對應的「資源容器」值 (您的專案編號) 和「Reasoning Engine 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
|
資源用盡或達到頻率限制錯誤 |
500 預先建構的範本發生內部伺服器錯誤 |
預先建構的範本錯誤 |
cloudpickle或 pydantic 版本衝突，導致代理程式序列化失敗 |
序列化錯誤 |
NotFound: 404 Can not copy from "gs://..."
|
Cloud Storage bucket 子目錄未建立 |
iam.serviceAccounts.actAs 遭拒，中繼資料伺服器無法使用 |
自訂服務帳戶錯誤 |
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 |
| 提供模型或達到模型配額 | 排解機器學習服務問題 |
取得支援
如果這個頁面的指南無法解決問題，請參閱「取得客服人員的協助」，瞭解支援方案、社群論壇和錯誤回報。如有帳單相關問題，請參閱帳單問題。
如要回報錯誤，請提供下列資訊：
- 狀態碼
- 錯誤訊息
- (選用) 如果錯誤訊息有誤、誤導或無法採取行動，請提供意見。