电商小二复用 FSB 的专家团服务,搭建飞书中的业务问答闭环。FSB 全称 Full Stack Builder,即全栈工作台。
核心设计是:专家协作复用平台服务,业务流程留在接入层;横向增加专家扩展领域,纵向增强单个专家深化处理能力。本文重点解释这条开发路径,以及应用侧需要实现的接口与状态边界。
一 复用 Agent 协作服务

Agent 即智能体。团队过去搭建这类系统,通常要用 LangChain 等框架组合角色、协调、上下文、工具与运行流程,开发量较大。
LangChain 已支持子 Agent、路由和工作流等模式。本文比较的是团队自行组合框架的方式与复用现有 FSB 服务的方式。LangChain 多 Agent 官方说明
FSB 专家团配置和协作执行复用平台能力。应用调用 API(Application Programming Interface,应用编程接口),实现消息入口、工单、反馈及结果交付。开发工作由"搭建专家运行组合+业务接入",转向"复用平台+业务接入+专家能力配置"。
可复用的是既有协作服务,具体配置变化和部署方式依平台契约决定。
二 业务接入层保持稳定的调用边界

应用侧使用 FsbAnswerPort 这个接口隔离 FSB 客户端。新会话调用 answer,追问调用 continueAnswer;上游已开始执行时,通过 poll 接续已有结果。
会话、子工单和回答尝试仍由业务应用维护。消息队列 MQ(Message Queue)触发异步执行,数据库保存业务事实,FSB 处理专家协作任务。
下面是已有调用能力的职责边界示意,省略执行权、交付与异常处理:
java
FsbAnswer result = sessionId == null
? fsb.answer(question, progress)
: fsb.continueAnswer(question, sessionId, progress);
主理人 Agent 标识与专家团 UUID 分别配置。UUID 是 Universally Unique Identifier,全局唯一标识符。新增专家首先调整专家团能力;只要调用与输出契约兼容,就能沿用适配层。
三 横向扩展以领域职责为单位

把领域知识与处理流程放进相应专家,明确职责、需要哪些输入、输出哪些证据。订单、支付、退款、库存和活动规则只是角色示例,不代表当前已部署的成员数量。
应用层不逐个硬编码这些专家的业务判断。专家如何组织协作由现有专家团配置决定,业务层继续通过同一类会话接口收发问题。
新增角色后,需要用跨领域问题验证结果归属、汇总完整性与成本。横向扩展是覆盖范围的增加,不代表计算资源无限或回答时间必然下降。
四 纵向扩展围绕一个专家逐步建设能力

先补齐业务术语与规则,再沉淀排查 SOP(Standard Operating Procedure,标准操作流程);需要实际取证时,再接入经过授权的工具与数据接口,并增加验证样例。
比如支付页面超时,专家应先明确环境与时间,再区分页面现象、支付状态和待确认信息。工具未接入时只能给步骤与证据缺口,不能声称已经查询流水。
六项诊断结构为结论、证据、查询时间、已检查步骤、未确认事项、下一步。应用保留原文,结构完整时派生可选模型,用于展示和人工交接;解析成功不等于证据已验证。
当前已沉淀 SOP 和输出规范,新增只读业务接口仍在契约阶段,附件理解暂缓。能力深化要以真实接入和验证结果为准。
五 用小闭环启动 再沿两个方向扩展

先选一种边界清楚的问题,配置可用专家团并验证输入输出;随后适配会话、流式消息和结果读取,把消息入口与答案返回接起来。
基本闭环后,再补多轮追问、反馈、人工接续和观测。扩展阶段通过增加专家覆盖领域,通过深化单个专家补知识、流程和授权能力。
"快速"的前提是可用 FSB 服务、访问权限和消息渠道配置。平台减少的是重复建设专家协作层的工作,接入团队仍需要处理认证、权限、持久化与恢复。
六 流式交付作为接入层配套能力

SSE 是 Server-Sent Events,服务器发送事件。客户端累加正文片段,形成当前快照,约两秒节流更新原卡片。
HTTP(Hypertext Transfer Protocol,超文本传输协议)的 PATCH 方法用于局部修改已有卡片。PATCH 是请求方法名,不是缩写。最终更新取得 ACK(Acknowledgement,接收确认)后,再确认交付;中间预览失败不终止生成。
一轮流结束可能只是委派输出完成。恢复时,已有最终答案就重试交付,生成已开始就读取已有任务结果,不能随意重发问题重复委派。
Outbox 是 Transactional Outbox,事务发件箱模式,名称不是缩写。工单、待发事件与会话轮次同事务保存,后台再发布;发布后标记前退出仍可能重复投递,消费者需要幂等。
七 会话顺序与人工接管属于业务状态

同会话按受理顺序执行,不同会话可并行。数据库短事务协调活动工单与队首,远程请求在事务外。这与专家团内部如何协作属于不同边界。
群聊追问按群、根话题与原提问人隔离。只有原提问人主动选择才转人工;调用前检查执行权,调用后核对状态,必要时修复在途更新造成的卡片覆盖。
这些机制用于把平台能力可靠接进业务。平台复用与专家扩展承担能力建设,SSE、Outbox 等已有模式承担交付支撑。
术语速查
| 术语 | 完整英文或名称 | 本文含义 |
|---|---|---|
| FSB | Full Stack Builder | 全栈工作台及其可复用的专家团能力 |
| Agent | Agent,非缩写 | 智能体 |
| API | Application Programming Interface | 对接平台能力的应用编程接口 |
| SOP | Standard Operating Procedure | 标准操作流程 |
| SSE | Server-Sent Events | 服务器持续向客户端发送事件 |
| HTTP | Hypertext Transfer Protocol | 客户端与平台通信使用的协议 |
| PATCH | HTTP PATCH,非缩写 | 局部修改卡片内容的请求方法 |
| ACK | Acknowledgement | 本文指更新被平台接收,不等于用户已阅读 |
| Outbox | Transactional Outbox,非缩写 | 业务数据与待发事件同事务落库的模式 |
| MQ | Message Queue | 异步触发执行的消息队列 |
| UUID | Universally Unique Identifier | 标识主理人、专家团等对象的唯一标识符 |
FSB 专家团可以类比 WorkBuddy 专家团的协作模式,平台底层实现不能据此画等号。WorkBuddy 官方专家说明