知识库问答助手

📚 为 AI 驱动的文档问答构建私有知识库

技能概述

此技能帮助 AI 代理构建和管理私有知识库，支持上传文档（PDF、Word、TXT、Markdown 等），并基于知识库内容提供精准的问答服务。适用于企业知识管理、产品文档问答以及客户服务知识库场景。

核心能力

• 多格式支持：PDF、Word、TXT、Markdown、Excel、PPT 等
• 智能分块：自动将长文档拆分为语义完整的文本块
• 向量检索：基于语义相似性进行精确匹配
• 来源引用：在回答中自动生成参考来源标注
• 批量上传：支持一次性上传多个文档

触发关键词

• /knowledge-qa
• /upload-document
• /document-qa
• /knowledge-base-manage
• /doc-question
• /rag-qa

使用方法

第一步：构建知识库

用户上传文档以建立知识库：

User: 请将这份产品文档上传到知识库
Agent: 请提供文档内容或上传文件

User: [上传 PDF 文件]
Agent: ✅ 文档已成功上传至知识库！

     文档名称：Product Manual.pdf
     文件大小：2.5MB
     页数：45
     状态：已索引，可进行问答

     提取的知识点：23 个
     文本块数量：12 个

第二步：知识库问答

User: 该产品支持哪些支付方式？
Agent: 正在搜索知识库...

     ✅ 找到相关信息！

     回答：该产品支持以下支付方式：

     1. **在线支付**
        - PayPal
        - Stripe
        - 信用卡（支持 Visa、MasterCard）

     2. **离线支付**
        - 银行转账
        - 电汇

     📎 参考来源：产品手册 第 3.2 节，发布日期：2024-01-15

知识库命令

知识库结构

文档存储路径

knowledge_base/
├── documents/
│   ├── doc_001/
│   │   ├── original.pdf          # 原始文档
│   │   └── metadata.json          # 元数据
│   ├── doc_002/
│   │   ├── content.txt           # 提取的文本内容
│   │   └── metadata.json
│   └── ...
└── index/
    └── vector_index.json          # 向量索引文件

元数据格式

{
  "doc_id": "doc_001",
  "filename": "Product Manual.pdf",
  "upload_time": "2024-01-20T10:30:00Z",
  "file_size": "2.5MB",
  "page_count": 45,
  "chunk_count": 12,
  "status": "indexed",
  "tags": ["product", "user-guide", "features"]
}

检索流程

用户提问
    ↓
问题嵌入向量
    ↓
向量相似度匹配
    ↓
返回 Top-K 相关文本块
    ↓
构建提示词上下文
    ↓
大模型生成答案
    ↓
添加来源引用
    ↓
返回最终答案

使用示例

示例 1：企业知识库问答

User: 公司的远程办公政策是什么？
Agent: 正在搜索知识库...

     ✅ 找到相关信息！

     来自《员工手册 2024》第 4 章第 2 节：

     **远程办公政策：**

     | 员工类型 | 远程天数 | 要求 |
     |----------|----------|------|
     | 全职 | 每周 3 天 | 需经理批准 |
     | 兼职 | 每周 2 天 | 必须满足核心工作时间 |
     | 合同制 | 个案处理 | 需与人力资源部门协商 |

     📎 参考来源：员工手册 2024，第 4 章第 2 节

示例 2：技术文档问答

User: 如何配置 OAuth2.0 登录？
Agent: 正在查找技术文档...

     ✅ 找到配置指南！

     **OAuth2.0 配置步骤：**

     1. **注册应用**
        在 OAuth 提供商处注册应用，获取 client_id 和 client_secret

     2. **配置回调地址**
        设置授权回调 URL：https://your-app.com/callback

     3. **实现认证流程**

const oauth = new OAuth2({

clientId: 'your_client_id',

clientSecret: 'your_client_secret',

redirectUri: 'https://your-app.com/callback'

});

     📎 参考来源：开发者文档 第 5.2 节

示例 3：批量文档上传

User: 我想上传以下 3 个文档到知识库：
1. Product Introduction.pdf
2. Technical Whitepaper.docx
3. FAQ.md

Agent: 正在批量上传...
     ✅ 上传完成！

     | 文档 | 状态 | 知识点数量 |
     |------|------|------------|
     | Product Introduction.pdf | ✅ 成功 | 15 |
     | Technical Whitepaper.docx | ✅ 成功 | 28 |
     | FAQ.md | ✅ 成功 | 42 |

     📚 知识库统计：
     - 总文档数：3
     - 总知识点：85
     - 文本块数量：12

配置选项

检索参数

分块策略

技能名称：knowledge-base-qa-assistant

版本：1.0.0

分块：2/2

使用注意事项

1. 文档质量：上传前请确保文档清晰、格式规范
2. 隐私保护：上传敏感文件时需谨慎，避免泄露重要信息
3. 知识库更新：文档更新后请重新上传以刷新索引内容
4. 文件大小限制：建议单次上传不超过 50MB
5. 索引延迟：上传后约 1-5 分钟完成索引处理

应用场景

• 🏢 企业知识管理：员工手册、产品文档、技术资料
• 📖 在线教育：课程材料、教材问答支持
• 🛒 电商客服：商品常见问题、购物指南
• 💼 法律合规：合同条款解读、法规说明
• 🏥 医疗健康：健康指导、用药说明

技术实现

核心组件

knowledge_qa/
├── uploader.py          # 文档上传模块
├── parser.py           # 文档解析模块
├── chunker.py          # 文本分块模块
├── indexer.py          # 向量索引模块
├── retriever.py        # 检索模块
└── generator.py        # 答案生成模块

API 使用示例

# 1. 上传文档
result = upload_document(file_path, knowledge_base_id)

# 2. 获取相关知识片段
chunks = retrieve(query, top_k=5, threshold=0.7)

# 3. 生成回答
answer = generate_answer(question, context_chunks)

更新日志

v1.0.0 (2024-01-20)

• 初版发布
• 支持 PDF、Word、TXT、Markdown 格式
• 实现向量检索与 RAG 问答功能
• 支持答案来源标注

作者信息

• 作者：AI Agent Helper
• 版本：1.0.0
• 框架：OpenClaw