Agent Assist 提供数据驻留以保持您的存储中的数据(静态数据)实际上在指定的地理区域或位置内。指定区域后,您的静态数据不会存储在该区域之外。所有区域的价格都相同。
在以下用例中,指定区域特别有用:
- 您的系统有一些法规或政策要求,限定了您的数据必须存放的位置。
- 当数据位于客户所在的区域时,您的网络延迟可能会得到改善。例如,如果比利时客户使用
europe-west1
,那么延迟时间可能会更短。
可用区域
国家/地区分组 | 地理位置 | 区域 ID | 数据存储区地区 ID |
---|---|---|---|
美洲 | 爱荷华 | us-central1 |
us (多区域) |
美洲 | 南卡罗来纳 | us-east1 |
|
美洲 | 俄勒冈 | us-west1 |
|
美洲 | 蒙特利尔 | northamerica-northeast1 |
|
美洲 | 美国多区域 | us * |
us (多区域)* |
欧洲 | 比利时 | europe-west1 |
eu (多区域) |
欧洲 | 伦敦 | europe-west2 |
|
欧洲 | 法兰克福 | europe-west3 |
|
亚太地区 | 新加坡 | asia-southeast1 |
|
亚太地区 | 东京 | asia-northeast1 |
|
亚太地区 | 孟买 | asia-south1 |
|
亚太地区 | 悉尼 | australia-southeast1 |
|
全球 | 全球多区域(全球服务,静态数据在美国) | global (首选)或无区域(默认)¶ |
global (多区域)¶ |
符号 | 说明 |
---|---|
* | Vertex AI 不支持“us”多区域位置。因此,在“us”多区域中使用 Agent Assist 的生成式 AI 功能将依赖于相应的现有美国单区域端点。 |
¶ | 从美国以外区域调用时,global 区域的延迟时间可能更长。如果可能,请选择更接近您的服务和用户的更具体区域。 |
适用于地区性投放的功能
区域 ID | 使用自定义部分的摘要 v3.1/3.0 | 使用自定义部分 v2.1 进行总结 | 使用自定义部分 v2.0/1.0 进行总结 | 情感分析 | (主动式)生成式知识辅助 |
---|---|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-west1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us |
✓ | ✓ | ✓ | ✓ | |
northamerica-northeast1 |
✓ | ✓ | ✓ | ✓ | |
europe-west1 |
✓ | ✓ | ✓ | ✓ | |
europe-west2 |
✓ | ✓ | ✓ | ✓ | |
europe-west3 |
✓ | ✓ | ✓ | ✓ | |
asia-southeast1 |
✓ | ✓ | ✓ | ✓ | |
asia-northeast1 |
✓ | ✓ | ✓ | ✓ | |
asia-south1 |
✓ | ✓ | ✓ | ||
australia-southeast1 |
✓ | ✓ | ✓ | ✓ | |
global |
✓ | ✓ | ✓ | ✓ | ✓ |
存储中的数据(静态数据)
所有 Agent Assist 开发者用户和最终用户数据都包含在静态数据中。例如:
限制
存在以下限制:
- 客服助手控制台尚不支持区域化。您只能通过直接调用 API 来实现地区化。
- 模型训练不支持区域化。在此过程中,您的数据可能会被转送到该区域之外。
API Explorer 可在许多 REST 参考文档中找到,但仅支持
global
区域的 API 调用。CCAI 转写目前仅支持欧盟、美国和北美洲(加拿大)的多区域使用中数据和静态数据(如果未使用语音自适应功能)。
数据存储区(由生成式知识辅助 [主动] 功能使用)仅支持以下区域:
global
、us
多区域和eu
多区域。
使用 API 指定区域
如需使用地区化功能,您必须为每个 API 请求指定区域。
必填字段:
为
location
网址路径参数提供区域 ID。对于
global
区域,请将主机名设为dialogflow.googleapis.com
。对于所有其他区域,请使用[region-id]-dialogflow.googleapis.com
作为主机名。
例如:
dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_id
us-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id
如需使用客户端库,您需要执行以下步骤:
- 将服务端点设置为:
REGION_ID-dialogflow.googleapis.com
。 使用正确的位置设置资源名称,例如:
projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id
凭据
我们建议您使用 GOOGLE_APPLICATION_CREDENTIALS 环境变量向客户端库提供凭据。如需详细了解如何设置此变量,请参阅 Dialogflow 设置说明。
如果您需要在代码中手动提供凭据,则需要执行一个额外的步骤,然后才能调用区域化端点。生成身份验证凭据时,您必须将范围设置为 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 文档。