Arxiv Paper 工具

ArxivPaperTool 在 arXiv 中搜索与查询匹配的论文，并可选择下载 PDF。

`ArxivPaperTool`

描述

ArxivPaperTool 查询 arXiv API 获取学术论文，并返回简洁、可读的结果。它还可以选择性地将 PDF 下载到磁盘。

安装

除了 crewai-tools 之外，此工具无需特殊安装。

shell

uv add crewai-tools

无需 API 密钥。此工具使用公开的 arXiv Atom API。

入门步骤

初始化工具。
提供 search_query（例如 "transformer neural network"）。
可选地在构造函数中设置 max_results（1–100）并启用 PDF 下载。

示例

python

from crewai import Agent, Task, Crew
from crewai_tools import ArxivPaperTool

tool = ArxivPaperTool(
    download_pdfs=False,
    save_dir="./arxiv_pdfs",
    use_title_as_filename=True,
)

agent = Agent(
    role="Researcher",
    goal="Find relevant arXiv papers",
    backstory="Expert at literature discovery",
    tools=[tool],
    verbose=True,
)

task = Task(
    description="Search arXiv for 'transformer neural network' and list top 5 results.",
    expected_output="A concise list of 5 relevant papers with titles, links, and summaries.",
    agent=agent,
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()

直接使用（不使用 Agent）

python

from crewai_tools import ArxivPaperTool

tool = ArxivPaperTool(
    download_pdfs=True, 
    save_dir="./arxiv_pdfs",
)
print(tool.run(search_query="mixture of experts", max_results=3))

参数

初始化参数

download_pdfs（bool，默认 False）：是否下载 PDF。
save_dir（str，默认 ./arxiv_pdfs）：保存 PDF 的目录。
use_title_as_filename（bool，默认 False）：使用论文标题作为文件名。

运行参数

search_query（str，必填）：arXiv 搜索查询。
max_results（int，默认 5，范围 1–100）：结果数量。

输出格式

该工具返回人类可读的论文列表，包含：

标题
链接（abs 页面）
摘要/概述（截断）

当 download_pdfs=True 时，PDF 会保存到磁盘，摘要中会提及已保存的文件。

使用说明

该工具返回带有关键元数据和链接的格式化文本。
当 download_pdfs=True 时，PDF 将存储在 save_dir 中。

故障排查

如果遇到网络超时，请重试或减少 max_results。
无效 XML 错误表示 arXiv 响应解析问题；请尝试更简单的查询。
保存 PDF 时可能出现文件系统错误（例如权限被拒绝）；请确保 save_dir 可写。

错误处理

网络问题、无效 XML 和操作系统错误都会通过信息丰富的消息进行处理。