360 Secure SkillHub
360 安全技能中心

Dialogflow CX to CX Agent Studio Migration Skill

核心功能：通过官方API实现Dialogflow CX（DFCX）智能体到CX Agent Studio（CES）的迁移，支持仅导出DFCX智能体或完整迁移。完整迁移含导出DFCX JSON包、解析索引所有组件、创建CES应用与远程DFCX智能体、生成含组件统计的迁移报告。 典型场景：需将DFCX智能体迁移至CES，或仅需导出DFCX智能体包的需求。 输入为命令行参数，输出含导出压缩包、提取文件夹及迁移报告JSON。

yash-kavaiya
yash-kavaiya
热度 81.39
最近更新 2026-05-11 17:28:11
分类：开发依赖：代码执行 / 第三方 API / 读写文件应用场景：API 集成 / 自动化脚本 / DevOps

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add dialogflow-cx-to-agent-studio-migration
Metadata
name
dialogflow-cx-to-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, flows, pages, etc.), and creates CES apps/agents (remote Dialogflow agent) with a migration report.

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)