AI PROJECT GUIDE

企业知识库接入前,要准备什么?

先确认谁会问、依据什么回答、允许查询什么、何时交给人工,再确定模型、知识库和业务系统的接入范围。

PREPARATION

准备五类材料

业务目标与入口

说明客服、内部员工或运营人员要解决的具体问题,确定接入小程序、APP、网站还是后台。

资料与更新责任

整理可使用的制度、产品手册、FAQ 和操作文档,注明来源、版本、失效日期与更新负责人。先提供脱敏样例。

问题与参考答案

准备真实典型问题、参考答案和来源;同时列出没有资料、容易混淆、需要人工判断的问题。

角色与权限

列出哪些资料公开、哪些仅部门或指定角色可见。检索与接口按实际用户权限校验。

接口与运行条件

列出要查询的系统、账号标识、测试环境和接口负责人;模型调用、存储与网络条件单独确认。

接待与维护方式

说明人工转接、反馈处理、资料更新与异常告警由谁负责,约定后续复核节奏。

PERMISSIONS

先定义可查询和可操作范围

权限检查在检索和业务接口中执行;涉及业务变更的工具按最小范围接入,并约定需要人工确认的动作。

能力前期应确认验收示例
资料问答可用资料、有效版本、引用方式和未知问题处理。答案能对应来源;资料不足时给出约定反馈。
业务查询当前用户身份、接口权限、数据字段与统计口径。不同角色只能查到各自授权的数据。
业务写入允许的操作、二次确认、审计和失败处理。人工确认、取消、重复请求与异常场景按约定测试。

表格可左右滑动查看。

ACCEPTANCE

把演示问题变成验收样本

问题集、判断标准和测试条件由双方事先确认。页面示例用于说明验收方式,具体指标按项目约定。

  • 答案:事实是否正确、是否对应资料来源、资料版本是否有效。
  • 边界:未收录的问题、资料冲突、权限不足和转人工能否按约定处理。
  • 接口:参数错误、超时、重复请求和不可用时,业务系统是否保持正确状态。
  • 成本:约定模型与调用场景下,记录请求量、响应时间和资源成本。
  • 维护:新增资料、撤下旧版本、反馈纠错和回滚流程可操作。

REFERENCES

资料、权限与业务一起评估

权限设计参考

OWASP 建议限制工具功能与权限,由业务系统执行授权检查,并为高影响操作设置人工确认。

已经准备好资料和问题样本?

先描述业务目标、使用角色、资料类型和已有系统;初次沟通可使用脱敏样例,一起确认接入范围。

沟通知识库接入