知识库 API

概述

知识库 API 用于管理 AI 客服系统的知识条目。通过 API 可以程序化地创建、批量导入、查询、更新和删除知识条目，是构建智能客服知识体系的核心接口。

添加知识条目

创建单条知识条目，支持标题、正文、分类和标签。

POST /api/kf/knowledge
Content-Type: application/json
Authorization: Bearer {access_token}
X-Tenant-Id: {tenant_id}

{
  "title": "如何重置密码",
  "content": "用户可以在登录页面点击"忘记密码"链接，通过注册手机号或邮箱接收验证码进行密码重置。重置链接 30 分钟内有效。",
  "category": "账号管理",
  "tags": ["密码", "重置", "账号"],
  "status": "published"
}

成功响应：

{
  "code": 0,
  "message": "知识条目创建成功",
  "data": {
    "id": "kb_8m3n2p5q",
    "title": "如何重置密码",
    "category": "账号管理",
    "tags": ["密码", "重置", "账号"],
    "status": "published",
    "created_at": "2025-01-15T10:30:00+08:00"
  }
}

💡 提示：知识条目的 content 字段建议使用清晰、简洁的语言，AI 会直接引用内容回答用户问题。避免模糊表述。

查询知识条目列表

GET /api/kf/knowledge/list?category=账号管理&status=published&page=1&page_size=20
Authorization: Bearer {access_token}
X-Tenant-Id: {tenant_id}

查询参数：

• category（可选）：按分类筛选
• status（可选）：published / draft / archived
• tag（可选）：按标签筛选
• keyword（可选）：全文搜索关键词
• page：页码，默认 1
• page_size：每页数量，默认 20，最大 100

更新知识条目

PUT /api/kf/knowledge/{knowledge_id}
Content-Type: application/json
Authorization: Bearer {access_token}
X-Tenant-Id: {tenant_id}

{
  "title": "如何重置密码（更新）",
  "content": "新版密码重置流程：...",
  "tags": ["密码", "重置", "账号", "2025"]
}

删除知识条目

DELETE /api/kf/knowledge/{knowledge_id}
Authorization: Bearer {access_token}
X-Tenant-Id: {tenant_id}

// 响应
{
  "code": 0,
  "message": "知识条目已删除"
}

⚠️ 注意：删除操作不可恢复。如需临时下架知识条目，请将 status 改为 archived，而非直接删除。

批量导入知识条目

支持一次导入多条知识条目，适合从现有文档系统迁移。

POST /api/kf/knowledge/batch
Content-Type: application/json
Authorization: Bearer {access_token}
X-Tenant-Id: {tenant_id}

{
  "items": [
    {
      "title": "退货政策",
      "content": "7 天无理由退货，商品需保持原包装完好。",
      "category": "售后服务",
      "tags": ["退货", "售后"]
    },
    {
      "title": "发票申请",
      "content": "订单完成后可在个人中心申请电子发票，24 小时内开具。",
      "category": "售后服务",
      "tags": ["发票", "订单"]
    }
  ]
}