Vertex AI
本文介绍如何在 OmniAgent 中配置 Vertex AI 模型服务。
1. 准备 GCP 项目
- 创建项目: 获取 Vertex AI 权限前,您需要有一个 Google Cloud 项目。如无项目,请进入 Google Cloud 控制台 创建。

2 开通 API: 进入 Vertex AI 控制台,在您的项目中开通 Vertex AI API。

2. 设置凭据 (Service Account)
Vertex AI 使用服务账号进行身份验证,而非简单的 API Key。
- 创建服务账号: 打开 IAM 与管理 -> 服务账号 页面,点击 创建服务账号。

2 生成密钥:
- 在列表中找到刚创建的账号,点击进入详情。
- 切换到 密钥 (Keys) 页签,点击 添加密钥 -> 创建新密钥。
- 选择 JSON 格式。

3保存文件: 创建成功后,包含凭据的 JSON 文件将自动下载到您的电脑。请妥善保存该文件,切勿泄露。
3. 在 OmniAgent 中配置
-
打开 OmniAgent 的 API Key 管理 页面。
-
点击 + 新增 API 密钥,选择提供商 其他。
-
配置信息:
- 模型名称: 填写您的模型标识。
- API Key (密钥): 粘贴您从 JSON 文件中获取的相关凭据(Private Key 内容)。
- Base URL (地址): 通常填写您的中转地址,或根据 API 调用区域填写。

常用服务商 Base URL 参考
如需填写 Base URL,可参考下表选择对应服务商地址:
| 服务商 | Base URL | 推荐模型 |
|---|---|---|
| Qwen | https://dashscope.aliyuncs.com/apps/anthropic | qwen3.5-plus |
| DeepSeek | https://api.deepseek.com/anthropic | deepseek-chat |
| Kimi | https://api.moonshot.ai/anthropic | kimi-k2.5 |
| GLM | https://open.bigmodel.cn/api/anthropic | GLM-4.7 |
| MiniMax | https://api.minimax.com/anthropic | MiniMax-M2.5 |
| Anthropic | https://api.anthropic.com/v1 | claude-sonnet-4-6 |
注意事项
- 网络代理: 中国大陆地区无法直接连接 Vertex AI API,建议配置有效的全局代理或 API 中转地址。
- 模型库: 您可以在 Model Garden 中浏览和部署更多可用的模型。
Private Key 包含完整访问权限,请确保 JSON 文件不被上传至任何公开代码仓库。