本指南介绍了如何配置 Agent Studio 智能体以与全渠道网关搭配使用。
准备工作
在将智能体连接到全渠道网关之前，您必须先构建和配置 Agent Studio 智能体，并为其创建对话配置文件。如需详细了解如何设置对话智能体，请参阅对话智能体文档。必须在全渠道网关支持的区域之一中创建智能体。
创建智能体后，请按照为 CX Agent Studio 智能体创建对话配置文件中的说明为其创建对话配置文件。本指南的其余部分假定您已为 Agent Studio 智能体创建对话配置文件，并且想要将其连接到全渠道网关。
此外，请确保您已完成操作指南概览中所述的初始项目设置。
设置智能体运行器服务帐号
所有智能体都在服务帐号下运行。当 全渠道网关代表您的智能体进行调用时，它将使用此服务帐号进行 身份验证。您可以使用此服务帐号来限制智能体的访问范围。
为智能体创建一个服务帐号，以便在其中运行。为其分配以下角色：
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"
如果您的智能体需要额外的工具调用 功能。 您可以在稍后添加更具体的权限。
向服务代理授予 Dialogflow Service Agent 角色
除了标准服务代理设置之外，您还必须向全渠道网关服务代理授予 Dialogflow Service Agent (roles/dialogflow.serviceAgent) 角色。
确定服务代理的身份：
服务代理的身份是使用您的项目编号构建的，格式如下：
service-PROJECT_NUMBER@gcp-sa-agenticapplications.。如需查找项目编号，请运行以下命令：
gcloud projects describe PROJECT_ID --format="value(projectNumber)"授予 Dialogflow Service Agent 角色：
运行以下命令以授予该角色：
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。
创建端点配置
如需将智能体与全渠道网关连接，请运行以下 示例命令来创建端点配置。将占位符替换为目标项目、智能体 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"
后续步骤
- 了解如何配置渠道。