技术实践

得物以LangGraph和能力注册表重构活动工作台

智能体系统应用与实践Agent 架构与控制循环Agent 动作执行与治理Agent Harness行业应用

概述

第二版是架构级重写,核心理念是把运营从「流程执行者」变成「流程监督者」:运营只需粘贴飞书策划文档链接并在 AI 弹出的结构化卡片上做校验微调,抓取文档、解析字段、创建话题、创建活动、复制会场模板、配置组件全部由工作流驱动。技术选型上先判定流程(解析→选组件→补字段→确认→构建)步骤与完成条件确定、对正确率要求极高,故采用 Workflow 而非完全自主 Agent,仅在 AI 改写规则文案、理解自然语言修改组件配置等局部节点用 Agent 式 LLM 调用。 编排引擎评估多方后选 LangGraph(LangChain 团队的状态编排引擎,MIT 开源),用有向图定义工作流,内置 Checkpointer 持久化会话状态并支持中断恢复,LLM 只作节点内执行者、不参与流程路由。前后端交互基于 LangGraph 的 interrupt/resume:需要人类输入时 interrupt() 暂停图执行并把结构化 payload 发前端渲染 UI 卡片,用户操作后由 Command(resume=value) 推回、图从断点继续,共设置 6 个中断点,覆盖 Approve/Reject、Edit、Respond/Input 三类人工介入。 前端用 Capability Registry(能力注册表)按插件方式动态挂载场景 UI,当前已接入会场搭建、动态筛选和通用聊天三个场景。组件模块协议把头图、动态 Feed、活动任务、规则说明、Banner、瓜分激励等 16+ 个组件抽象为独立模块并统一生命周期,最重要的规则是初始化阶段不产生副作用、真正产生写操作的动作必须放在用户明确点击「构建会场」之后(该规则修复了组件在初始化时偷偷调保存接口、用户只看一眼就已创建活动数据的真实 bug)。 第三版把策划生成前移:Stage 1「活动方案生成 Skill」只给读权限(只查询预算池、类目、标签、历史会场等候选数据,不做任何写操作),以渐进式披露策略先收活动名称、活动时间、至少一个话题「最低三件套」再逐步追问。Stage 2 聚合工作台是独立页面,复用搭建器已有的 H5 编辑页面并叠加可交互遮罩,点击预览组件即在右侧展示该组件配置表单、每次改动即时更新预览并异步持久化,所有写操作(创建话题、创建活动、复制会场、提交审核)由 Stage 2 闭环,发布权限需人工确认后触发。