Documentation
数据源管理
上传和管理知识库数据，为 AI 分析提供上下文支持
数据源管理让您可以上传企业知识库、行业资料等数据，为 AI 分析和内容生成提供准确的上下文支持。
功能概述
数据源管理提供：
- 📤 文件上传 - 支持 CSV、Markdown 文件
- 🌐 远程接口数据源 - 配置远程 HTTP 接口，自动拉取并解析为表格数据
- 🗂️ 数据组织 - 灵活的命名、描述与标签
- 📊 数据统计 - 行数、列数、数据质量评分
- 🔄 手动刷新 - 远程接口数据源可随时同步最新数据
新增数据源（文件与远程接口）
在 仪表板 → 数据源 页面，点击右上角的 新增数据源 按钮，弹窗提供两种来源方式：
- 上传文件：上传本地 CSV / Markdown 文件（单文件 ≤ 10MB）。
- 远程接口：配置一个远程 HTTP 接口，平台会按配置请求接口、解析返回的 JSON，并转换为统一的「行 / 列 / 字段」表格数据。
方式一：上传文件
- 切换到 上传文件 标签页。
- 拖拽或点击选择
.csv/.md文件。 - 填写 数据源名称（必填）、描述、标签。
- 点击 创建数据源，系统会在后台解析文件并生成字段分析。
方式二：远程接口数据源
- 切换到 远程接口 标签页。
- 填写接口配置（详见下方「接口契约」）。
- 点击 测试连接，平台会立即请求接口并展示数据预览（前若干行），用于校验配置是否正确。
- 确认无误后点击 创建数据源，平台会完成首次同步并落库。
- 之后可在数据源卡片上点击 刷新 按钮，随时重新拉取接口的最新数据。
出于安全考虑，远程接口仅支持
http/https协议，且禁止访问localhost与内网地址；接口凭据（Token / API Key / 密码）在保存后不会回显给前端。
远程接口契约
平台作为调用方，按你的配置向远程接口发起请求，并把返回的数据转换为表格。你的接口需要满足以下契约。
接口签名
<METHOD> <URL>?<queryParams>
Headers: <自定义请求头> + <鉴权头>
Body: <body>（仅 POST / PUT，JSON 字符串）
入参（平台 → 你的接口）
| 字段 | 说明 |
|---|---|
url | 接口地址，必须为合法的 http/https URL |
method | 请求方法：GET / POST / PUT |
queryParams | 追加到 URL 上的查询参数（键值对） |
headers | 自定义请求头（键值对） |
body | 请求体，仅 POST/PUT 时使用（JSON 字符串） |
auth | 鉴权方式：none / bearer / apiKey（可放请求头或 Query）/ basic |
dataPath | 响应中数据数组所在路径，点号分隔（如 data 或 data.list）；根节点本身为数组时留空 |
refreshInterval | 自动刷新间隔（分钟），0 表示仅手动刷新 |
timeoutMs | 请求超时（毫秒），默认 15000 |
出参（你的接口 → 平台）
- 响应的
Content-Type必须为 JSON。 - 数据主体必须是对象数组，每个对象代表一行扁平的键值记录。
- 若数组被包裹在响应对象中，请用
dataPath指向数组所在位置。
推荐使用统一信封结构：
{
"code": 0,
"message": "ok",
"data": [
{ "date": "2026-05-01", "visits": 1280, "source": "google" },
{ "date": "2026-05-02", "visits": 1543, "source": "google" }
]
}
对应配置 dataPath = "data"。若接口直接返回数组（根节点即数组），则 dataPath 留空。
平台收到记录数组后会：
- 取各记录键的并集作为列名（以首条记录顺序为准）；
- 按列名提取每条记录的值组成数据行（嵌套对象/数组会序列化为 JSON 字符串）；
- 自动推断字段类型（文本 / 数字 / 日期 / 布尔）并计算数据质量评分。
配置示例
带 Bearer 鉴权、从 data.list 取数的 GET 接口：
| 配置项 | 值 |
|---|---|
| 请求方法 | GET |
| 接口地址 | https://api.example.com/v1/metrics |
| 鉴权方式 | Bearer Token |
| Token | sk_live_xxx |
| Query 参数 | range = 7d |
| 数据路径 | data.list |
| 自动刷新间隔 | 60（分钟） |
上传数据
支持的格式
文档类型
- PDF 文档
- Word 文档 (.docx, .doc)
- Excel 表格 (.xlsx, .xls)
- PowerPoint (.pptx, .ppt)
- 文本文件 (.txt)
- Markdown 文件 (.md)
- CSV 数据文件
限制说明
- 单文件大小：≤ 50MB
- 批量上传：≤ 100 个文件
- 总存储空间：根据套餐
- 基础版：5GB
- 专业版：50GB
- 企业版：无限制
上传方式
单文件上传
上传数据源
选择文件: [浏览文件]
或拖拽文件到此处
文件信息:
• 文件名: 产品介绍.pdf
• 大小: 2.5 MB
• 格式: PDF
数据源设置:
名称: 产品介绍文档
分类: 产品文档
标签: 产品, 介绍, 官方
描述: 公司主要产品的详细介绍
可见性:
● 团队可见
○ 仅管理员
○ 公开（API 可访问）
处理选项:
☑ 自动提取文本
☑ 生成向量索引
☑ 启用语义搜索
□ OCR 识别（图片文字）
[开始上传]
批量上传
批量上传数据源
选择文件夹: [浏览]
或拖拽文件夹到此处
已选择: 25 个文件
总大小: 48.3 MB
文件列表:
☑ 产品A介绍.pdf (2.1 MB)
☑ 产品B介绍.pdf (1.8 MB)
☑ 产品C介绍.pdf (2.5 MB)
...
☑ 市场分析报告.docx (3.2 MB)
批量设置:
默认分类: 产品文档
添加标签: 产品, 2025
可见性: 团队可见
处理选项:
☑ 保留原文件名
☑ 自动分类（基于文件名）
☑ 批量索引
[开始上传] [取消]
上传进度:
████████░░ 80% (20/25)
预计剩余时间: 30 秒
URL 导入
从 URL 导入
URL 地址:
https://example.com/docs/seo-guide.pdf
或批量导入:
https://example.com/docs/guide1.pdf
https://example.com/docs/guide2.pdf
https://example.com/docs/guide3.pdf
导入设置:
☑ 自动检测文件类型
☑ 保留原文件名
☑ 定期同步更新
• 同步频率: 每周
[开始导入]
数据管理
数据列表
数据源列表
名称 类型 大小 更新时间 状态 操作
─────────────────────────────────────────────────────────
产品介绍文档 PDF 2.5MB 2025-11-04 已索引 [查看]
市场分析报告 Word 3.2MB 2025-11-03 已索引 [查看]
客户案例集 Excel 1.8MB 2025-11-02 已索引 [查看]
竞品分析数据 PDF 4.1MB 2025-11-01 处理中 [查看]
SEO 最佳实践 MD 0.5MB 2025-10-30 已索引 [查看]
筛选条件:
• 分类: 全部
• 标签: 全部
• 状态: 全部
• 时间: 全部
搜索: [输入关键词搜索]
当前存储: 12.1GB / 50GB (24%)
文件数量: 156 个
[上传数据] [批量操作]
数据分类
数据源分类
📁 产品文档 (45 个文件)
├── 产品A (15 个)
├── 产品B (18 个)
└── 产品C (12 个)
📁 市场资料 (32 个文件)
├── 行业报告 (20 个)
└── 竞品分析 (12 个)
📁 内部资料 (28 个文件)
├── 公司介绍 (8 个)
├── 服务说明 (12 个)
└── 政策文件 (8 个)
📁 客户案例 (25 个文件)
├── 成功案例 (18 个)
└── 应用场景 (7 个)
📁 培训资料 (26 个文件)
├── SEO 教程 (15 个)
└── 工具使用 (11 个)
[新建分类] [管理分类]
标签管理
标签云
#产品 (45) #SEO (38) #案例 (25) #教程 (20)
#行业报告 (15) #竞品 (12) #2025 (8)
常用标签:
• 产品: 45 个文件
• SEO: 38 个文件
• 案例: 25 个文件
• 教程: 20 个文件
管理标签:
[新建标签] [合并标签] [删除未使用标签]
标签使用建议:
✓ 使用描述性标签
✓ 保持标签一致性
✓ 定期整理标签
✓ 避免过度标签化
数据详情
文档信息
数据源详情: 产品介绍文档
基本信息:
• 文件名: 产品介绍.pdf
• 文件类型: PDF 文档
• 文件大小: 2.5 MB
• 页数: 45 页
• 上传时间: 2025-11-04 10:30
• 上传者: 张三
分类标签:
• 分类: 产品文档
• 标签: #产品 #介绍 #官方 #2025
索引状态:
• 处理状态: ✅ 已完成
• 文本提取: 45 页 / 45 页
• 向量索引: ✅ 已生成
• 语义搜索: ✅ 已启用
内容摘要:
本文档详细介绍了公司的主要产品系列，
包括产品特性、使用场景、技术参数等内容...
使用统计:
• 引用次数: 28 次
• 搜索命中: 156 次
• 最后使用: 2 小时前
[预览] [编辑] [下载] [删除]
内容预览
文档预览
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
产品介绍文档
第一章：产品概述
1.1 产品简介
我们的产品是一款专业的 SEO 优化工具...
1.2 核心功能
• 网站分析
• 关键词研究
• 竞品监控
• 内容优化
1.3 产品优势
相比市场上的其他产品，我们具有以下
独特优势...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
页数: 1 / 45
[上一页] [下一页] [跳转]
文本选择:
[复制选中文本] [引用内容]
版本历史
版本历史
版本 时间 上传者 大小 说明
────────────────────────────────────────────────
v3 2025-11-04 10:30 张三 2.5MB 更新Q4数据
v2 2025-10-15 14:20 李四 2.3MB 修正错误
v1 2025-09-01 09:00 张三 2.1MB 初始版本
[查看v3] [对比版本] [恢复到此版本]
版本对比:
v3 vs v2 的变化:
• 新增内容: 3 页
• 修改内容: 5 处
• 删除内容: 1 页
• 大小变化: +200KB
[查看详细对比]
数据搜索
语义搜索
智能搜索数据源
搜索框: [如何优化产品页面的 SEO]
搜索结果 (找到 8 个相关内容):
1. 产品 SEO 优化指南 (相关度: 95%)
产品文档 / 产品A介绍.pdf
...产品页面的 SEO 优化需要注意以下几点：
标题标签应包含核心关键词，Meta 描述要吸引
点击，产品图片需要优化 Alt 标签...
[查看全文]
2. 电商网站优化案例 (相关度: 88%)
客户案例 / 成功案例.pdf
...该客户的产品页面优化包括：标题优化、
内容丰富度提升、结构化数据添加...
[查看全文]
3. SEO 最佳实践 (相关度: 82%)
培训资料 / SEO教程.md
...产品页面是电商网站的核心，优化要点包括...
[查看全文]
筛选选项:
• 分类: 全部
• 文件类型: 全部
• 时间范围: 全部
• 相关度: > 80%
[导出搜索结果]
高级搜索
高级搜索
搜索条件:
• 关键词: SEO 优化
• 分类: 产品文档
• 标签: 包含 #产品
• 文件类型: PDF, Word
• 上传时间: 最近 3 个月
• 文件大小: 1MB - 5MB
• 上传者: 任何人
语义搜索选项:
☑ 启用语义理解
☑ 包含相似概念
☑ 多语言支持
□ 仅精确匹配
排序方式:
● 相关度
○ 时间（新到旧）
○ 时间（旧到新）
○ 文件大小
○ 使用频率
[搜索]
数据使用
AI 引用
AI 内容生成中的引用
当前对话
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
用户: 请帮我写一段产品介绍
AI: 根据您上传的产品文档，我为您
生成以下介绍：
我们的 SEO 工具具有以下核心功能：
[1] 智能网站分析、关键词研究、竞品
监控等...
引用数据源:
[1] 产品介绍文档 (产品A介绍.pdf)
置信度: 95%
相关段落: 第 3 页，第 2 段
[查看原文]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
数据源使用统计:
• 本次对话引用: 3 个数据源
• 平均置信度: 92%
• 准确性评分: 优秀
引用统计
数据源使用统计
最常引用的数据源:
┌─────────────────────────────────────┐
│ 1. 产品介绍文档 128次 ████████ │
│ 2. SEO最佳实践 98次 ██████░░ │
│ 3. 客户案例集 76次 █████░░░ │
│ 4. 市场分析报告 54次 ███░░░░░ │
│ 5. 竞品分析数据 42次 ██░░░░░░ │
└─────────────────────────────────────┘
引用趋势:
150
100 ╭──╮
50 │ ╰─╮╭─
0 ╭╯ ╰╯
┼──────────────
8 9 10 11
使用场景分布:
• 内容生成: 45%
• 网站分析: 30%
• 报告撰写: 15%
• 问答回复: 10%
[查看详细报告]
数据操作
批量操作
批量操作
已选择: 12 个文件
操作选项:
• [更改分类]
• [添加标签]
• [移动到]
• [下载]
• [重新索引]
• [删除]
批量更改分类:
当前分类: 混合
目标分类: [选择分类]
批量添加标签:
添加标签: #2025 #重要
[应用] [取消]
导出数据
导出数据源
选择导出内容:
☑ 文件本身
☑ 元数据（分类、标签等）
☑ 使用统计
☑ 版本历史
导出范围:
● 选中的文件 (12 个)
○ 当前分类
○ 全部数据
导出格式:
● ZIP 压缩包
○ 文件夹结构
文件名: 数据源导出_20251104.zip
预计大小: 28.5 MB
[开始导出]
同步和备份
数据同步设置
自动同步:
☑ 启用自动同步
• 同步源: OneDrive
• 同步路径: /SEO-Data/
• 同步频率: 每日
• 同步时间: 02:00
同步规则:
☑ 自动上传新文件
☑ 自动更新已修改文件
□ 自动删除已删除文件
☑ 保留本地副本
备份设置:
☑ 启用自动备份
• 备份频率: 每周
• 备份保留: 4 周
• 备份位置: 云端存储
最后同步: 2025-11-04 02:00
下次同步: 2025-11-05 02:00
[立即同步] [查看同步日志]
数据安全
访问控制
数据源访问权限
产品介绍文档
权限设置:
● 团队可见
○ 仅管理员
○ 指定成员
○ 公开访问
团队权限:
• 所有者: 完全控制
• 管理员: 读取、编辑、删除
• 成员: 读取、引用
• 访客: 只读
指定成员访问:
• 张三: 完全控制
• 李四: 读取、编辑
• 王五: 只读
外部分享:
□ 允许通过链接访问
• 链接有效期: 7 天
• 需要密码
• 查看次数限制: 100
[保存权限设置]
审计日志
数据源审计日志
操作记录:
时间 操作人 操作类型 详情
──────────────────────────────────────────
2025-11-04 10:30 张三 上传文件 产品介绍v3.pdf
2025-11-04 09:15 李四 下载文件 产品介绍v2.pdf
2025-11-03 15:20 王五 引用内容 AI 内容生成
2025-11-03 14:10 张三 编辑元数据 更新标签
2025-11-02 11:30 李四 查看文件 产品介绍.pdf
筛选条件:
• 时间: 最近 7 天
• 操作人: 全部
• 操作类型: 全部
[导出日志] [清除日志]
最佳实践
数据组织
命名规范
推荐命名格式:
类别_名称_版本_日期.扩展名
示例:
✓ 产品_A系列介绍_v2_20251104.pdf
✓ 市场_行业报告_Q3_20251001.docx
✓ 案例_客户A成功案例_final.pdf
避免:
✗ 文档1.pdf
✗ 新建文档(1).docx
✗ 未命名.pdf
分类策略
- 按业务线分类
- 按文档类型分类
- 按时间周期分类
- 使用标签补充
内容质量
文档准备
上传前检查清单:
✓ 内容准确无误
✓ 格式清晰规范
✓ 删除敏感信息
✓ 文件大小适中
✓ 命名规范统一
✓ 版本信息清晰
定期维护
- 每月审查数据时效性
- 更新过时内容
- 删除无用文件
- 整理分类标签
- 优化存储空间
使用优化
提高检索效果
- 使用描述性文件名
- 添加准确的标签
- 编写详细的描述
- 保持内容更新
- 定期重新索引
控制存储成本
- 压缩大文件
- 删除重复文件
- 清理历史版本
- 使用增量备份
常见问题
Q: 支持哪些文件格式？ A: 支持 PDF、Word、Excel、PPT、TXT、Markdown、CSV 等常见格式。
Q: 文件大小有限制吗？ A: 单个文件最大 50MB，根据套餐有总存储空间限制。
Q: 上传的数据安全吗？ A: 采用加密存储、访问控制、审计日志等多重安全机制。
Q: 可以删除已上传的文件吗？ A: 可以，但如果文件被引用，建议先检查影响范围。
Q: 如何提高搜索准确度？ A: 使用准确的关键词、添加相关标签、保持文档内容质量。
Q: 数据会被用于其他用途吗？ A: 不会，您的数据仅用于为您提供服务，严格保密。