Dialogflow CX to CX Agent Studio Migration Skill — Dialogflow CX 到 CX Agent Studio 迁移技能 — 迁移 Dialogflow CX 代理到 CES

Name: Dialogflow CX to CX Agent Studio Migration Skill — Dialogflow CX 到 CX Agent Studio 迁移技能 — 迁移 Dialogflow CX 代理到 CES
Author: Yash Kavaiya

Yash Kavaiya

Dialogflow CX to CX Agent Studio Migration Skill — Dialogflow CX 到 CX Agent Studio 迁移技能 — 迁移 Dialogflow CX 代理到 CES

v1.0.0

使用官方 REST/RPC API 将 Dialogflow CX 代理迁移到 CX Agent Studio (CES)。导出完整的 CX 代理包，验证组件（意图、实体、流程、页面等），并创建 CES 应用/代理，保留所有 DFCX 组件。

0· 265·0 当前·0 累计

by @yash-kavaiya (Yash Kavaiya)·MIT-0

API工具开发工具自动化云服务

下载技能包

License

MIT-0

最后更新

2026/3/2

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

high confidence

该技能的代码和指令与其声明的目的完全匹配（迁移 Dialogflow CX 代理到 CES），仅请求 Google ADC 凭据/范围，并执行预期的导出/解析/创建操作——包中没有任何指示不相关或隐蔽行为。

评估建议

此包似乎做了它宣称的所有事情。运行前：（1）自己审查脚本（已包含）以确认没有惊喜；（2）先使用 --export-only 导出 JSON 包和 migration_report.json；（3）使用具有最小权限的 Google 服务账户或用户；（4）在确保安装了 python、google-auth 和 requests 之后，在隔离环境中运行；（5）注意脚本将提取导出存档到 dfcx_migration_output/ 并读取任何您作为参数传递的 JSON 文件路径——不要传递敏感的无关文件路径。如果需要更高的保证，请在非生产项目中测试或与安全团队共享脚本进行审查。...

详细分析 ▾

✓ 用途与能力

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.

ℹ 指令范围

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').

ℹ 安装机制

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.

✓ 凭证需求

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.

✓ 持久化与权限

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.

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv1.0.02026/3/2

["初始发布：使用官方 API 将 Dialogflow CX 代理迁移到 CES。","导出完整的 CX 代理包并索引所有组件（意图、实体、流程、页面、Webhook、路由组等）。","创建 CES 应用和远程 Dialogflow 代理，保留所有 DFCX 组件。","生成包含组件计数和资源名称的迁移报告。","包括用于端到端迁移、报告和仅导出选项的命令行脚本。"]

● 无害

安装命令点击复制

官方npx clawhub@latest install dialogflow-cx-to-agent-studio-migration

镜像加速npx clawhub@latest install dialogflow-cx-to-agent-studio-migration --registry https://cn.clawhub-mirror.com

技能文档

使用此技能当您需要将 Dialogflow CX 代理迁移到 CX Agent Studio (CES)。它导出完整的 CX 代理包，枚举所有组件，并创建一个 CES 应用 + 代理，该代理作为 远程 Dialogflow 代理 运行。

该技能做什么

导出使用 v3beta1 REST API 将 DFCX 代理作为 JSON 包导出。
解析 & 索引 所有导出的组件（代理、意图、实体类型、流程、页面、Webhook、转换路由组、测试案例、游戏手册等）。
创建使用 CES v1beta REST API 创建 CES 应用和 CES 代理（远程 Dialogflow 代理）。
设置根代理 在 CES 应用上并发出包含组件计数和资源名称的 迁移报告。

脚本

scripts/migrate.py — 端到端迁移 + 报告生成

用法

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)"

仅导出（无 CES 修改）：

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

使用现有 CES 应用：

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

输出

dfcx_migration_output/dfcx_agent_export.zip — DFCX JSON 包
dfcx_migration_output/export/ — 提取的导出文件夹
dfcx_migration_output/migration_report.json — 包含组件计数的迁移报告

认证

使用 ADC（推荐）：

gcloud auth application-default login

确保调用者具有：

Dialogflow CX 导出/列表权限
CES 创建应用/代理权限

使用范围：

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

注意事项 & 限制

CES 代理作为 RemoteDialogflowAgent 创建（官方 CES 支持）。这保留 所有 DFCX 组件 而无损失转换。
脚本索引所有 JSON 包中的组件并为审计写入报告。
如果您需要 CES 中的直接 LLM 本地代理/工具，请计划后续转换步骤。

参考文献（按需加载）

API 链接和端点：references/api-links.md
迁移映射 & 组件覆盖：references/mapping.md

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

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务

License

运行时依赖

版本

安装命令 点击复制

技能文档

该技能做什么

脚本

用法

输出

认证

注意事项 & 限制

参考文献（按需加载）

What this does

Scripts

Usage

Outputs

Authentication

Notes & Limitations

References (load as needed)

安装命令点击复制