Dialogflow CX 智能体

通过 REST API 管理 Google Dialogflow CX 智能体。

前提条件

• - 已启用 Dialogflow CX API 的 Google Cloud 项目
• 具有 Dialogflow API 访问权限的服务账号或 OAuth 凭据
• 已认证的 gcloud CLI 或持有 bearer 令牌

身份验证

选项 1：gcloud CLI（推荐）

bash gcloud auth application-default login TOKEN=$(gcloud auth print-access-token)

选项 2：服务账号

bash export GOOGLEAPPLICATIONCREDENTIALS=/path/to/service-account.json TOKEN=$(gcloud auth application-default print-access-token)

API 基础 URL

https://dialogflow.googleapis.com/v3beta1

可用的区域端点：

• - https://{region}-dialogflow.googleapis.com（例如 us-central1、europe-west1）

常用操作

列出智能体

bash curl -X GET \ https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents \ -H Authorization: Bearer ${TOKEN}

创建智能体

bash curl -X POST \ https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents \ -H Authorization: Bearer ${TOKEN} \ -H Content-Type: application/json \ -d { displayName: 我的智能体, defaultLanguageCode: en, timeZone: Asia/Kolkata }

获取智能体

bash curl -X GET \ https://dialogflow.googleapis.com/v3beta1/projects/${PROJECTID}/locations/${LOCATION}/agents/${AGENTID} \ -H Authorization: Bearer ${TOKEN}

更新智能体

bash curl -X PATCH \ https://dialogflow.googleapis.com/v3beta1/projects/${PROJECTID}/locations/${LOCATION}/agents/${AGENTID} \ -H Authorization: Bearer ${TOKEN} \ -H Content-Type: application/json \ -d { displayName: 更新后的智能体名称 }

删除智能体

bash curl -X DELETE \ https://dialogflow.googleapis.com/v3beta1/projects/${PROJECTID}/locations/${LOCATION}/agents/${AGENTID} \ -H Authorization: Bearer ${TOKEN}

关键资源

资源	描述
智能体	流程、意图、实体类型的顶层容器

快速参考

有关详细的 API 参考：

• - 智能体：参见 references/agents.md

脚本

• - scripts/agents.py — 智能体管理操作的 CLI 封装

使用方法

bash python scripts/agents.py list --project PROJECT_ID --location LOCATION python scripts/agents.py create --project PROJECT_ID --location LOCATION --name 我的智能体 python scripts/agents.py get --project PROJECTID --location LOCATION --agent AGENTID python scripts/agents.py update --agent AGENT_NAME --name 新名称 python scripts/agents.py delete --agent AGENT_NAME

提示

• - 对于多区域智能体，请使用 locations/global
• 智能体 ID 在创建时自动生成