排查 Gemini Enterprise Agent Platform 问题

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

诊断错误

在寻找具体修复方法之前，请先收集以下信息：

阅读错误

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

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

查找日志

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

检查配额和 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 首次创建错误
VPC Service Controls 边界内的 failed to start and cannot serve traffic 或 Request is prohibited by organization's policy VPC-SC 违规错误
429、RESOURCE_EXHAUSTED 资源耗尽或速率限制错误
429、RESOURCE_EXHAUSTED、at capacity 区域暂时容量不足
429、RESOURCE_EXHAUSTED、max_instances 实例数上限超出区域限制
预构建模板出现 500 内部服务器错误 预构建模板错误
序列化代理时出现 cloudpickle 或 pydantic 版本冲突 序列化错误
NotFound: 404 Can not copy from "gs://..." Cloud Storage 存储桶子目录未创建
iam.serviceAccounts.actAs 被拒，元数据服务器不可用 自定义服务账号错误
400、INVALID_ARGUMENT、REASONING_ENGINE_SECRET_ACCESS_DENIED、referenced by spec.deployment_spec.secret_env Secret Manager 访问错误
504、DEADLINE_EXCEEDED、REASONING_ENGINE_BUILD_TIMEOUT 容器映像构建超时
504、DEADLINE_EXCEEDED、REASONING_ENGINE_CONTAINER_START_TIMEOUT 容器未及时启动
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
应用模型或达到模型配额 排查机器学习服务问题

获取支持

如果本页上的指南无法解决您的问题，请参阅获取代理帮助，了解支持服务包、社区论坛和 bug 报告。如需了解结算问题，请参阅结算问题。

如果您提交 bug，请提供以下信息：

  • 状态代码
  • 出错提示
  • （可选）如果出错提示有误、具有误导性或无法执行，请提供反馈。