此页面是排查 Gemini Enterprise Agent Platform 问题的起点。您可以使用它来诊断错误、查一查特定错误、查找任务指南或获取支持。
诊断错误
在寻找特定修复方法之前,请先收集以下信息:
读取错误
请记下状态代码(例如 400 或 429)和确切的消息文本。您可以在错误目录中查一查这两者。
您还可以通过机器可读的原因、文档链接或预过滤的日志视图(如果错误消息中包含这些内容)来确定具体故障。
查找日志
如需搜索和过滤代理错误日志,请使用 Logs Explorer,将资源类型设置为 Vertex AI Reasoning Engine,然后选择相应的资源容器值(您的项目编号)和推理引擎 ID 值。
查看配额和 Service Health
间歇性出现或在您未进行任何更改的情况下开始出现的错误通常是由配额或正在发生的突发事件引起的:
- 将您的用量与配额和系统限制进行比较。
- 查看 Google Cloud Service Health,了解您所在区域正在发生的突发事件。
错误目录
在下表中找到您收到的错误。首先按数字顺序列出具有状态代码的错误,然后按字母顺序列出其余错误。如果您的错误未列出,请使用您尝试完成的任务的问题排查指南。
| 状态代码或消息 | 解决方法 |
|---|---|
400、FAILED_PRECONDITION、REASONING_ENGINE_A2A_NOT_CONFIGURED |
未定义 A2A 方法 |
400、FAILED_PRECONDITION、REASONING_ENGINE_NO_RUNNING_INSTANCES |
代理没有正在运行的实例 |
400、FAILED_PRECONDITION、REASONING_ENGINE_REQUEST_TOO_LARGE |
请求载荷过大 |
400、INVALID_ARGUMENT、REASONING_ENGINE_BUILD_FAILED |
容器映像构建失败 |
400、INVALID_ARGUMENT、REASONING_ENGINE_CONTAINER_FAILED_TO_START |
容器未能启动 |
400、INVALID_ARGUMENT、REASONING_ENGINE_SECRET_ACCESS_DENIED、referenced by spec.deployment_spec.secret_env |
Secret Manager 访问错误 |
InvalidArgument: 400 Provided filter is not valid
|
过滤智能体列表时出错 |
401 Context-Aware Access requirements are not met、
401 Request had invalid authentication credentials |
401 授权错误 |
403 Forbidden(针对出站请求) |
“403 Forbidden”错误 |
403、PERMISSION_DENIED、REASONING_ENGINE_NOT_ACTIVE |
代理未处于活跃状态 |
404、NOT_FOUND、REASONING_ENGINE_NOT_FOUND |
找不到智能体 |
NotFound: 404 Can not copy from "gs://..."
|
Cloud Storage 存储桶子目录未创建 |
409、ABORTED、REASONING_ENGINE_AGENT_GATEWAY_CONCURRENT_PROVISION_ABORTED |
Agent Gateway 绑定已中止 |
413、Request Entity Too Large、Request payload
exceeds the 32 MiB maximum |
请求载荷过大 |
429、RESOURCE_EXHAUSTED
|
超出 API 速率限制或配额 |
429、RESOURCE_EXHAUSTED、at capacity
|
区域暂时容量不足 |
429、RESOURCE_EXHAUSTED、max_instances
|
实例数上限超出区域限制 |
429、RESOURCE_EXHAUSTED、REASONING_ENGINE_AGENT_GATEWAY_LOOKUP_THROTTLED |
Agent Gateway 查找受到限制 |
500 预构建模板出现内部服务器错误 |
预构建模板错误 |
500、INTERNAL、REASONING_ENGINE_PROVISIONING_FAILED |
环境预配失败 |
503、UNAVAILABLE、REASONING_ENGINE_AGENT_GATEWAY_PROVISION_UNAVAILABLE
|
Agent Gateway 绑定暂时不可用 |
504、DEADLINE_EXCEEDED、REASONING_ENGINE_AGENT_GATEWAY_PROVISION_TIMEOUT |
Agent Gateway 绑定超时 |
504、DEADLINE_EXCEEDED、REASONING_ENGINE_BUILD_TIMEOUT |
容器映像构建超时 |
504、DEADLINE_EXCEEDED、REASONING_ENGINE_CONTAINER_START_TIMEOUT |
容器未及时启动 |
| 到达自签名或私有 CA 目标位置时证书验证失败 | 自签名或私有 CA 目标无法连接 |
序列化代理时出现 cloudpickle 或 pydantic 版本冲突 |
序列化错误 |
| 代码执行超时,沙盒中发生文件 I/O 故障 | 代码执行问题 |
来自.operation_schemas()的空列表
|
操作架构为空 |
failed to start and cannot serve traffic 或 Request is prohibited by organization's policy,位于 VPC Service Controls 边界内 |
VPC-SC 违规错误 |
failed to start and cannot serve traffic,在某个区域中首次部署自定义容器 (BYOC) 时 |
BYOC 首次创建错误 |
google.api_core.exceptions.Unknown: None,
Failed to convert project number to project ID,
在启动期间 |
Agent Runtime 启动期间出错 |
iam.serviceAccounts.actAs 被拒,元数据服务器不可用 |
自定义服务账号错误 |
ImportError: cannot import name 'reasoning_engines'、ImportError: cannot import name 'agent_engines' |
Agent Platform SDK for Python 版本过时 |
查询代理时出现 PermissionDenied 错误
|
查询代理时出现 PermissionDenied 错误 |
Reasoning Engine Execution failed
|
推理引擎执行失败 |
RuntimeError: Failed to generate memory,或会话结束后未返回任何记忆 |
未生成任何回忆 |
| 沙盒创建失败 | 沙盒创建问题 |
| 自定义容器 (BYOC) 代理的 TLS 握手失败 | 使用自定义容器 (BYOC) 部署的智能体无法连接 |
ValueError: Cannot get the Candidate text
|
内容生成错误 |
问题排查指南
如果您没有收到特定的出错提示,或者您的错误不在错误目录中,请参阅下表,了解任务的相应指南:
| 任务 | 指南 |
|---|---|
| 安装 Agent Platform SDK 并设置环境 | Agent Runtime 环境设置 |
| 正在创建智能体 | 创建代理 |
| 将智能体部署到 Agent Runtime | 代理部署 |
| 使用已部署的代理 | 使用智能体 |
| 从代理调用外部服务 | Agent Gateway 连接 |
| 列出、更新或删除已部署的代理 | 管理已部署的智能体 |
| 在沙盒中运行代码 | 代码执行 |
| 正在生成或检索记忆 | Agent Platform 记忆库 |
| 应用模型或达到模型配额 | 排查机器学习服务问题 |
获取支持
如果本页面上的指南无法解决您的问题,请参阅获取代理帮助,了解支持服务包、社区论坛和 bug 报告。如需了解结算问题,请参阅结算问题。
如果您提交 bug,请提供以下信息:
- 状态代码
- 出错提示
- (可选)如果出错提示有误、具有误导性或无法操作,请提供反馈。