設定 Agent Studio 代理程式

本指南說明如何設定 Agent Studio 代理程式，以便與 Omnichannel Gateway 搭配運作。

事前準備

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

建立代理後，請按照「為 CX Agent Studio 代理建立對話設定檔」一文中的操作說明，為代理建立對話設定檔。本指南的其餘部分假設您已為 Agent Studio 代理程式建立對話設定檔，並想將其連結至 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"

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

將 Dialogflow 服務代理角色授予服務代理

除了標準服務代理設定外，您還必須將 Dialogflow 服務代理 (roles/dialogflow.serviceAgent) 角色授予 Omnichannel Gateway 服務代理。

  1. 判斷服務代理的身分：

    服務代理程式的身分是使用專案編號建構而成，格式如下：service-PROJECT_NUMBER@gcp-sa-agenticapplications.。

    如要找出專案編號，請執行：

    gcloud projects describe PROJECT_ID --format="value(projectNumber)"

  2. 授予 Dialogflow 服務代理程式角色：

    執行下列指令來授予角色：

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-agenticapplications." \
    --role="roles/dialogflow.serviceAgent"

    將 PROJECT_NUMBER 替換為上一個步驟中找到的專案編號，並將 PROJECT_ID 替換為專案 ID。

建立端點設定

如要將代理程式連結至 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": "Agent Studio 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"

後續步驟