一个 AI 服务商交付客服 Agent 需要哪些文档

为什么文档比代码更重要

很多 AI 服务商在交付 Agent 项目时，把 90% 的精力放在技术实现上，却忽略了文档体系。结果是：客户验收时说“这不是我想要的”，或者上线后出了问题双方都说责任不在自己。

专业的交付文档不只是保护自己，更是让客户信任你、愿意付钱的关键信号。本文梳理一个完整 Agent 项目交付所需的四类核心文档。

一、报价单

报价单是项目开始前的商务文件。它不只是列价格，而是明确“这个价格包含什么、不包含什么”。

一份清晰的报价单能减少 70% 的后期扯皮。

• 项目名称与版本（如：跨境客服 Agent v1.0）
• 交付物清单：代码仓库、Prompt 文档、部署文档、测试报告、操作手册各几份
• 不在范围内的事项（Out of Scope）：如 UI 设计、服务器购买、第三方 API 费用
• 价格构成：基础交付费 + 定制开发费 + 可选的维护包
• 付款节点：签合同付 30%、提测付 40%、验收付 30%
• 报价有效期：通常 30 天

二、需求确认表

需求确认表是开发开始前，双方对“要做什么”达成共识的文件。它比合同更具体，比会议记录更正式。

需求确认表一旦双方签字，就成为验收的基准。日后客户说“我要的不是这个”，你可以拿这份文件说话。

• 业务场景描述：客户的具体问题是什么，Agent 需要覆盖哪些对话类型
• 数据输入：客户提供哪些数据（FAQ / 订单系统 / 产品信息），格式与权限
• 工具调用列表：Agent 需要调用哪些接口，各接口的 owner 是谁
• 不可回答列表：哪些问题 Agent 必须拒绝或转人工
• 语言与语气风格：正式 / 友好 / 中英双语
• 人工转接触发条件：明确列举关键词或场景
• 验收标准：准确率目标、响应时间、测试用例数量

三、验收单

验收单是项目结束时，客户签字确认“已收到并认可交付物”的文件。没有这份文件，余款往往难以追回。

验收单应在测试完成、客户书面认可后签署，不能仅凭口头确认。

• 交付物逐项核对清单（与报价单/需求确认表对应）
• 测试结果摘要：覆盖用例数、通过率、已知问题与客户接受状态
• 已知问题清单与处理方式（已修复 / 客户接受 / 下一版本处理）
• 系统移交事项：账号、密钥、部署文档是否已交接
• 后续支持条款：免费维护期（如 30 天）、超期收费标准
• 双方签字与日期

四、商用授权书

如果你使用了第三方交付包（如从 AgentPack Store 购买的资产），你需要向客户说明使用了哪些授权范围内的资产，以及客户是否可以二次修改、是否可以部署到多个实例。

商用授权书保护的是双方：服务商不会因为违反上游授权而承担风险，客户也清楚自己拿到的资产的权利边界。

• 使用的第三方组件/交付包名称与来源
• 授权类型：商用授权 / 仅限内部使用 / 不可转售
• 客户二次修改的权利范围
• 部署实例数量限制（如：仅限一个生产环境）
• 保密条款：Prompt 内容是否属于服务商的商业秘密

一套文档模板从哪里来

这四份文档你可以自己从零起草，也可以使用经过实战验证的模板快速适配。AgentPack Store 的每个交付包都附带了这套文档模板，你只需要填写项目名称、客户信息和具体数字，就可以直接用于真实项目。

专业文档是你和其他“只卖代码”的服务商之间最容易被客户感知到的差距。