n8n 中文文档

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、权限和模型可用性要求。

在工作流中使用凭据

  1. 打开 Google Vertex Chat Model 或 Embeddings Google Vertex 节点。
  2. 将 Authentication 身份验证设为 Google Vertex AI。
  3. 选择您的 Google Vertex AI 凭据。
  4. 选择在项目和区域中可用的模型。

使用这种身份验证方式时,节点会从凭据读取项目。凭据还会提供默认区域。节点的 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 的模型位置文档。项目查找不会检查模型可用性。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。