地區化與資料落地權

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

區域放送的可用功能

區域 ID 使用自訂區段的摘要功能 (第 4.0 版) 使用自訂區段進行摘要 (3.1/3.0 版) 情緒分析 (主動式) 生成式知識輔助 建立專屬助理 (預先發布版)
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 來實作區域化。
  • 模型訓練不支援區域化。在這個過程中,您的資料可能會轉送至區域以外。
  • 許多 REST 參考文件中都有 API Explorer,但這項工具只支援 API 呼叫的 global 區域。

  • 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 說明文件,瞭解如何控管記錄的儲存區域。