区域化和位置设置

创建代理时，您必须指定区域作为代理的位置。发送到您代理的请求将由该区域中的 Google 服务处理， 对话代理 (Dialogflow CX) 可保留静态数据 位于地理区域或位置内。 为了获得最佳性能，您应该选择靠近您的服务和最终用户的区域。

代理创建后，其位置便无法更改。如需更改代理的位置，您必须在另一个位置导出和恢复为新代理。

每个位置都有关联的设置，这些设置应用于整个项目。在大多数情况下，您无需修改这些位置设置，默认设置即可运行良好。如果您的系统需要客户管理的加密密钥（通常政府机构或受监管的行业有此要求），请详细了解位置设置。

限制

存在以下限制：

• 不同电话集成的区域支持可能会有所不同。请查看每项集成的文档。

• 系统实体支持因语言而异。请参阅 系统实体限制 了解详情。

• API Explorer 可在许多 REST 参考文档中找到，但仅支持 global 区域的 API 调用。

可用区域

重要提示：如果您向美国的区域级可用 API 发出请求，则生成式模型的机器学习 (ML) 处理会在美国进行；如果您向欧洲的区域级可用 API 发出请求，则上述处理会在欧盟进行。如需详细了解受支持的区域，请参阅 Vertex AI 文档。

对话代理 (Dialogflow CX) 支持以下区域的代理位置。 数据存储区代理支持其中的部分区域，并且数据存储区使用的区域 ID 与代理区域略有不同。具有“数据存储地区 ID”列值的所有区域 Vertex AI Conversation 中的数据存储区代理支持此功能。

国家/地区分组	地理位置	代理地区 ID	数据存储区地区 ID
美洲	爱荷华	us-central1	us（多区域）
美洲	蒙特利尔	northamerica-northeast1
美洲	南卡罗来纳	us-east1
美洲	俄勒冈	us-west1
美洲	美国多区域	us *	us（多区域）*
欧洲	比利时	europe-west1	eu（多区域）
欧洲	伦敦	europe-west2
欧洲	法兰克福	europe-west3
亚太地区	悉尼	australia-southeast1
亚太地区	东京	asia-northeast1
亚太地区	孟买	asia-south1
亚太地区	新加坡	asia-southeast1
全球	全球多区域（全球服务，美国的静态数据）	global（首选）或无区域（默认）	global（多区域）¶

符号	说明
*	Vertex AI 不支持“us”多区域位置因此，在“us”多区域中使用对话式 AI 助理 (Dialogflow CX) 的生成式 AI 功能将依赖于相应的现有美国单区域端点。
¶	从美国以外区域调用时，global 区域的延迟时间可能更长。如果可能，请选择更接近您的服务和最终用户的更具体区域。

如需详细了解 Google Cloud 使用的区域，请参阅 Google Cloud 区域和 Google Cloud 地理位置和区域。

位置信息设置

如果您的系统需要客户管理的加密密钥（通常政府机构或受监管的行业有此要求），您可以使用位置设置来配置此功能。

位置设置在项目之间共享，每个唯一位置都有自己的位置设置。为项目配置特定位置的设置后，您将无法更改该位置的设置。如果您需要更改这些设置，则必须创建一个新项目。

如果您在不修改位置设置的情况下创建代理，系统会为该位置配置默认设置，并且您无法为项目修改这些设置。此外，代理一旦创建，其位置便无法更改。如需更改代理的位置，您必须在另一个位置导出和恢复为新代理。

您可以使用以下位置设置：

• 加密：此设置控制是使用 Google 管理的加密密钥还是客户管理的加密密钥来保护数据。默认使用 Google 管理的加密密钥。如果要更改此设置，您必须联系 Google 代表申请客户管理的加密密钥功能的访问权限。

您可以通过以下两种方式配置位置设置：

• 在代理选择器界面中点击位置设置 (Location settings)。
• 在创建代理时，点击位置下拉列表旁边的修改按钮。

注意： 目前，您不能使用该 API 更新位置信息设置。

使用 API 指定区域

您必须为所有 API 请求指定区域。

对于 REST 调用，您必须执行以下两项操作：

• 为 location 网址路径参数提供区域 ID。

• 对于 global 区域，请使用 dialogflow.googleapis.com 作为 主机名对于所有其他地区，请使用 [region-id]-dialogflow.googleapis.com 作为主机名。

例如：

• dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/global/agents/{AGENT_ID}

• us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}

如需查看客户端库，请参阅区域配置选项的客户端库文档。

您可以在 API 快速入门中找到示例。

注意：如设置文档中所述，您应该使用 GOOGLE_APPLICATION_CREDENTIALS 环境变量向客户端库提供凭据。但是，如果您需要在代码中手动提供凭据文件，则在调用区域化端点时需要执行一个额外的步骤。生成身份验证凭据时，请将范围设置为 https://www.googleapis.com/auth/cloud-platform。例如，在创建 GoogleCredentials 对象时，在 Java 中实现：

GoogleCredentials.fromStream(new FileInputStream("credential_file"))
  .createScoped("https://www.googleapis.com/auth/cloud-platform")
  

Cloud Logging

如需控制存储日志的区域，请参阅 Cloud Logging 指南。