此页面是 Gemini Enterprise Agent Platform 问题排查的起点。您可以使用它来诊断错误、查找特定错误、查找任务指南或获取支持。
诊断错误
在寻找特定修复方案之前，请收集以下信息：
读取错误
记下状态代码（例如 400 或 429）和确切的消息文本。您可以在错误目录中查找这两者。
如果错误消息中包含机器可读的原因、文档链接或预过滤的日志视图，您还可以通过这些信息来确定具体故障。
查找日志
如需搜索和过滤代理错误日志，请使用 Logs Explorer，将资源类型设置为 Vertex AI Reasoning Engine，然后选择相应的资源容器值（您的项目编号）和推理引擎 ID 值。
检查配额和服务健康状况
间歇性出现的错误或在您未进行任何更改的情况下开始出现的错误通常是由配额或正在发生的突发事件引起的：
- 将您的用量与配额和系统限制进行比较。
- 查看Google Cloud 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 首次创建错误 |
failed to start and cannot serve traffic 或 Request is prohibited by organization's policy，位于 VPC Service Controls 边界内 |
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 访问权限错误 |
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，请提供以下信息：
- 状态代码
- 出错提示
- （可选）如果错误消息有误、具有误导性或无法据此采取行动，请提供反馈。