Skip to main content

在itBuilder中使用GCP Vertex AI

itBuilder支持通过Google Cloud Platform的Vertex AI访问模型,这是一个托管机器学习平台,提供对各种基础模型的访问,包括Anthropic的Claude系列模型。

官网: https://cloud.google.com/vertex-ai


先决条件

  • Google Cloud账户: 需要一个活跃的Google Cloud Platform(GCP)账户。
  • 项目: 需要一个启用了Vertex AI API的GCP项目。
  • 模型访问权限: 必须申请并获得Vertex AI上您想使用的特定Claude模型的访问权限。请参阅Google Cloud文档获取说明。
  • 应用默认凭据(ADC): itBuilder使用应用默认凭据与Vertex AI进行认证。最简单的设置方式是:
    1. 安装Google Cloud CLI: https://cloud.google.com/sdk/docs/install
    2. 使用以下命令认证: gcloud auth application-default login
  • 服务账户密钥(替代方案): 或者,您可以使用Google Cloud服务账户密钥文件进行认证。您需要在GCP项目中生成此密钥。请参阅Google Cloud关于创建服务账户密钥的文档

支持的模型

itBuilder通过Vertex AI支持以下模型(基于源代码):

  • Google Gemini模型:
    • gemini-2.5-flash-preview-05-20
    • gemini-2.0-flash-001
    • gemini-2.5-pro-exp-03-25
    • gemini-2.0-pro-exp-02-05
    • gemini-2.0-flash-lite-001
    • gemini-2.0-flash-thinking-exp-01-21
    • gemini-1.5-flash-002
    • gemini-1.5-pro-002
  • Anthropic Claude模型:
    • claude-opus-4@20250514:thinking
    • claude-opus-4@20250514
    • claude-sonnet-4@20250514:thinking
    • claude-sonnet-4@20250514
    • claude-3-7-sonnet@20250219:thinking
    • claude-3-7-sonnet@20250219
    • claude-3-5-sonnet-v2@20241022
    • claude-3-5-sonnet@20240620
    • claude-3-5-haiku@20241022
    • claude-3-opus@20240229
    • claude-3-haiku@20240307

请参阅Google Cloud关于Vertex AI模型的文档获取最新可用模型列表及其ID。


在itBuilder中配置

  1. 打开itBuilder设置: 点击itBuilder面板中的齿轮图标()。
  2. 选择提供商: 从"API提供商"下拉菜单中选择"GCP Vertex AI"。
  3. 配置认证:
    • 如果使用应用默认凭据(ADC): 此处无需进一步操作。如果配置正确(见先决条件),ADC将自动使用。
    • 如果不使用ADC(服务账户密钥):
      • 选项A: 粘贴JSON内容: 将服务账户JSON密钥文件的全部内容粘贴到Google Cloud凭据字段。
      • 选项B: 提供文件路径:Google Cloud密钥文件路径字段中输入下载的服务账户JSON密钥文件的绝对路径。
  4. 输入项目ID: 输入您的Google Cloud项目ID。
  5. 选择区域: 选择您的Vertex AI资源所在的区域(例如us-east5)。
  6. 选择模型: 从"模型"下拉菜单中选择所需模型。

提示和注意事项

  • 权限: 确保您的Google Cloud账户具有访问Vertex AI和您想使用的特定模型所需的权限。
  • 定价: 请参阅Vertex AI定价页面了解详情。