42 lines
2.7 KiB
Markdown
42 lines
2.7 KiB
Markdown
---
|
||
name: documents
|
||
description: 检索内部 7 个材料学科知识库中的论文、书籍及其他学术文档。适合材料领域主题检索、全文语义检索、性能或工艺数据查找；可与 research(paper_server)并用并按 DOI 或题名去重。
|
||
---
|
||
|
||
# Documents
|
||
|
||
`documents` 是内部材料知识库的客户端 skill。知识库覆盖胶凝、陶瓷、玻璃、晶体、复合、耐火和检验检测，提供跨语言语义检索、Markdown 正文片段和原件下载。
|
||
|
||
## 选择与协作
|
||
|
||
- 材料领域主题、性能数据或全文语义检索：优先使用 `documents`。
|
||
- 跨学科发现、精确 DOI 或题录检索：优先使用 `research`。
|
||
- 系统调研、综述或重要引用：可同时查询两者；按 DOI 去重，无 DOI 时按规范化题名、作者和年份去重。
|
||
- 用户已提供文件或个人知识库路径：直接读取该来源。
|
||
|
||
论文、书籍和书籍章节都可作为候选，来源类型本身不决定使用哪个 skill；以相关性、元数据完整度和可核验正文为准。
|
||
|
||
## 工具
|
||
|
||
本 skill 使用宿主工具，API Key 不进入 sandbox：
|
||
|
||
- `document_list_kb()`：列出当前有效知识库。用户未指定材料方向且需要缩窄库范围时调用。
|
||
- `document_search(queries, kb_names=None, classification_ids=None, max_documents=6, content_chars_per_doc=1200)`：批量搜索，返回文件元数据与截断的 `md_content`。中文和英文均可，专业术语可同时准备中英文表达。
|
||
- `document_download(items)`：把选定原件下载到当前任务的 `documents/` 目录。`items` 使用搜索结果中的 `file_name` 和 `kb_name`。
|
||
|
||
工具会自动限制批量大小、去重并控制返回体积。需要更多正文时，对少量高相关候选增加 `content_chars_per_doc`，或下载原件后读取。
|
||
|
||
## 工作流
|
||
|
||
1. 根据用户问题形成少量有区分度的查询；需要分类时先列知识库。
|
||
2. 搜索并依据题名、文件名、正文片段和库来源筛选候选。
|
||
3. 相关性判断可使用片段；论点、数据、公式、表格、章节或页码核验应读取足够正文或原件。
|
||
4. 与 `research` 并查时合并去重，优先保留正文更完整、元数据更可靠的记录。
|
||
5. 输出时区分“仅题录”“片段已核对”“全文已核对”，并标注可追溯的文件名、DOI 或其他真实标识。
|
||
|
||
## 失败与真实性
|
||
|
||
- 工具不可用或认证失败时，说明 `document_search` 当前不可用，并改用 `research` 或用户提供的文件。
|
||
- 未命中时可调整术语、语言或库范围；没有新增检索思路时如实说明覆盖不足。
|
||
- 只使用工具返回的 `file_name`、`kb_name` 和来源信息，不推测缺失的作者、DOI、ISBN、页码或正文内容。
|