本页是 Gemini Enterprise Agent Platform 问题排查的起点。您可以使用本页 诊断错误、查找特定错误、 查找任务指南或获取 支持。
诊断错误
在查找特定修复方案之前，请收集以下信息：
阅读错误
记下状态代码（例如 400 或 429）和确切的消息文本。您可以在错误目录中查找这两项信息。
如果错误消息中包含机器可读的原因、文档链接或预过滤的日志视图，您还可以从中识别出具体失败。
查找日志
如需搜索和过滤代理错误日志，请使用 Logs Explorer，将 资源类型设置为 Vertex AI Reasoning Engine，然后选择相应的 资源容器值（您的项目编号）和 Reasoning Engine ID值。
检查配额和服务健康状况
间歇性出现的错误或在您未进行任何更改的情况下开始出现的错误通常是由配额或正在发生的突发事件引起的：
- 将您的使用情况与配额和系统 限制进行比较。
- 检查Google Cloud 服务健康状况 ，了解您所在区域是否发生了突发事件。
错误目录
在下表中查找您收到的错误。如果您的错误未列出， 请使用您尝试完成的任务的问题排查指南。
| 状态代码或消息 | 解决方法 |
|---|---|
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
|
内容生成错误 |
在区域中首次部署自定义容器 (BYOC) 时出现 failed to start and cannot serve traffic |
BYOC 首次创建错误 |
failed to start and cannot serve traffic 或
Request is prohibited by organization's policy,
在 VPC Service Controls 边界内 |
VPC-SC 违规错误 |
429、 RESOURCE_EXHAUSTED
|
资源耗尽或速率限制错误 |
预构建模板出现 500 内部服务器错误 |
预构建模板错误 |
序列化代理时出现 cloudpickle 或 pydantic 版本冲突 |
序列化错误 |
NotFound: 404 Can not copy from "gs://..."
|
Cloud Storage 存储桶子目录未创建 |
iam.serviceAccounts.actAs 被拒绝，元数据服务器不可用 |
自定义服务帐号错误 |
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 报告。如需了解结算问题，请参阅结算 问题。
- 状态代码
- 错误消息
- （可选）反馈，说明错误消息是否错误、具有误导性或无法采取行动。