地区化和数据驻留

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(多区域)¶

适用于地区性投放的功能

区域 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 转写目前仅支持欧盟、美国和北美洲(加拿大)的多区域使用中数据和静态数据(如果未使用语音自适应功能)。

  • 数据存储区(由生成式知识辅助 [主动] 功能使用)仅支持以下区域:globalus 多区域和 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 文档