安全性設定

安全性設定可設定資料遮蓋和資料保留。舉例來說,這些設定會控管 Cloud Logging 和對話記錄中的資料遮蓋方式。

安全性設定是在專案層級設定。如果您有專案中代理程式的存取權,就能查看專案層級的安全設定。如要更新專案層級安全性設定,您必須具備 dialogflow.securitySettings.update 權限。Dialogflow 最多可能需要一小時,才能實施安全性設定更新。

下表彙整了相關設定。如要進一步瞭解設定,請參閱 SecuritySettings RPC 參考資料。

安全性設定 說明
redaction_strategy RedactionStrategy:定義遮蓋方式。
redaction_scope RedactionScope:定義 Dialogflow 要遮蓋的資料。Dialogflow 不會遮蓋無法存取的資料,例如 Cloud Logging。
inspect_template string

Sensitive Data Protection:檢查範本名稱。使用這個範本定義檢查基礎設定。

代理專案的 Dialogflow 服務身分識別服務服務帳戶必須具備 The DLP Inspect Templates Reader 角色。

如果留空,系統會使用預設的 Sensitive Data Protection 檢查設定。

範本名稱會採用下列其中一種格式:projects//locations//inspectTemplates/ 或 organizations//locations//inspectTemplates/

注意:inspect_template 必須與 SecuritySettings 位於相同區域。

deidentify_template string

Sensitive Data Protection:去識別化範本名稱。使用這個範本定義內容的去識別化設定。

代理專案的 Dialogflow 服務身分識別服務服務帳戶必須具備 DLP Deidentify Templates Reader 角色。

如果留空,Dialogflow 會將機密資訊替換為 [redacted] 文字。

範本名稱會採用下列其中一種格式:projects//locations//deidentifyTemplates/ 或 organizations//locations//deidentifyTemplates/

注意:deidentify_template 必須與 SecuritySettings 位於相同區域。

purge_data_types[] PurgeDataType:保留設定觸發清除作業時,要移除的資料類型清單。
audio_export_settings AudioExportSettings:使用 [] 或 [Participants.StreamingAnalyzeContent][] 將音訊擷取至對話時,控制對話後數據分析的音訊匯出設定。

如果 retention_strategy 設為 REMOVE_AFTER_CONVERSATION,或 [audio_export_settings.gcs_bucket][] 為空白,系統會停用音訊匯出功能。如果啟用音訊匯出功能,系統會錄製音訊並儲存至 [audio_export_settings.gcs_bucket][],並依據 [audio_export_settings.gcs_bucket][] 的資料保留政策處理。

這項設定不會影響使用 Sessions.DetectIntent 或 Sessions.StreamingDetectIntent 的隱含工作階段音訊輸入。

insights_export_settings InsightsExportSettings:控制對話完成後,將對話匯出至 Insights 的設定。

如果 retention_strategy 設為 REMOVE_AFTER_CONVERSATION,無論您在這裡設定什麼,系統都會停用 Insights 匯出功能。

data_retention 指定資料保留方式的聯集欄位。即使資料因保留政策而遭到清除,仍可能在備份儲存空間中保留幾天,但無法直接存取。data_retention 只能是下列其中一個設定:

retention_window_days (int32):保留指定天數的資料。您設定的值必須低於 Dialogflow 的預設存留時間 365 天 (Agent Assist 流量為 30 天),否則系統會忽略較高的值,並使用預設值。如果設定的值高於預設值,系統會忽略該值。如果缺少值或設定為 0,也會使用預設存留時間。變更資料保留設定後,只有變更後建立的資料會套用新設定,變更前建立的現有資料存留時間則維持不變。

— retention_strategy:指定 SecuritySettings.RetentionStrategy 定義的保留行為。

您可以在每個位置設定多項安全性設定。每個代理程式都會指定要套用的安全性設定,您可以將每項設定套用至相同專案和位置中的多個代理程式。如要進一步瞭解資料應用層級,請參閱「資料應用層級」。

如未在代理中指定安全性設定,Dialogflow 就不會套用遮蓋功能。

建立安全性設定資源

如要在特定位置建立安全性設定資源,請按照下列步驟操作:

控制台

  1. 前往 Dialogflow CX 控制台。
  2. 選取 Google Cloud 專案。
  3. 選取代理程式。
  4. 按一下「Agent Settings」(代理程式設定)。
  5. 按一下 [Security] (安全性) 分頁標籤。
  6. 按一下「管理安全性設定」。CCAI 控制台會在新分頁中開啟。
  7. 在 CCAI 控制台中,按一下「Create security settings」(建立安全性設定)。
  8. 輸入安全性設定。
  9. 點選「建立」。

API

如要瞭解 create 方法,請參閱 SecuritySettings 類型。

選取 SecuritySettings 參照的通訊協定和版本:

通訊協定 V3 V3beta1
REST SecuritySettings 資源 SecuritySettings 資源
RPC SecuritySettings 介面 SecuritySettings 介面
C++ SecuritySettingssClient 不適用
C# SecuritySettingssClient 不適用
Go SecuritySettingssClient 不適用
Java SecuritySettingssClient SecuritySettingssClient
Node.js SecuritySettingssClient SecuritySettingssClient
PHP 不適用 不適用
Python SecuritySettingssClient SecuritySettingssClient
小茹 不適用 不適用

在代理中指定安全性設定

如要在代理中指定安全性設定,請按照下列步驟操作:

控制台

  1. 前往 Dialogflow CX 控制台。
  2. 選取 Google Cloud 專案。
  3. 選取代理程式。
  4. 按一下「Agent Settings」(代理程式設定)。
  5. 按一下 [Security] (安全性) 分頁標籤。
  6. 在「安全性設定」下拉式選單中選取設定。
  7. 按一下 [儲存]。

API

如要瞭解 patch 和 update 方法,請參閱 Agent 類型。

選取代理參考資料的通訊協定和版本:

通訊協定 V3 V3beta1
REST 代理資源 代理資源
RPC 代理介面 代理介面
C++ AgentsClient 不適用
C# AgentsClient 不適用
Go AgentsClient 不適用
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP 不適用 不適用
Python AgentsClient AgentsClient
小茹 不適用 不適用