Agent Assist 提供 数据驻留 ,以将您的存储中的数据(静态数据) 实际保存在指定的地理区域或位置内。指定区域后,您的静态数据不会存储在该区域之外。所有区域的定价均相同。
在以下用例中,指定区域特别有用:
- 您的系统有一些法规或政策要求,限定了您的数据必须存放的位置。
- 当数据位于客户所在的区域时,您的网络延迟可能会得到改善。例如,如果比利时客户使用
europe-west1,那么延迟时间可能会更短。
可用区域
| 国家/地区分组 | 地理位置 | 地区 ID | 数据存储区地区 ID |
|---|---|---|---|
| 美洲 | 爱荷华 | us-central1 |
us(多区域) |
| 美洲 | 南卡罗来纳 | us-east1 |
|
| 美洲 | 俄勒冈 | us-west1 |
|
| 美洲 | 蒙特利尔 | northamerica-northeast1 |
global(多区域) |
| 美洲 | 美国多区域 | us * |
us(多区域)* |
| 欧洲 | 比利时 | europe-west1 |
eu(多区域) |
| 欧洲 | 伦敦 | europe-west2 |
|
| 欧洲 | 法兰克福 | europe-west3 |
|
| 欧洲 | 埃姆斯哈文 | europe-west4 |
eu(多区域) |
| 欧洲 | 苏黎世 | europe-west6 |
eu(多区域) |
| 亚太地区 | 新加坡 | asia-southeast1 |
|
| 亚太地区 | 雅加达 | asia-southeast2 |
global(多区域) |
| 亚太地区 | 东京 | asia-northeast1 |
|
| 亚太地区 | 孟买 | asia-south1 |
|
| 亚太地区 | 悉尼 | australia-southeast1 |
|
| 全球 | 全球多区域(全球服务,静态数据在美国) | global(首选)或无区域(默认)¶ |
global(多区域)¶ |
| 符号 | 说明 |
|---|---|
| * | Vertex AI 不支持“us”多区域位置。因此,在“us”多区域中使用 Agent Assist 的生成式 AI 功能将依赖于相应的现有美国单区域端点。 |
| ¶ | 从美国境外调用 global 区域时,延迟时间可能会更长。如果可以,请优先选择更靠近您的服务和用户的特定区域。 |
可用于区域服务的功能
| 地区 ID | Summarization 自定义栏目 v5.0/4.0 | Summarization 自动评估(预览版) | 情感分析 (v3) | (主动)生成式知识助理 | 构建您自己的助理(预览版) | AI Coach |
|---|---|---|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
us-west1 |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
us |
✓ | ✓ | ✓ | ✓ | ✓ | |
northamerica-northeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west2 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west3 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west4 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west6 |
✓ | ✓ | ✓ | ✓ | ✓ | |
asia-southeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
asia-southeast2 |
✓ | ✓ | ✓ | ✓ | ✓ | |
asia-northeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
asia-south1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
australia-southeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
global |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
存储中的数据(静态数据)
所有 Agent Assist 开发者用户和最终用户数据都包含在静态数据中。 例如:
限制
存在以下限制:
- Agent Assist 控制台 不支持区域化。您只能通过直接调用 API 来实现区域化。
- 模型训练不支持 区域化。在此过程中,您的数据可能会被路由到区域之外。
API Explorer(许多 REST 参考文档中提供)仅支持对 API 调用使用
global区域。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_idus-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 文档 。