文件
文件页面管理角色的共享文件，用户上传文件后可在对话中搜索取回，页面同时提供搜索关键词统计，帮助了解用户的文件检索行为。
页面概览
页面顶部为角色名称和运行状态，右上角为「编辑配置」和「停止」按钮。
共享文件
操作按钮
| 按钮 | 功能 |
|---|---|
| 上传 | 上传新的共享文件 |
| 搜索关键词统计 | 展开/收起右侧搜索统计面板 |
| 视图切换 | 切换文件列表的显示方式 |
搜索
- 搜索框："搜索文件名或简介，按相关度返回..."
- 搜索按钮：执行搜索
空状态
当没有上传任何文件时，页面中央显示：
- 文件夹加号图标
- "暂无共享文件"
- 说明："上传任意文件，用户可在对话中搜索取回"
- 「上传第一个文件」按钮
搜索关键词统计
右侧面板展示文件搜索的统计数据。
核心指标
| 指标 | 说明 |
|---|---|
| 总搜索次数 | 用户搜索文件的总次数 |
| 零结果率 | 搜索后没有返回任何结果的比例 |
热门搜索词
- 标题："热门搜索词"
- 列表：展示用户最常搜索的关键词
- 空状态："暂无搜索记录"
文件管理功能
上传文件
点击「上传」按钮，选择本地文件上传到角色的共享文件库。上传后：
- 文件对所有与该角色对话的用户可见
- 用户可在对话中通过搜索功能查找和取回文件
- 文件会被索引，支持按文件名和内容简介搜索
搜索文件
在搜索框中输入关键词，系统按相关度返回匹配的文件。搜索支持：
- 文件名匹配
- 文件简介匹配
- 相关度排序
对话中引用
用户在与角色的对话中，可以直接请求角色查找和引用共享文件中的内容，角色会自动搜索文件库并返回相关内容。
与知识库的区别
| 对比项 | 文件 | 知识库 |
|---|---|---|
| 用途 | 文件存储和检索取回 | 文档内容的语义检索和引用 |
| 处理方式 | 按文件名和简介搜索 | 文档分段、向量化、语义检索 |
| 对话引用 | 用户搜索取回文件 | 角色自动检索并引用内容片段 |
| 适合内容 | 表格、图片、压缩包等通用文件 | PDF、Markdown、TXT 等文本文档 |
提示
关注「零结果率」指标，如果零结果率偏高，说明用户经常搜索不到需要的文件，建议补充相关文件或优化文件命名和简介。「热门搜索词」可以帮助了解用户最需要哪些类型的文件，有针对性地补充文件库。