← 返回 Skills 市场

Dialogflow CX to CX Agent Studio Migration Skill

Name: Dialogflow CX to CX Agent Studio Migration Skill
Author: yash-kavaiya

作者 Yash Kavaiya · GitHub ↗ · v1.0.0

cross-platform ✓ 安全检测通过

302

总下载

当前安装

版本数

在 OpenClaw 中安装

/install dialogflow-cx-to-agent-studio-migration

功能描述

Migrate Dialogflow CX agents to CX Agent Studio (CES) using official REST/RPC APIs. Exports full CX agent packages, validates components (intents, entities,...

使用说明 (SKILL.md)

Dialogflow CX → CX Agent Studio Migration

Use this skill when you need to migrate a Dialogflow CX agent into CX Agent Studio (Gemini Enterprise for Customer Engagement / CES). It exports the full CX agent package, enumerates all components (intents, entities, flows, pages, webhooks, route groups, etc.), and creates a CES app + agent that runs the CX agent as a remote Dialogflow agent.

What this does

Exports the DFCX agent as a JSON package via the v3beta1 REST API.
Parses & indexes all exported components (agents, intents, entity types, flows, pages, webhooks, transition route groups, test cases, playbooks, etc.).
Creates a CES app and a CES agent (remote Dialogflow agent) via CES v1beta REST API.
Sets root agent on the CES app and emits a migration report with component counts and resource names.

Scripts

scripts/migrate.py — end‑to‑end migration + report generation

Usage

python skills/dialogflow-cx-to-studio-migration/scripts/migrate.py \
  --dfcx-agent projects/PROJECT/locations/LOCATION/agents/AGENT_ID \
  --studio-project PROJECT \
  --studio-location LOCATION \
  --studio-app-display-name "My CX Studio App" \
  --studio-agent-display-name "My CX Agent (Remote DFCX)"

Export only (no CES changes):

python skills/dialogflow-cx-to-studio-migration/scripts/migrate.py \
  --dfcx-agent projects/PROJECT/locations/LOCATION/agents/AGENT_ID \
  --export-only

Use existing CES app:

python skills/dialogflow-cx-to-studio-migration/scripts/migrate.py \
  --dfcx-agent projects/PROJECT/locations/LOCATION/agents/AGENT_ID \
  --studio-app projects/PROJECT/locations/LOCATION/apps/APP_ID

Outputs

dfcx_migration_output/dfcx_agent_export.zip — DFCX JSON package
dfcx_migration_output/export/ — extracted export folder
dfcx_migration_output/migration_report.json — migration report with component counts

Authentication

Use ADC (recommended):

gcloud auth application-default login

Ensure the caller has:

Dialogflow CX permissions (export/list)
CES permissions (create app/agent)

Scopes used:

https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/dialogflow
https://www.googleapis.com/auth/ces

Notes & Limitations

The CES agent is created as RemoteDialogflowAgent (official CES support). This preserves all DFCX components without lossy conversion.
The script indexes all components from the JSON package and writes a report for auditing.
If you need direct LLM-native agents/tools in CES, plan a follow‑up conversion step.

References (load as needed)

API links and endpoints: references/api-links.md
Migration mapping & component coverage: references/mapping.md

安全使用建议

This package appears to do exactly what it says. Before running it: (1) review the script yourself (it is included) to confirm there are no surprises; (2) run with --export-only first to examine the exported JSON package and migration_report.json; (3) use a Google service account or user with least-privilege IAM roles required for Dialogflow export and CES app/agent creation rather than broad Owner rights; (4) run in an isolated environment (or ephemeral VM/container) after ensuring python, google-auth, and requests are installed; (5) be aware the script will extract the export archive to dfcx_migration_output/ and will read any JSON file paths you pass as arguments — don't pass sensitive unrelated file paths. If you need higher assurance, test in a non-production project or share the script with your security team for review.

功能分析

Type: OpenClaw Skill Name: dialogflow-cx-to-agent-studio-migration Version: 1.0.0 The skill is designed to migrate Dialogflow CX agents to CX Agent Studio using official Google Cloud APIs. The `SKILL.md` provides clear, benign instructions for the AI agent and user, without any prompt injection attempts. The `scripts/migrate.py` uses standard Google Cloud authentication (`google.auth`) and `requests` to interact exclusively with `dialogflow.googleapis.com` and `ces.googleapis.com` endpoints. It handles local file operations (writing zip exports and migration reports) within a designated output directory. There is no evidence of data exfiltration to unauthorized destinations, arbitrary command execution, persistence mechanisms, or obfuscation. The broad `cloud-platform` scope is explicitly stated and necessary for its administrative function.

能力评估

✓ Purpose & Capability

Name/description describe Dialogflow CX → CES migration and the included script invokes Dialogflow and CES REST endpoints with the expected scopes; no unrelated services or credentials are requested.

ℹ Instruction Scope

SKILL.md instructs running the provided Python script using Application Default Credentials and explains required IAM permissions and scopes. The script exports the agent, parses the JSON package, extracts files to dfcx_migration_output/, and calls CES APIs to create apps/agents. It can also read JSON from a passed file path or JSON string (load_json_arg), which is expected for optional inputs but means it will open any file path you pass explicitly. Long-running operations returned as full URLs are followed (wait_operation supports op names that start with 'http').

ℹ Install Mechanism

This is instruction-only with no install spec. The script imports google.auth and requests, so the runtime must have those Python libraries available (the skill does not automate installing them). No archives or external installers are downloaded by the skill itself.

✓ Credentials

No environment variables or unrelated credentials are requested. The script uses Google ADC (gcloud auth application-default login) and requests only cloud-platform/dialogflow/ces scopes, which are proportionate to migration operations.

✓ Persistence & Privilege

The skill does not request persistent/always-on privilege, does not modify other skills, and writes only to a local output folder (dfcx_migration_output). It requires no special platform privileges beyond normal user execution.

如何使用

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

版本历史

v1.0.0

- Initial release: migrate Dialogflow CX agents to CX Agent Studio (CES) using official APIs. - Exports full CX agent packages and indexes all components (intents, entities, flows, pages, webhooks, route groups, etc.). - Creates CES app and remote Dialogflow agent, preserving all DFCX components. - Generates a migration report with component counts and resource names. - Includes command-line script for end-to-end migration, reporting, and export-only options.

元数据

Slug dialogflow-cx-to-agent-studio-migration

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题