地區化與資料落地權

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 使用自訂章節摘要 v4.0 使用自訂章節 v3.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,但這個工具只支援 global 區域的 API 呼叫。

  • CCAI Transcription 僅支援歐盟、美國、北美 (加拿大) 使用中和靜態的多區域資料 (如未使用語音適應功能)。

  • (主動) 生成式知識輔助功能使用的資料儲存庫僅支援以下區域: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 說明文件