Google Vertex AI 凭据
使用 Google Vertex AI 凭据,通过服务账号、项目和区域将 n8n 连接到 Vertex AI。
您可以将这些凭据用于以下节点:
先决条件
- 一个 Google Cloud 账户。
- 一个已启用结算功能和 Vertex AI API (
aiplatform.googleapis.com) 的 Google Cloud 项目。请参阅 Google 的项目设置指南。 - 一个在该项目中有权访问 Vertex AI 的服务账号。请向服务账号授予
roles/aiplatform.user角色,或授予包含所需 Vertex 权限的自定义角色。请参阅 Google 的访问控制文档。 - 服务账号的 JSON key。您的 organization 必须允许使用服务账号 keys。请参阅创建服务账号 key。
服务账号可以属于其他项目。请在凭据中所选的项目内授予该账号 Vertex AI 权限。
支持的身份验证方式
- 服务账号 email 和 private key。
相关资源
有关该服务的更多信息,请参阅 Google 的 Vertex AI 文档。
使用服务账号
在 n8n 中创建 Google Vertex AI 凭据。打开服务账号的 JSON key 文件,然后填写以下字段:
| 字段 | 值 |
|---|---|
| Region 区域 | 支持您所用模型的位置。默认为 Global (multi-region) - global。请参阅 Google 的模型位置文档。 |
| Service Account Email 服务账号 email | JSON key 文件中的 client_email 值。 |
| Private Key 私钥 | JSON key 文件中完整的 private_key 值,包括 BEGIN PRIVATE KEY 和 END PRIVATE KEY 行。请省略外层 JSON 引号。 |
| Project 项目 | 选择列表中的项目,或选择 Custom 自定义并输入项目 ID。默认为 Custom 自定义。请先输入 email 和 private key,再加载列表。 |
| Project ID 项目 ID | Google Cloud 项目 ID,例如 my-project-id。当 Project 项目为 Custom 自定义时,此字段会显示。请使用项目 ID,而不是显示名称或项目编号。 |
选择 Save 保存以保存凭据。
选择项目
项目列表使用服务账号的访问权限,而不是你个人 Google 账户的权限。Google 会返回服务账号拥有 resourcemanager.projects.get 权限的项目。请参阅 Google 的项目搜索文档。
如果项目列表为空或加载失败,请选择 Custom 自定义并输入 Project ID 项目 ID。项目查找并非必需。服务账号仍需在所选项目中拥有 Vertex AI 访问权限。
项目出现在列表中并不代表它有权访问 Vertex 模型。仍需满足项目已启用的 APIs、权限和模型可用性要求。
在工作流中使用凭据
- 打开 Google Vertex Chat Model 或 Embeddings Google Vertex 节点。
- 将 Authentication 身份验证设为 Google Vertex AI。
- 选择您的 Google Vertex AI 凭据。
- 选择在项目和区域中可用的模型。
使用这种身份验证方式时,节点会从凭据读取项目。凭据还会提供默认区域。节点的 Region 区域设置可以覆盖凭据中的区域。
现有工作流可以继续使用 Google Service Account 身份验证。使用该方式时,项目仍在节点中配置。有关设置方法,请参阅 Google Service Account 凭据。
常见问题
项目查找失败
如果 Google 报告 Cloud Resource Manager API 已停用,请在错误中指定的项目内启用该 API。检查服务账号是否对要选择的项目拥有 resourcemanager.projects.get 权限。在解决查找权限问题期间,您可以使用 Custom 自定义项目输入方式。
Vertex 返回权限错误
检查服务账号在凭据所选项目中的角色。服务账号所属项目中的角色不会授予其访问其他项目的权限。还需为所选项目启用结算功能和 Vertex AI API。
模型不可用
检查模型是否支持凭据的 Region 区域或节点中覆盖设置的 Region 区域。有关支持的 endpoints,请参阅 Google 的模型位置文档。项目查找不会检查模型可用性。