設定 Dialogflow CX 虛擬服務專員

本指南說明如何設定 Dialogflow CX 虛擬服務專員，以便與 Omnichannel Gateway 搭配使用。

事前準備

將服務專員連結至 Omnichannel Gateway 前，您必須先建構及設定 Dialogflow CX 服務專員，並為該服務專員建立對話設定檔。如需設定 Dialogflow CX 虛擬服務專員的詳細操作說明，請參閱 Dialogflow CX 說明文件。代理程式必須在 Omnichannel Gateway 支援的區域中建立。

建立虛擬服務專員後，請按照「Dialogflow CX 對話設定檔」一文中的操作說明，為虛擬服務專員建立對話設定檔。本指南的其餘部分會假設您已為 Dialogflow CX 虛擬服務專員建立對話設定檔，並想將其連結至 Omnichannel Gateway。

此外，請確認您已完成「How-to 總覽」中所述的專案初始設定。

設定代理程式執行器服務帳戶

所有代理程式都會在服務帳戶下執行。Omnichannel Gateway 代表服務專員撥打電話時，會使用這個服務帳戶進行驗證。您可以使用這個服務帳戶，限制代理程式的存取範圍。

建立服務帳戶，供代理程式執行。為服務帳戶指派下列角色：

  • roles/serviceusage.serviceUsageConsumer
  • 代理程式所需的任何其他角色。

此外，請在代理程式執行器服務帳戶中，授予 Omnichannel Gateway 服務代理程式「服務帳戶使用者」角色 (roles/iam.serviceAccountUser)，允許代理程式以服務帳戶身分執行工作流程：

gcloud

gcloud iam service-accounts create agent-runner \
    --description="Service account for executing agentic application workflows" \
    --display-name="Agent Runner" \
    --project="PROJECT_ID"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:agent-runner@PROJECT_ID." \
    --role="roles/serviceusage.serviceUsageConsumer"

gcloud iam service-accounts add-iam-policy-binding \
    agent-runner@PROJECT_ID. \
    --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-agenticapplications." \
    --role="roles/iam.serviceAccountUser" \
    --project="PROJECT_ID"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:agent-runner@PROJECT_ID." \
    --role="roles/dialogflow.serviceAgent"

如果代理程式需要額外的工具呼叫功能，您之後可以新增更具體的權限。

建立端點設定

如要將代理程式連結至 Omnichannel Gateway，請執行下列範例指令，建立端點設定。請將預留位置替換為目標專案、代理程式 ID 和服務帳戶詳細資料：

curl

curl -i -X POST \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type: application/json" \
  "https://agenticapplications.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/omnichannelEndpointConfigs" \
  -d @- <<EOF

{
    "displayName": "Dialogflow CX Agent Configuration",
    "destinationConfig": {
      "conversationProfile": {
        "conversationProfile": "projects/PROJECT_ID/locations/LOCATION/conversationProfiles/CONVERSATION_PROFILE_ID",
        "serviceAccount": "projects/PROJECT_ID/serviceAccounts/agent-runner@PROJECT_ID."
      }
    }
}

EOF

驗證端點設定

註冊端點設定後，請查詢端點設定，確認已正確佈建並啟用：

curl

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://agenticapplications.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/omnichannelEndpointConfigs"

後續步驟