Dialogflow Cx Agents

提供 Dialogflow CX v3beta1 智能体的列出、创建、查询、更新、删除等 REST 调用示例，并附带 Python CLI 封装脚本；需先通过 gcloud 或服务账号获取访问令牌，删除操作具有破坏性。

yash-kavaiya

热度 85.41

最近更新 2026-05-17 12:58:09

分类：开发依赖：代码执行 / 第三方 API / 读写文件应用场景：API 集成 / 自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add dialogflow-cx-agents

Metadata

name: dialogflow-cx-agents
description: Manage agents in Google Dialogflow CX via REST API. Use for creating, listing, updating, and deleting chatbot agents. Supports v3beta1 API.

Dialogflow CX Agents

Manage Google Dialogflow CX agents via REST API.

Prerequisites

Google Cloud project with Dialogflow CX API enabled
Service account or OAuth credentials with Dialogflow API access
gcloud CLI authenticated OR bearer token

Authentication

Option 1: gcloud CLI (recommended)

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

Option 2: Service Account

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

API Base URL

https://dialogflow.googleapis.com/v3beta1

Regional endpoints available:

https://{region}-dialogflow.googleapis.com (e.g., us-central1, europe-west1)

Common Operations

List Agents

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

Create Agent

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": "My Agent",
    "defaultLanguageCode": "en",
    "timeZone": "Asia/Kolkata"
  }'

Get Agent

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

Update Agent

curl -X PATCH \
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "Updated Agent Name"
  }'

Delete Agent

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

Key Resources

Resource	Description
Agents	Top-level container for flows, intents, entity types

Quick Reference

For detailed API reference:

Agents: See references/agents.md

Scripts

scripts/agents.py — CLI wrapper for agent management operations

Usage

python scripts/agents.py list --project PROJECT_ID --location LOCATION
python scripts/agents.py create --project PROJECT_ID --location LOCATION --name "My Agent"
python scripts/agents.py get --project PROJECT_ID --location LOCATION --agent AGENT_ID
python scripts/agents.py update --agent AGENT_NAME --name "New Name"
python scripts/agents.py delete --agent AGENT_NAME

Tips

Use locations/global for multi-region agents
Agent IDs are generated automatically on creation