27 lines
2.0 KiB
Markdown
27 lines
2.0 KiB
Markdown
# paper_server 来源
|
||
|
||
`paper_server` 以 OpenAlex 元数据为基础，并按记录实际可用性提供摘要、PDF 或 XML。当前语料以英文为主，也包含中文记录。
|
||
|
||
## 调用
|
||
|
||
使用宿主侧 typed tools，凭据不会进入 sandbox：
|
||
|
||
- `paper_server_search(keyword="", publication_type="", year=None, year_gte=None, year_lte=None, doi="", first_author="", publication_name="", has_pdf=None, is_oa=None, limit=10)`：搜索题录并返回摘要和全文可用状态。统一出版物类型 `book` 映射为来源原始值 `book`，`book_chapter` 映射为 `book-chapter`；能确定来源类型时用 `publication_type` 做服务端过滤。
|
||
- `paper_server_get(id_or_doi)`：按内部 ID 或 DOI 获取完整记录。
|
||
- `paper_server_fetch(id_or_doi, format)`：把记录实际提供的 `pdf` 或 `xml` 保存到任务的 `papers/` 目录。
|
||
|
||
工具由平台自动使用 `PAPER_SERVER_API_KEY` 和可选的 `PAPER_SERVER_URL`；未配置时本轮不会注册这些工具。只通过这些工具访问，由它们处理认证、URL、响应裁剪和下载路径。
|
||
|
||
## 查询与全文
|
||
|
||
- 将中文概念转换为常用专业英文术语，并按需补中文、缩写、全称或同义词。
|
||
- `publication_type` 使用 paper_server/OpenAlex 的来源原始值；例如统一类型 `book_chapter` 在这里对应 `book-chapter`。能前置确定类型时服务端过滤，跨类型发现或类型不确定时再按来源返回的 `type` 筛选候选。
|
||
- 相关性初筛使用题名和摘要；精确数据、章节、图表或页码必须读取正文。
|
||
- 结构化段落和参考文献优先 XML；版式、页码、公式和图表优先 PDF。只获取记录实际提供的格式。
|
||
|
||
## 失败
|
||
|
||
- 认证失败需要管理员检查 `PAPER_SERVER_API_KEY`。
|
||
- DOI 未命中、格式缺失或服务器文件不存在时，改查其他候选或使用现有摘要，并降低证据等级。
|
||
- 只引用返回记录中的真实字段，不补写缺失的 ISBN、出版社、版本或页码。
|