Files
LWLT-AIBOT/agent设计规范

Agent 设计规范

当前维护入口:

  1. 项目文件治理规则:规定唯一源、目录边界、同步矩阵、验证和历史治理。
  2. 业务适配登记表跨会话定位每个业务的输入、ERP、Skill 入口和状态。
  3. 业务行为识别注册表:仅负责业务行为到内部 Skill/action 的路由映射。
  4. 运营业务 AI 输入模板总表:业务人员可直接复制的“模板 + 示例”双段式输入目录;模板首行是业务指令,后续逐行业务字段。
  5. 业务适配模板:新增业务的一页式交接模板。
  6. AgentBus 用户回复契约:执行完成后的受理通知、成功回执、失败回传和文件交付边界。
  7. 确定性业务路由注册表:手工与 AgentBus 共用的 19 项程序解析路由、兼容指令、唯一完整字段签名、必填项、类型、action、对象类型和版本的唯一机器源。

第一个已真实验证的参考业务是独立团批量下单

本目录集中管理云端 Agent 数字员工的业务行为路由、生命周期业务 Skill 和业务契约参考。

目录

  • agent-prompt.md:云端 Agent 的业务识别、字段提取和标准 JSON 返回提示词。
  • business-behavior-registry.md:维护人员使用的业务行为与内部实现映射参考,不直接作为云端 Agent Prompt 内容。
  • templates/business-input-templates.md:当前 19 项运营输入的统一契约;每项都有相邻的模板和示例,按“最小必填 + 其余选填”区分字段。散拼团多个新增子单和两项名单固定走 Program Parser不进入外部 Agent独立团信息修改和安排变更归入修改类暂缓需求与测试删除不进入当前生产用户入口。
  • skills/lwlt-newbooking/SKILL.md:解析独立团批量/单个下单、散拼母团计划和散拼具体子单输入。
  • skills/lwlt-updating/SKILL.md:解析三类修改输入中的全部用户明确业务目标;插件按已验证能力自动执行或转人工复核。
  • skills/lwlt-arrangement/SKILL.md:解析五类新增安排和酒店离店日/房间数变更输入。
  • skills/lwlt-lifecycle/SKILL.md:维护独立团/散拼子单名单、取消和恢复契约;名单运行时固定走 Program Parser + Excel 附件规范化,不编排完整生命周期。
  • skills/lwlt-confirmation/SKILL.md:解析导出团队文件的客户/日期检索字段、可选单号、文件类型和接机牌游客姓名,并区分独立团/子单游客名单与散拼母团整团游客信息。
  • test-fixtures/:宿主输入、示例和回归夹具;只供维护与测试使用,不进入运行时 .skill 包。
  • ../control-plane/src/business-routes.tsprogram-parser.ts:业务系统确定性解析的机器路由与编译器;测试强制核对本目录的运营模板和业务登记表。

边界

云端 Agent Prompt 及对应 Skill 与业务系统确定性解析器通常是并列的解析实现,均只输出解析态 operation。两项名单 route 和散拼团多个新增子单是明确例外,固定走 Program Parser其中原始 Excel 先由控制面程序规范化,不进入 AI Prompt。两类解析共享最终契约不查询业务对象不读取当前值不生成内部引用也不描述任务如何执行。控制面在任务创建时固化解析策略后续执行层负责对象解析、候选匹配和实际操作。本目录不负责调用或操作业务系统。

运行时 Skill 包只保留 SKILL.md、必要的 agents/openai.yaml 和按需加载的业务 references宿主接入说明、示例和维护路线放在 test-fixtures/ 或维护文档中。

输出事实标准

对应 Skill 生成 agent_parse_passed/agent_parse_needs_input/agent_parse_blocked 包装和解析态 operationagent_parse_needs_input 表示等待用户补充,且 operation 必须为 nullagent_parse_passed 只表示业务输入已经完整结构化,不表示对象已匹配、任务已执行或结果已完成。解析态契约见 schemas/agent_operation.schema.json,执行态安全契约继续独立维护在 schemas/standard_system_operation.schema.json