设置环境

在 Vertex AI 中使用 LangChain 之前，您需要确保环境已设置完毕。您需要有启用了结算功能的 Google Cloud 项目，具有所需的权限，设置 Cloud Storage 存储桶，并安装 Vertex AI SDK for Python。请参阅以下主题，确保准备好开始在 Vertex AI 中使用 LangChain。

设置您的 Google Cloud 项目

登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

转到“项目选择器”

确保您的 Google Cloud 项目已启用结算功能。

启用 Vertex AI and Cloud Storage API。

启用 API

在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

转到“项目选择器”

确保您的 Google Cloud 项目已启用结算功能。

启用 Vertex AI and Cloud Storage API。

启用 API

启用 Vertex AI API

启用以下 API：Vertex AI、Cloud Storage。

启用 API

获取所需角色

如需获得使用推理引擎所需的权限，请让您的管理员为您授予项目的以下 IAM 角色：

Vertex AI User (roles/aiplatform.user)
Storage Admin (roles/storage.admin)

如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

设置您的服务代理权限

您在推理引擎上部署的应用会以 AI Platform Reasoning Engine Service Agent 服务账号的身份运行。此账号具有 Vertex AI Reasoning Engine Service Agent 角色，可授予推理引擎应用所需的基本权限。如需查看基本权限的完整列表，请参阅 IAM 文档。

如果您需要其他权限，可以通过执行以下步骤来向此 Service Agent 授予其他角色：

进入 IAM 页面，然后选中“包括 Google 提供的角色授权”复选框。

进入 IAM
查找与 service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com 匹配的主账号。
依次点击修改按钮和保存按钮，为主账号添加所需的角色。

创建 Cloud Storage 存储桶

推理引擎会在部署过程中将应用的制品暂存在 Cloud Storage 存储桶中。确保已通过身份验证以使用 Vertex AI 的主账号（您自己或服务账号）对此存储桶具有 Storage Admin 访问权限。这是因为 Vertex AI SDK for Python 会打包您的代码并将其写入此存储桶。

Google Cloud 控制台

在 Google Cloud 控制台中，进入 Cloud Storage 存储桶页面。
进入“存储桶”页面
点击创建存储分区。
在创建存储分区页面上，输入您的存储分区信息。要转到下一步，请点击继续。
- 在指定存储分区的名称中，输入符合存储分区命名要求的名称。
- 对于选择数据存储位置，执行以下操作：
  - 选择位置类型选项。
  - 选择位置选项。
- 对于为数据选择一个默认存储类别，请选择一个存储类别。
- 对于选择如何控制对象的访问权限，请选择访问权限控制选项。
- 对于高级设置（可选），请指定加密方法、保留政策或存储分区标签。
点击创建。

命令行

将 STORAGE_CLASS 替换为您偏好的存储类别。
将 LOCATION 替换为您偏好的位置（ASIA、EU 或 US）
将 BUCKET_NAME 替换为符合存储分区名称要求的存储分区名称。

gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

安装并初始化 Python 版 Vertex AI SDK

运行以下命令以安装 Vertex AI SDK for Python 推理引擎软件包：

pip install google-cloud-aiplatform[reasoningengine,langchain]

运行以下代码，以导入并初始化适用于 Reasoning Engine 的 SDK：

import vertexai
from vertexai.preview import reasoning_engines

vertexai.init(
    project="PROJECT_ID",
    location="LOCATION",
    staging_bucket="gs://BUCKET_NAME",
)

PROJECT_ID：您的项目 ID。
LOCATION：您的区域。目前只支持 us-central1。
BUCKET_NAME：您的 Google Cloud 存储桶。

后续步骤

开发应用。