Dialogflow Cx Agents

这是面向Google Dialogflow CX的代理管理工具，基于v3beta1 REST API构建，核心支持聊天机器人代理的列取、创建、获取、更新、删除全操作，提供HTTP curl命令示例及Python脚本封装。适用于已配置Dialogflow CX API权限的Google Cloud项目开发者，可通过带认证的HTTP请求或Python命令执行操作，输入为项目/代理相关参数，输出为JSON格式的代理数据或操作结果反馈。

yash-kavaiya

热度 85.43

最近更新 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