設定商務代理程式

本指南說明如何設定商務代理程式，以便與 Omnichannel Gateway 搭配使用。

事前準備

將代理程式連線至 Omnichannel Gateway 前，請先建構及設定購物代理程式。如需建立商務代理程式的詳細操作說明，請參閱 Commerce Shopping 說明文件。本指南的其餘部分假設您已擁有購物代理程式，並想將其連結至 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/agenticapplications.editor"

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

建立端點設定

如要將代理程式連結至 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": "Commerce Agent Configuration",
    "destinationConfig": {
      "commerceAgentConfig": {
        "agent": "projects/PROJECT_ID/locations/LOCATION/commerceAgents/AGENT_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"

後續步驟