Files
LWLT-AIBOT/agent设计规范/business-adaptation-registry.md
2026-09-20 14:59:19 +08:00

13 KiB
Raw Blame History

业务适配登记表

这是跨会话和交付的 Agent/Skill 业务入口。它回答三个问题业务人员怎么输入、ERP 怎么执行、Skill 在哪里维护。运营统一复制入口见运营业务 AI 输入模板总表,其中覆盖全部 19 项系统输入AI 业务路由参考见 business-behavior-registry.md19 项确定性解析的指令、字段、action 和版本唯一机器源见 control-plane/src/business-routes.ts。下表与外部 Agent 继续覆盖原 18 项;新增的散拼批量子单只由 Program 入口接受,不加入 Agent/Skill 指令登记。该机器路由、任务级解析模式快照和组织全自动化规则对获授权员工的手工与 AgentBus 新任务全局共用来源只负责输入和回执适配AgentBus 渠道必须绑定一个员工平台账号,并使用该账号的业务白名单、任务归属、唯一云电脑 worker 和唯一登录节点精确 ERP 身份门禁。ERP 领取队列按不可变的任务归属账号分别保持 FIFO 与单活跃执行,不同账号互不阻塞;管理员只进入账号、渠道、解析策略、自动化设置和审计管理面,不创建、查看、修改、领取或删除业务任务。

状态定义

状态 含义
设计中 输入、ERP 流程或 Skill 契约仍不完整
预检通过 保存前页面流程和 contract 已通过,但没有真实写入证据
已接入 业务系统、插件和回执链路已接通,真实能力可能仍有限定
已真实验证 在记录的授权 ERP 环境中完成写入,并逐条回查成功
已退役 已被新业务/契约替代,只能从 archive 追溯

当前业务

business_id 业务行为 Skill / action 输入模板与示例 ERP 流程 Skill 适配 状态
team_order_batch_create 独立团批量下单 lwlt-newbooking / team_order_batch_create 业务入口 ERP 流程 Skill actions 已真实验证
team_order_create 独立团单个下单 lwlt-newbooking / team_order_create 业务入口 ERP 流程 Skill actions 已真实验证
shared_plan_create 散拼团新增计划 lwlt-newbooking / shared_plan_create 业务入口 ERP 流程 Skill actions 单个/批量母团已重复验证E2E3/E2E4 均证明批量每日期具体子单、客户与 15+1统一发布仍待批准
shared_child_order_create 散拼团单个新增子单/计划 lwlt-newbooking / shared_child_order_create 业务入口 ERP 流程 Skill actions 已重复真实创建并完成后续全生命周期;仍受统一发布门槛约束
passenger_list_import 独立团/散拼子单名单导入/补充 lwlt-lifecycle / passenger_list_importProgram-only 统一输入模板 §6—7;文字定位 + 单个 .xls/.xlsx 附件;程序在前 100 行自动定位唯一 ERP 字段表头,按精确语义从任意表头行和列顺序中选择 11 个必需字段及可选电话列(缺少时输出空值,存在时仍须唯一并校验),并读取其下连续名单数据;身份证、年龄、源证件类型和其他普通额外列忽略且不输出 识别 route 后等待附件 → 程序规范化为加密 13 列 TSV并从唯一严格领队备注行提取姓名/电话 → 读取 ERP 游客位 → 未确认的占用序号要求覆盖确认;确认后所有指定序号强制覆写(同值也写)→ DaoRuDones → 原生游客位不足时返回“名单 N 人超过 ERP 最多 M 人”且不保存 → 恢复未指定行 → 投影领队联系人 → 完整写前投影 → 父页原生保存ERP 明确返回成功即完成,不再逐行写后回查 用户模板 .xls 已只读通过 25 行规范化及单一领队行结构核验;解析阶段不以初始 16/31 行作统一静态上限5000 为技术上限;执行时以精确 ERP 页面实际物化游客位为准。2026-08-28 一笔散拼子单 25 行及领队联系人已持久化全等;另一次独立团 25 人只物化 16 位并在保存前安全阻断 名单与领队联系人真实写入已有一笔证据;0.5.155 起确认覆盖同值也写,0.5.156 起容量不足使用人数/上限业务提示并仅在技术详情保留原始 blocker其他对象/边界继续按发布门槛分级
order_update_shared_plan / order_update_shared_child 散拼母团容量/散拼子单住宿说明 lwlt-updating 统一输入模板:修改 DoInfoSP / DoInfo_order;写前读取当前值 母团容量、子单住宿说明通过;用户只填目标值;无年份定位日期取任务日后的下一次发生日 Skill 全量解析;仅已验证字段自动执行,其他字段保留并转人工复核
order_update_independent 独立团信息修改 lwlt-updating / order_update_independent 统一输入模板 §15 DoInfoJH写前读取当前值SGL/TWN/DBL 分别映射 frenshu0/frenshu1/frenshu3,成人/占床儿童/不占床儿童/领队分别映射 darenshu/xiaorenshu/ertrenshu/quanrenshu 标间数 8→9→8 已有明确响应和 fresh GET无年份定位/目标日期取下一次发生日SGL/TWN/DBL 与四类人数待新版本授权 ERP 实写复测 Skill 全量解析当前插件执行标间数、SGL/TWN/DBL 与四类人数,其他目标保留并转人工复核
arrangement_guide / arrangement_vehicle / arrangement_hotel / arrangement_transport / arrangement_other 安排导游/用车/酒店/大交通/其他备案 lwlt-arrangement 统一输入模板 §8—12 五类 action-specific DoInfo_*,全类 `create clear;酒店另有窄 update`,程序模式支持五类创建指令加“变更”;用车新增/变更支持选填用车类型,与结算单位搜索共同筛选唯一候选;大交通新增/变更支持选填车票说明,与结算单位共同筛选唯一候选;原日期仅定位已有安排,支持 MM-DD 由指定团队中唯一原记录确定年份YYYY-MM-DD 精确匹配,歧义列候选并停止;导游按团队唯一已有导游定位 两类团队共 10 create + 10 clear酒店资源/房型由唯一 ERP 模糊匹配结果带入;大交通省略车票说明时及其他/备案的结算单位组合候选按下拉顺序首条原生联动,其他/备案数量可选,省略时保留 ERP 默认值;散拼母团无子单时 ERP 禁止安排酒店并隐藏提交入口,插件在三项页面证据同时成立时提示先新增子单
arrangement_hotel 安排变更 lwlt-arrangement / arrangement_hotel 统一输入模板 §16 fresh 查询 → 精确未安排或未确认酒店行 → DoInfo_jiudian → 双回查 2026-09-12/8 → 2026-09-13/9,备注与资源保持;无年份目标离店日取下一次发生日 窄能力已真实验证;其他目标转人工复核
order_cancel / order_restore 取消与恢复 lwlt-lifecycle 统一输入模板 §17—18 列表取消或编辑页状态;列表恢复禁用 三类对象及母子传播共 7 次状态验证通过;无年份定位日期取任务日后的下一次发生日 已接入分段执行链;统一发布待批准
confirmation_export 导出团队文件 lwlt-confirmation / confirmation_export 统一输入模板 §19游客名单=独立团/散拼具体子单,整团游客信息=散拼母团 唯一解析业务对象后取得 ERP 文件源内容 + SHA-256游客文件按 kind 分流:独立团/子单 orders_Visitor.asp?did&tid,散拼母团整团游客 orders_Visitor.asp?tid;整团类型必须单独导出且不得携带子单 did。游客源保留原始 .xls 归档并生成真实 .xlsx 供移动端/AgentBus其余类型转 PDF失败回退源文件 独立团/具体子单 ERP 源读取已有 40/40 证据;散拼母团 tid-only 源有历史真实只读证据,本次已接入严格 Program/Schema/validator/插件分流仍待新版运行态只读复测后台附件、XLSX/PDF 转换、鉴权下载和 OSS provider 已接入 已接入;母团整团游客新分支待授权运行态只读复测,外发仍延后

测试对象的 order_delete 回收能力仍保留在 Schema、插件和生命周期测试夹具中但不属于生产运营业务不登记为用户输入入口。

跨业务成功回执

各业务成功回执追加当前账号、完整团号范围内的团队办理进度及五类当前有效安排明细;散拼子单分别记录,名单只展示最近成功导入人数,文件保留导出事实。该汇总只来源于本系统成功记录,强制删除任务不删除独立业务历史,旧回执保持生成时快照。具体规则见 AgentBus 用户回复契约;实现位于 control-plane/src/team-progress.tsarrangement-ledger.tstask-service.ts,不改变 ERP 执行或用户指令。

列表检索与派发结果边界

0.5.185 起,插件在 ERP 只读目标查询发生主框架移除时,最多等待 8 秒确认当前主文档稳定后重新查询一次;仅同一写入前运行任务可重查,保存及业务候选不唯一不重试。异常保留实际阶段和当时自动恢复诊断,不能仅凭稍后心跳结果推断刷新原因。见当前任务

0.5.184 起,原生业务列表检索在当前主 iframe 文档上验证页面加载完成、原生搜索函数与可用搜索按钮;旧文档被替换时重新取当前文档,检索中再次切换则停止。失败记录缺失条件与耗时,不能把通用检索失败等同于登录失效。派发回执超时后,只读取插件保存结果;同一任务、执行编号和原连接的明确只读检索未写入阻断可以同步关闭待回查状态,不重新执行。其他真实写入不确定状态保持原核验边界。本项本地回归与上线边界见当前任务

新业务登记要求

新增业务时,先复制 业务适配包模板 创建一页式入口,再补本表一行。只有三项核心设计都完成,才可以进入 ERP 代码开发;只有真实回执逐条回查后,才可以标为“已真实验证”。

一页式入口必须链接到:

  • 用户输入模板、字段和正/反例;
  • Skill 主文件及业务 references
  • 标准 operation/结果 Schema
  • ERP mapping、页面适配器、预检、提交和回查工具
  • 测试 fixture、测试命令和真实验证证据。

维护规则

  1. 业务行为名称是给业务人员看的;business_id、Skill 和 action 是系统维护标识,三者必须一一对应。
  2. 修改用户字段时,先更新业务入口和 Skill再检查 Schema、mapping、插件和 fixture。
  3. 修改 ERP 页面流程时,先更新对应业务一页式入口中的 ERP 流程与真实发现证据,再修改插件;不要只改 selector。
  4. 批量业务必须登记完整结果列表和逐条回查状态,不能只保留第一条编号。
  5. 退役内容移入 archive/ 并保留日期和原因,不得继续出现在当前登记表的可执行入口中。