SKILLπ JOURNAL ↗ 工作流

从连接器到审批编排,验收一条 Agent 工作流

以展览制作单为例,对比工具连接和运行框架,验证库存变化、审批以及写入恢复。

一家展览制作公司要把客户提交的布展需求转成内部任务。销售系统有客户编号,项目系统有施工排期,仓库系统有库存数据。团队需要把三份信息汇成一张待审批的制作单。以此为试点,可以同时验证连接方式、运行框架和流程编排。先约定最小交付:找到对应项目,读取库存并生成草稿,由项目负责人确认后才创建任务。

先为每个动作建立连接清单

按动作拆开需求。查询客户用客户编号,查排期用项目编号,查库存用物料编码和库区。创建任务需要项目编号、负责人和审批记录。给每项动作填写数据方向、必填字段、鉴权范围、是否可重试以及成功后的可观察结果。只统计经过试跑的动作。供应商出现在目录里,只表明有一个可考察的入口,具体还需检查接口能否读到目标字段,能否限制写入范围。

销售系统如果只需每天更新一次,可以先接受固定格式的导出文件。排期需要即时查询时,可以评估直接 API、托管连接器或 MCP 服务。直接 API 适合团队有能力维护鉴权和响应映射的情况。托管连接器适合已经覆盖所需动作并且权限范围可接受的情况。采用 MCP 时,检查宿主能否发现工具、传递身份并区分读写权限。用相同的模拟订单比较三种接口的字段完整性、失败反馈和恢复方式,留下决策记录。

用同一份失败样本选框架

如果规则已经明确,例如按项目编号查库存并拼接固定字段,先写一条确定性的流程作为对照。模型可用于把自由文本提炼成候选字段,编号匹配和审批状态则交给明确规则。遇到客户简称不唯一,让系统把候选交给负责人确认。如果任务经常变动、需要根据现场描述在多种查询之间选择,再考虑增加模型规划。

准备三个框架评估用例。第一条正常生成草稿。第二条库存接口限流,运行应暂停并从已完成步骤恢复。第三条审批完成后创建动作超时,系统需先查是否已写入。逐一记录框架怎样保存状态、是否能在批准前阻止写入、能否观察每步的耗时和结果。让一位没有搭原型的同事按说明跑一遍,记录环境准备和故障定位成本。只有当多人协作确实能减少等待,而且独立执行者的输入、输出和权限能分别约束时,再引入额外 Agent。

让每一步都有可检查的产物

第一步识别客户和项目,输出匹配结果与仍有歧义的字段。第二步可并行读取排期和库存,各自输出带查询时间的快照。第三步汇合两份快照,按已知规则检查日期和数量,生成制作单草稿。第四步由负责人批准具体版本。执行创建前再确认排期未变、库存快照仍在有效期内。若信息更新,展示差异并让负责人决定是否重新批准。

用稳定的业务请求编号串起整条流程。审批时保存草稿版本和关键字段,写入时把请求编号传给目标系统。接口支持幂等时沿用同一个键。创建调用超时后先按外部编号查任务,确认不存在且重试策略允许再继续。接口没有按编号查询的能力时,将结果送到人工核对队列。重跑只执行缺失的节点,每个节点保留本次使用的输入版本。测试分别覆盖一次正常提交、重复点击、库存变化和审批过期。

试跑、验收和交接

用虚构的制作单搭预览:客户为青岚展务,项目编号 E-104,搭建日为周四,需要十二个底座。库存接口先返回十五个,等待批准时改为九个。系统应在写入前捕捉变化,记录原快照和新快照,并给负责人一个可操作的下一步。再把库存接口改为返回错误,确认草稿标明缺少哪项信息,没有把缺失值当成零。最后模拟批准后写入成功但响应丢失,验证重启运行后只找到一条任务。

交接包保留动作清单、字段映射、权限范围、接口样例、测试用例和验收证据。将访问令牌放入宿主认可的凭据存储,日志用请求编号定位,省去客户联系人等无关字段。审批人应能看到模型提取的字段来自原需求的哪个位置,并查看确定性规则生成的库存差异。把测试环境和正式环境分开配置,试点只开放已验证动作。

怎样选择辅助技能

连接设计阶段需要核对接口文档和请求响应的能力,先给它脱敏样例和动作清单。选型阶段需要比较流程状态、恢复和审批能力,给它同一套用例与评分依据。浏览器验收可以使用关联的 Webapp Testing,在预览系统确认制作单显示的库存差异、批准按钮的状态以及重复提交后的页面反馈。库存接口的真实写入记录仍应由服务侧测试独立核对。使用前准备可访问的预览地址和测试账号,把会修改数据的路径限制在测试环境。

常见问题

接入数量越多越好吗?先看一条工作流需要哪些动作。只有查询而没有可靠写入的连接器,仍可用于生成草稿。把暂时用不到的动作留到需求明确后逐项验证。

如何判断是否需要保存会话记忆?如果任务可以用项目编号和草稿编号恢复,保存这些业务状态和已确认字段即可。需要跨会话理解缩写时,再明确词典来源、更新者和有效期。

框架可以晚一点换吗?先把业务数据格式、外部动作接口和测试样本独立保存。更换运行框架时用同一组样本验证恢复、审批和重放,再比较维护成本。

连接器升级后突然找不到物料怎么办?先在测试环境用同一物料编号直接查询,比较权限、响应结构和字段值。确认是字段变更后更新映射,复跑库存变化与错误返回用例,再恢复自动创建。若无法确认状态,暂停写入并让负责人核对待执行任务。

当同一项目包含两个展位时,分别给制作单分配子编号。验收时交换两个展位的库存响应,确认流程能发现物料归属不符,并在写入前提示负责人核对。

分享文章X ↗LinkedIn ↗

CONTINUE YOUR WORKFLOW

把这篇教程,用到下一项任务。

按明确的技能关联与共同专题推荐;使用条件以详情和原始来源为准。