核心用法
coze_workflow 是一个基础技能（Base Skill），定位为"纯净调用层"，负责将参数透传给 Coze 平台的工作流并返回原始响应。开发者需提供 workflow_id 和 parameters 两个核心参数，技能通过 Coze 官方 API（支持流式 SSE 或轮询两种模式）完成执行。
显著优点
1. 职责分离清晰：明确区分"执行"与"业务逻辑"——本技能仅负责调用，参数构建和结果解析由上层业务技能处理，架构干净
2. 双模式执行：流式执行（推荐）适合实时交互场景；轮询模式适合异步任务
3. 生态基础能力：作为 image-gen-coze 等技能的底层依赖，是接入 Coze 工作流生态的标准入口
4. 配置简洁：仅需 api_key 和 base_url 两项配置即可运行
潜在缺点与局限性
- 零业务封装：返回的是 Coze API 原始 JSON（含
execute_id、output字符串字段），需调用方自行解析"output"中的 JSON 字符串 - 依赖外部服务：完全依赖 Coze 平台稳定性，无本地降级能力
- 调试门槛：
debug_url需人工点击查看，无法自动集成到日志系统
适合人群
- 开发者/技术用户：需要将 Coze 工作流集成到自有系统的工程师
- 已有 Coze 工作流资产的用户：已在 coze.cn 搭建工作流，需通过 API 调用的场景
- 上层技能开发者：开发基于 Coze 的垂直领域技能（如图像生成、数据分析等）
常规风险
| 风险点 | 说明 |
|--------|------|
| API密钥泄露 | `api_key`（pat_xxx 格式）需妥善保管，泄露可能导致工作流被滥用 |
| 流式超时 | SSE 连接可能因网络波动中断，需实现重试机制 |
| 结果格式不确定 | `output` 为字符串类型，实际结构由工作流定义决定，调用前需确认 Schema |