workflow-interactive-dev
开发 FastGPT 工作流交互节点
FastGPT 工作流支持暂停并等待用户输入。本指南详细说明交互节点的完整开发流程,包括类型定义、执行逻辑、前端组件和国际化支持。
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Протестировать
Использование «workflow-interactive-dev». 如何开发一个自定义的用户反馈节点?
Ожидаемый результат:
- 开发自定义反馈节点需要以下步骤:
- 1. 在 type.d.ts 中定义节点类型和参数结构
- 2. 在常量文件中添加节点枚举(可选)
- 3. 创建节点模板文件定义输入输出
- 4. 实现 dispatch 逻辑,包含两阶段处理
- 5. 注册节点回调到回调映射表
- 6. 创建前端聊天组件和工作流编辑器组件
- 7. 添加国际化翻译文本
Использование «workflow-interactive-dev». userSelect 和 formInput 节点有什么区别?
Ожидаемый результат:
- userSelect 是简单的单选节点:
- - 用于让用户从预定义选项中选择一个
- - 结构简单,只需定义选项列表
- - formInput 是支持多字段的复杂表单节点:
- - 支持用户输入多个字段的数据
- - 需要更复杂的输入项配置和验证逻辑
Использование «workflow-interactive-dev». 交互节点如何处理用户输入数据?
Ожидаемый результат:
- 交互节点有两阶段处理机制:
- 第一阶段:返回交互请求,暂停工作流,等待用户输入
- 第二阶段:接收用户提交的数据,处理后继续执行
- 关键点:需要在第二阶段设置 node.isEntry = false
- 使用 chatValue2RuntimePrompt 解析用户输入
- 使用 histories.slice(0, -2) 清理交互历史记录
Аудит безопасности
Безопасно纯文档技能,仅包含 Markdown 格式的开发指南和 TypeScript 代码示例。所有代码片段均为文档说明性质,不包含任何脚本、网络调用或文件访问功能。静态分析检测到的所有模式均为误报:TypeScript 模板字符串被误判为 shell 反引号执行,导入路径被误判为路径遍历,JSON 元数据被误判为弱加密算法。
Факторы риска
🌐 Доступ к сети (1)
📁 Доступ к файловой системе (20)
⚙️ Внешние команды (71)
Оценка качества
Что вы можете построить
创建自定义用户选择节点
为工作流添加用户选择功能,支持单选或多选场景,实现人机协作流程
设计表单输入交互
构建复杂表单交互节点,收集用户多字段输入,适配业务数据采集需求
扩展工作流引擎
在 FastGPT 基础上开发新的交互节点类型,扩展平台能力边界
Попробуйте эти промпты
请介绍 FastGPT 交互节点的基本架构,包括核心类型定义和两阶段执行机制
请详细说明开发一个新的交互节点类型需要修改哪些文件,以及每个文件的作用
请解释 dispatchYourNode 函数中的两阶段处理逻辑,特别是 isEntry 标志的作用
如何实现多个交互节点串联?交互节点如何正确处理历史记录和 skipNodeQueue?
Лучшие практики
- 在第二阶段处理用户输入时,务必设置 node.isEntry = false 以重置入口标志
- 使用 histories.slice(0, -2) 移除交互相关的历史记录,保持对话上下文清洁
- 参考现有的 userSelect 和 formInput 节点实现,它们提供了完整的代码模式
Избегать
- 忘记在 isEntry 白名单中添加新节点类型,导致工作流恢复后无法继续执行
- 未正确解析用户输入格式,导致数据无法传递到后续节点
- 在前端组件中直接使用未封装的原始数据,绕过表单验证和类型检查
Часто задаваемые вопросы
交互节点与普通节点有什么主要区别?
一个工作流中可以使用多个交互节点吗?
如何调试新开发的交互节点?
交互节点是否支持在工具调用中使用?
前端组件需要处理哪些状态?
userSelect 和 formInput 节点有什么区别?
Сведения для разработчиков
Автор
labringЛицензия
MIT
Репозиторий
https://github.com/labring/FastGPT/tree/main/.claude/skills/core/app/workflow/inteactiveСсылка
main
Структура файлов
📄 SKILL.md