MODEL DDL statements and ML functions in Spanner invoke Gemini Enterprise Agent Platform endpoints and can fail due to various reasons:
| Error Code | Error Message | Possible cause | Possible solution |
|---|---|---|---|
|
CANCELLED
|
Call to Agent Platform endpoint {ENDPOINT} was cancelled due to query cancellation.
|
Query was cancelled by the client application. | Investigate why your client cancelled the query. |
|
DEADLINE_EXCEEDED
|
Agent Platform endpoint {ENDPOINT} exceeded the call deadline.
|
Query deadline is too short. | Increase query deadline on the client. |
|
-
|
- | Endpoint was too busy. | See Agent Platform monitoring and deploy more nodes. |
|
FAILED_PRECONDITION
|
Agent Platform endpoint {ENDPOINT} returned failed precondition error.
|
Endpoint has no models deployed. | Deploy models to the endpoint. |
|
INTERNAL
|
Unknown error when accessing Agent Platform endpoint {ENDPOINT}.
|
Unexpected internal error. | Use failover endpoints or open a support ticket. |
|
INVALID_ARGUMENT
|
Invalid request to Agent Platform endpoint {ENDPOINT}.
Make sure that Agent Platform endpoint and Spanner model schema match.
|
Spanner model schema and Agent Platform endpoint schema do not match | Update Spanner model's schema. |
|
NOT_FOUND
|
Agent Platform endpoint {ENDPOINT} not found.
|
Endpoint was deleted. | Update Spanner model's schema. |
|
PERMISSION_DENIED
|
Access to Agent Platform endpoint {ENDPOINT} was denied.
|
Spanner service agent does not have permissions to access the endpoint | Grant service agent role permissions |
|
-
|
-
|
VPC SC error | See Agent Platform error message and follow VPC SC troubleshooting |
|
RESOURCE_EXHAUSTED
|
Agent Platform endpoint {ENDPOINT} quota has been exceeded.
|
Too many requests to Agent Platform. | Increase online prediction quota |
|
UNAVAILABLE
|
Could not create service agent for project {PROJECT}.
|
Service Usage API issue. | Create service agent manually |
|
-
|
Agent Platform endpoint {ENDPOINT} is unavailable.
|
Too many requests to Agent Platform. | Deploy more nodes. |
|
-
|
- | Agent Platform has a regional issue | Use failover endpoints |
google.rpc.Status
details messages
.
For more information, see the following:
- Troubleshoot environment setup for Agent Runtime
- Troubleshoot creating an agent using Agent Runtime
- Troubleshoot managing deployed agents for Agent Runtime
- Code execution troubleshooting
- Troubleshooting Agent Platform Memory Bank
