# 内部材料知识库来源

内部知识库覆盖胶凝、陶瓷、玻璃、晶体、复合、耐火和检验检测，提供跨语言语义检索、Markdown 正文片段和原件下载。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/` 目录。

查询可使用中文或英文；复杂专业术语通常使用英文更精确。先规划互不重复的查询并批量调用，不逐个近义词反复搜索。

## 使用深度

- 题名、文件名、正文片段和知识库来源用于候选筛选。
- 片段足以核验局部论断时无需下载原件。
- 数据、公式、表格、章节、页码或版式需要更多上下文时，提高少量候选的片段长度或下载原件。
- 下载只使用搜索返回的 `file_name` 和 `kb_name`，不编造来源标识。

## 失败

- 工具不存在表示宿主未配置 `DOCUMENT_SEARCH_API_KEY`；继续使用其他来源。
- 认证、网络或知识库错误时说明内部材料库当前不可用。
- 未命中时调整术语、语言或库范围；没有新增思路时如实说明覆盖不足。
