配置商务智能体

本指南介绍了如何配置商务代理以与全渠道网关搭配使用。

准备工作

在将代理连接到全渠道网关之前，您必须先构建并配置购物代理。如需详细了解如何构建商业代理，请参阅 Commerce Shopping 文档。本指南的其余部分假定您已拥有购物代理，并希望将其连接到全渠道网关。

此外，请确保您已完成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/agenticapplications.editor"

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

创建端点配置

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

后续步骤