配置 Dialogflow CX 代理

本指南介绍了如何配置 Dialogflow CX 智能体以与全渠道网关搭配使用。

准备工作

在将智能体连接到全渠道网关之前，您必须先构建和配置 Dialogflow CX 智能体，并为其创建对话配置文件。如需详细了解如何设置 Dialogflow CX 智能体，请参阅 Dialogflow CX 文档。必须在全渠道网关支持的区域之一中创建智能体。

创建智能体后，请按照 Dialogflow CX 对话配置文件 中的说明为其创建对话配置文件。本指南的其余部分假定您已为 Dialogflow CX 智能体创建对话配置文件，并且想要将其连接到全渠道网关。

此外，请确保您已完成HowTo 概览中所述的初始项目设置。

设置智能体运行器服务帐号

所有智能体都在服务帐号下运行。当 全渠道网关代表您的智能体拨打电话时，它将使用此服务帐号进行 身份验证。您可以使用此服务帐号来限制智能体的访问范围。

为智能体创建一个服务帐号，以便在其中运行。为其分配以下角色：

  • roles/serviceusage.serviceUsageConsumer
  • 您的智能体所需的任何其他角色。

此外，还要向全渠道网关服务代理授予智能体运行器服务帐号的 Service Account User (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"

如果您的智能体需要额外的工具调用 功能，您稍后可以添加更具体的权限。

创建端点配置

如需将智能体与全渠道网关连接，请运行以下 示例命令来创建端点配置。将占位符替换为目标项目、智能体 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"

后续步骤