排解 Spanner Agent Platform 整合問題

Spanner 中的 MODEL DDL 陳述式和 ML 函式會叫用 Gemini Enterprise Agent Platform 端點，但可能會因各種原因而失敗：

錯誤代碼 錯誤訊息 可能原因 可能的解決方案
已取消 Call to Agent Platform endpoint {ENDPOINT} was cancelled due to query cancellation. 用戶端應用程式已取消查詢。 調查用戶端取消查詢的原因。
DEADLINE_EXCEEDED Agent Platform endpoint {ENDPOINT} exceeded the call deadline. 查詢期限過短。 在用戶端增加查詢截止時間。
- - 端點過於忙碌。 請參閱 Agent Platform 監控，並部署更多節點。
FAILED_PRECONDITION Agent Platform endpoint {ENDPOINT} returned failed precondition error. 端點未部署任何模型。 將模型部署至端點。
INTERNAL Unknown error when accessing Agent Platform endpoint {ENDPOINT}. 發生未預期的內部錯誤。 使用容錯移轉端點或建立支援單。
INVALID_ARGUMENT Invalid request to Agent Platform endpoint {ENDPOINT}. Make sure that Agent Platform endpoint and Spanner model schema match. Spanner 模型結構定義與 Agent Platform 端點結構定義不符 更新 Spanner 模型的結構定義。
NOT_FOUND Agent Platform endpoint {ENDPOINT} not found. 已刪除端點。 更新 Spanner 模型的結構定義。
PERMISSION_DENIED Access to Agent Platform endpoint {ENDPOINT} was denied. Spanner 服務代理人沒有存取端點的權限 授予服務代理角色權限
- - VPC SC 錯誤 請參閱 Agent Platform 錯誤訊息，並按照 VPC SC 疑難排解步驟操作。
RESOURCE_EXHAUSTED Agent Platform endpoint {ENDPOINT} quota has been exceeded. 對 Agent Platform 提出的要求過多。 提高線上預測配額
UNAVAILABLE Could not create service agent for project {PROJECT}. Service Usage API 問題。 手動建立服務代理
- Agent Platform endpoint {ENDPOINT} is unavailable. 對 Agent Platform 提出的要求過多。 部署更多節點。
- - Agent Platform 發生區域性問題 使用容錯移轉端點

Spanner 傳回的錯誤包括原始的 Agent Platform 錯誤，以google.rpc.Status 詳細資料訊息的形式呈現。 詳情請參閱下列說明：

Spanner 和 Agent Platform 都提供監控資訊主頁，並將記錄寫入 Cloud Logging，其中可能包含其他詳細資料。