← 返回 Skills 市场

Dialogflow Cx Agents

Name: Dialogflow Cx Agents
Author: yash-kavaiya

作者 Yash Kavaiya · GitHub ↗ · v1.0.0

cross-platform ⚠ suspicious

396

总下载

当前安装

版本数

在 OpenClaw 中安装

/install dialogflow-cx-agents

功能描述

Manage agents in Google Dialogflow CX via REST API. Use for creating, listing, updating, and deleting chatbot agents. Supports v3beta1 API.

使用说明 (SKILL.md)

\r \r

Dialogflow CX Agents\r

\r Manage Google Dialogflow CX agents via REST API.\r \r

Prerequisites\r

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

Authentication\r

Option 1: gcloud CLI (recommended)\r

gcloud auth application-default login\r
TOKEN=$(gcloud auth print-access-token)\r
```\r
\r
### Option 2: Service Account\r
```bash\r
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"\r
TOKEN=$(gcloud auth application-default print-access-token)\r
```\r
\r
## API Base URL\r
\r
```\r
https://dialogflow.googleapis.com/v3beta1\r
```\r
\r
Regional endpoints available:\r
- `https://{region}-dialogflow.googleapis.com` (e.g., `us-central1`, `europe-west1`)\r
\r
## Common Operations\r
\r
### List Agents\r
```bash\r
curl -X GET \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
### Create Agent\r
```bash\r
curl -X POST \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "displayName": "My Agent",\r
    "defaultLanguageCode": "en",\r
    "timeZone": "Asia/Kolkata"\r
  }'\r
```\r
\r
### Get Agent\r
```bash\r
curl -X GET \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
### Update Agent\r
```bash\r
curl -X PATCH \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "displayName": "Updated Agent Name"\r
  }'\r
```\r
\r
### Delete Agent\r
```bash\r
curl -X DELETE \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
## Key Resources\r
\r
| Resource | Description |\r
|----------|-------------|\r
| **Agents** | Top-level container for flows, intents, entity types |\r
\r
## Quick Reference\r
\r
For detailed API reference:\r
- **Agents**: See [references/agents.md](references/agents.md)\r
\r
## Scripts\r
\r
- `scripts/agents.py` — CLI wrapper for agent management operations\r
\r
### Usage\r
```bash\r
python scripts/agents.py list --project PROJECT_ID --location LOCATION\r
python scripts/agents.py create --project PROJECT_ID --location LOCATION --name "My Agent"\r
python scripts/agents.py get --project PROJECT_ID --location LOCATION --agent AGENT_ID\r
python scripts/agents.py update --agent AGENT_NAME --name "New Name"\r
python scripts/agents.py delete --agent AGENT_NAME\r
```\r
\r
## Tips\r
\r
- Use `locations/global` for multi-region agents\r
- Agent IDs are generated automatically on creation

安全使用建议

This skill appears to do only Dialogflow CX agent management. Before installing: (1) Be prepared to authenticate with gcloud or provide a service-account JSON (GOOGLE_APPLICATION_CREDENTIALS) — treat that JSON like sensitive credentials and use least-privilege roles. (2) Install the listed Python packages in an isolated environment (venv) so third-party libs don't affect system packages. (3) Review the included scripts locally if you want to verify behavior; exports write agent content to disk. (4) Note the registry metadata did not list the env vars referenced in SKILL.md (TOKEN and GOOGLE_APPLICATION_CREDENTIALS), so ensure you supply credentials only when you trust the runtime.

功能分析

Type: OpenClaw Skill Name: dialogflow-cx-agents Version: 1.0.0 The skill bundle is classified as suspicious due to potential vulnerabilities rather than explicit malicious intent. The `scripts/agents.py` file includes an `export_agent` function that writes to a user-specified `output_file`. If the OpenClaw agent or user input does not properly sanitize this argument, it could lead to arbitrary file write (e.g., path traversal), allowing an attacker to overwrite or create files in arbitrary locations. Additionally, the `SKILL.md` provides `curl` examples that, if executed directly by an agent with unsanitized user input, could be vulnerable to shell injection. While these are significant risks, they represent vulnerabilities that *allow* attacks rather than code *designed* for malicious actions like data exfiltration to unauthorized endpoints or backdoor installation.

能力评估

✓ Purpose & Capability

Name and description (Dialogflow CX agent management) align with the included scripts and SKILL.md. The Python CLI uses the google-cloud-dialogflow-cx client and exposes list/get/create/update/delete/export/validate operations — all expected for this purpose.

ℹ Instruction Scope

SKILL.md contains concrete curl examples and a CLI usage for the included script. It instructs using gcloud auth or a service account and to provide PROJECT_ID, LOCATION, AGENT_ID, or full agent names. It does not attempt to read unrelated system files or send data to non-Google endpoints. Note: SKILL.md references the environment variable GOOGLE_APPLICATION_CREDENTIALS and a TOKEN variable (from gcloud) — these are normal but are not declared in the registry metadata.

✓ Install Mechanism

No install spec in registry; the script recommends installing standard PyPI packages (google-cloud-dialogflow-cx, google-auth) via pip. No downloads from unknown URLs or extraction of remote archives are present.

ℹ Credentials

The skill requires Google Cloud credentials to operate (gcloud auth / bearer token or GOOGLE_APPLICATION_CREDENTIALS pointing to a service account JSON). Those credentials are appropriate and necessary for Dialogflow management, but the registry metadata lists no required env vars — SKILL.md uses environment variables that the metadata did not declare.

✓ Persistence & Privilege

The skill is not always-enabled and does not request elevated platform privileges. It does not modify other skills or system-wide settings. Exporting agents writes to a local file (as expected) or references a GCS URI, which is within scope.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install dialogflow-cx-agents
安装完成后，直接呼叫该 Skill 的名称或使用 /dialogflow-cx-agents 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Initial release of the Dialogflow CX Agents skill. - Enables creating, listing, updating, and deleting Dialogflow CX agents via the v3beta1 REST API. - Includes authentication instructions for both gcloud CLI and service account workflows. - Provides curl examples for common agent management operations. - Bundles a CLI tool (`scripts/agents.py`) for agent management tasks. - Documentation covers API endpoints, usage examples, and key tips for working with regional and global agents.

元数据

Slug dialogflow-cx-agents

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题