← Back to Skills Marketplace
yash-kavaiya

Dialogflow CX to CX Agent Studio Migration Skill

by Yash Kavaiya · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
302
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install dialogflow-cx-to-agent-studio-migration
Description
Migrate Dialogflow CX agents to CX Agent Studio (CES) using official REST/RPC APIs. Exports full CX agent packages, validates components (intents, entities,...
README (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

  1. Exports the DFCX agent as a JSON package via the v3beta1 REST API.
  2. Parses & indexes all exported components (agents, intents, entity types, flows, pages, webhooks, transition route groups, test cases, playbooks, etc.).
  3. Creates a CES app and a CES agent (remote Dialogflow agent) via CES v1beta REST API.
  4. 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)

Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install dialogflow-cx-to-agent-studio-migration
  3. After installation, invoke the skill by name or use /dialogflow-cx-to-agent-studio-migration
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug dialogflow-cx-to-agent-studio-migration
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Dialogflow CX to CX Agent Studio Migration Skill?

Migrate Dialogflow CX agents to CX Agent Studio (CES) using official REST/RPC APIs. Exports full CX agent packages, validates components (intents, entities,... It is an AI Agent Skill for Claude Code / OpenClaw, with 302 downloads so far.

How do I install Dialogflow CX to CX Agent Studio Migration Skill?

Run "/install dialogflow-cx-to-agent-studio-migration" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Dialogflow CX to CX Agent Studio Migration Skill free?

Yes, Dialogflow CX to CX Agent Studio Migration Skill is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Dialogflow CX to CX Agent Studio Migration Skill support?

Dialogflow CX to CX Agent Studio Migration Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Dialogflow CX to CX Agent Studio Migration Skill?

It is built and maintained by Yash Kavaiya (@yash-kavaiya); the current version is v1.0.0.

💬 Comments