RAG 智能问答
● HYBRID RAG知识库管理
按业务、项目或部门组织资料。每个知识库独立检索，上传文档后会自动解析、分块并进入检索索引。
文档管理
集中管理知识库原始资料与文本分块。支持 PDF、DOCX、TXT、Markdown、CSV、JSON、HTML 等常见格式。
拖放文件到这里，或点击选择文件
单个文件最大 20 MB · 上传后自动解析与分块 · 当前知识库：企业知识库
| 文档 | 所属知识库 | 分块数 | 大小 | 状态 | 操作 |
|---|
检索测试
单独验证 Query Rewrite、BM25、向量召回、RRF 融合和重排结果，定位知识库召回问题。
模型管理
答案生成统一使用 DeepSeek 官方 API，可在 V4 Flash 与 V4 Pro 之间切换；Embedding 和 Reranker 保持独立配置。
DeepSeek 答案生成模型
统一使用 DeepSeek 官方 API。选择模型后，智能体设置中的思考模式和强度会作为实际 API 参数发送。
向量模型 · Embedding
将文档片段转换为向量，用于语义召回。配置后，新上传文档会尝试生成向量。
重排模型 · Reranker
可接入 BGE Reranker 等兼容 rerank 请求格式的服务，对候选证据进行二次排序。
智能体管理
先选择一个智能体开始对话，或创建多个用途不同的智能体。每个智能体有独立的人设、回复风格和行为参数。
API Key 管理
创建独立密钥，让外部程序通过 API 调用智能体与知识库。密钥完整值只在创建时展示一次。
| 名称 | 密钥前缀 | 创建时间 | 最近使用 | 状态 | 操作 |
|---|
API 接口文档
使用 API Key 通过 HTTP 控制智能体。支持智能体列表、知识库列表和 RAG 问答。
鉴权方式
所有 /api/v1 接口都需要 Bearer Token。
Authorization: Bearer YOUR_API_KEY
POST /api/v1/chat/completions
OpenAI 风格请求结构，支持 agent_id、kb_id 和 response_style。
curl http://127.0.0.1:18768/api/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"messages":[{"role":"user","content":"总结知识库重点"}],"agent_id":"agent_default","response_style":"professional"}'GET /api/v1/agents
查询可调用的智能体列表。
curl http://127.0.0.1:18768/api/v1/agents -H "Authorization: Bearer YOUR_API_KEY"
GET /api/v1/knowledge-bases
查询可用知识库及文档数量。
curl http://127.0.0.1:18768/api/v1/knowledge-bases -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/agents
通过 API 新建智能体。
{"name":"合同助手","description":"合同问答","config":{"system_prompt":"你是一名合同分析助手","response_style":"professional"}}POST /api/v1/knowledge-bases
通过 API 新建知识库。
{"name":"合同库","description":"合同与法务资料"}可选回复口吻
professional 专业 humorous 幽默 concise 简洁 detailed 详细 friendly 友好 balanced 平衡
智能体搭建
基础信息
定义智能体的名称与用途，让团队成员能够快速识别它适合处理的任务。
人设与指令
把角色、任务步骤、输出格式和限制条件写成可执行的指令。避免把 API Key 或密码写入提示词。
模型与推理
按任务复杂度选择模型与推理模式。API Key 统一使用「模型管理」中已保存的凭据。
回复与能力
统一设置默认回复口吻与联网检索行为；这些选项会直接参与后续回答生成。
结论先行，条理清晰；必要时列出步骤与依据。
检索配置
控制分块长度、重叠长度、返回证据数量和混合检索策略。调整后只影响后续上传和检索，不会自动重建旧文档。
文档分块策略
将长文档切分为可检索片段。分块太小可能丢失上下文，太大则可能降低召回精度。
检索策略开关
可单独启用或关闭检索链路中的各个阶段，便于排查召回质量问题。