定制系统需要交给 Agent 使用时，建议把交付清单从接口地址扩展到业务动作。每个动作写清要完成什么、需要哪些输入、在哪些状态允许执行、输出什么结果，以及失败后缺什么。业务负责人能够读懂这张清单，技术团队再补对应接口。
适用范围包括新建系统预留 AI 接入、现有 ERP 补接口，以及多家团队分别交付业务系统与 Agent 的项目。先选实际要运行的任务，逐项补齐，无需一次开放全部模块。
业务动作卡的最小内容
“修改订单”范围太宽，可以拆为补充收货联系人、调整未确认交期、提交交期变更申请等动作。每种动作的条件和结果不同，应分别说明，不能都藏在一个自由填写的备注字段里。
| 动作卡项目 | 应提供的内容 | 接入人员需要据此判断什么 |
|---|---|---|
| 业务目的 | 动作名称与适用对象 | 当前需求是否属于此动作 |
| 输入来源 | 必填字段、单位、允许值 | 哪些可查询，哪些必须追问 |
| 状态前提 | 允许办理的单据阶段 | 当前是否可以执行 |
| 业务规则 | 数量限制、关联要求 | 缺项还是业务拒绝 |
| 结果定义 | 生成对象、状态、查询入口 | 得到的是草稿还是正式结果 |
| 异常处置 | 拒绝原因与处理岗位 | 下一步找谁、补什么 |
动作卡还应注明维护联系人和适用版本。规则变化时，按动作卡找到受影响的动作与样本，在新规则启用前更新说明并完成验证。
还要写明动作不会顺带完成哪些后续步骤。例如“生成申请草稿”不包含提交审批，“更新联系人”不包含通知对方。这些范围说明应使用业务人员熟悉的名称，与页面显示保持一致。同一动作在接口文档、实施手册和助手说明中使用同一个名称，避免三份材料各叫一套。
遇到两个系统提供相似动作时，在交付表中指定实际使用入口和负责系统。不能让接入团队自行挑选看起来更方便的接口，否则单据可能进入不同流程。
查询与执行的配套能力
一个动作往往需要配套查询。例如创建领料申请前，需要能查生产任务、物料清单和可选择仓库；提交后，需要能按申请号查看明细和当前状态。单独提供创建接口，接入方仍可能无法收集正确输入。
查询结果应明确编号、名称、单位和可用状态。后台诊断应区分对象不存在、没有查看权限和条件下无记录；向调用方展示时，按权限规则决定可见原因，不能向无权人员透露受限对象是否存在。无法读取数据时不返回业务数量零。列表也要明确是否已经返回全部结果。
系统之间的字段与维护交接可参照ERP、CRM 集成项目交付清单。业务动作卡在此基础上补足操作语义，让一次接口调用能对应到一项员工工作。
示例：按生产任务生成领料申请
以下为交付示例：动作名称为“生成领料申请草稿”，输入包括生产任务编号、仓库编号、物料行及申请数量。数量使用物料规定单位，任务必须处于允许领料的阶段。执行结果是申请草稿编号，不代表仓库已经出库。
样本至少包含正常申请、缺仓库、停用物料、超过可申请数量、原任务已取消等情况。每个拒绝结果指出具体物料行与原因，便于 Agent 只追问缺少的信息，避免让员工重新描述整张申请。
若业务需要审批，再单列“提交领料申请”动作，说明审批入口和状态查询方式。把草稿创建与提交混为一项，容易让同一个“成功”在两个团队之间表达不同结果。
字段定义与样本数据
交付资料中应区分空值、零值和未提供。数量为零是否允许，日期留空是清除还是保持原值，备注是否覆盖旧内容，都需要给出可运行样本。修改动作只提交允许变更的字段，不能要求调用方重传整张单据才能补一项信息。
附件也需要单独约定：传的是附件编号还是文件内容，附件是否已经归属对应单据，删除业务记录时附件怎样处理。涉及枚举值时，提供可查询的当前选项，避免靠文档里的旧列表长期硬编码。
测试数据使用虚构编号和示例内容，与生产资料分开保存。不要把真实交易记录复制到对外交付样本里，也不要只交一份所有字段都有值的理想请求。
验收与后续维护
验收由业务人员提供任务描述，接入团队使用交付资料完成输入收集、提交、查询和异常说明。核对结果包括实际生成的单据、关键字段、拒绝原因和未完成步骤。若必须找原开发者口头解释才跑得通，对应说明就应补回动作卡。
更新接口时列明字段和业务语义的变化，保留兼容或迁移安排，并复跑受影响样本。验收方法可结合定制软件验收标准执行；有待补齐的查询或动作能力，则纳入定制开发范围逐项交付。
