在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进行认证。最简单的设置方式是:
- 安装Google Cloud CLI: https://cloud.google.com/sdk/docs/install
- 使用以下命令认证:
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中配置
- 打开itBuilder设置: 点击itBuilder面板中的齿轮图标()。
- 选择提供商: 从"API提供商"下拉菜单中选择"GCP Vertex AI"。
- 配置认证:
- 如果使用应用默认凭据(ADC): 此处无需进一步操作。如果配置正确(见先决条件),ADC将自动使用。
- 如果不使用ADC(服务账户密钥):
- 选项A: 粘贴JSON内容: 将服务账户JSON密钥文件的全部内容粘贴到Google Cloud凭据字段。
- 选项B: 提供文件路径: 在Google Cloud密钥文件路径字段中输入下载的服务账户JSON密钥文件的绝对路径。
- 输入项目ID: 输入您的Google Cloud项目ID。
- 选择区域: 选择您的Vertex AI资源所在的区域(例如
us-east5
)。 - 选择模型: 从"模型"下拉菜单中选择所需模型。
提示和注意事项
- 权限: 确保您的Google Cloud账户具有访问Vertex AI和您想使用的特定模型所需的权限。
- 定价: 请参阅Vertex AI定价页面了解详情。