知识库同步

知识库用于把制度、FAQ、产品资料和内部文档作为检索上下文注入指定路由。它不决定工具权限，也不应保存业务凭据。

写入或覆盖文档

PUT /kb/{kb_id}/docs/{source_key}
Authorization: Bearer <client-token>
Content-Type: application/json

{
  "title": "售后退款规则",
  "content": "Markdown 或纯文本内容",
  "metadata": { "tenant_id": "t_100", "source": "help-center" }
}

使用业务系统的稳定主键构造 source_key。同一 key 再次写入表示覆盖更新，删除时使用同一 key 下架，便于增量同步与每日对账。

GET /kb/{kb_id}/docs
DELETE /kb/{kb_id}/docs/{source_key}

路由只有显式关联知识库时才进行检索。检索结果是模型上下文，不是权限或最终业务事实；涉及实时订单、库存和账号状态时应调用业务工具查询权威数据。