排查 Gemini Enterprise Agent Platform 问题

此页面是排查 Gemini Enterprise Agent Platform 问题的起点。您可以使用它来诊断错误、查一查特定错误、查找任务指南或获取支持。

诊断错误

在寻找特定修复方法之前,请先收集以下信息:

读取错误

请记下状态代码(例如 400 或 429)和确切的消息文本。您可以在错误目录中查一查这两者。

您还可以通过机器可读的原因、文档链接或预过滤的日志视图(如果错误消息中包含这些内容)来确定具体故障。

查找日志

如需搜索和过滤代理错误日志,请使用 Logs Explorer,将资源类型设置为 Vertex AI Reasoning Engine,然后选择相应的资源容器值(您的项目编号)和推理引擎 ID 值。

查看配额和 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,请提供以下信息:

  • 状态代码
  • 出错提示
  • (可选)如果出错提示有误、具有误导性或无法操作,请提供反馈。