Qwen-Agent实战入门3步跑通PDF文档问答助手【免费下载链接】Qwen-AgentAgent framework and applications built upon Qwen3.0, featuring Function Calling, MCP, Code Interpreter, RAG, Chrome extension, etc.项目地址: https://gitcode.com/GitHub_Trending/qw/Qwen-Agent拿到一份15页的PDF想问这篇论文的结论是什么你不必逐页翻完。Qwen-Agent 是基于 Qwen 大模型的开源智能体框架它的文档问答能力可以把 PDF 自动分块你直接提问模型给出带出处的回答它还能自己写代码跑数据分析。这篇文章带你从零到指向文档提问。先搞清 Qwen-Agent 能干什么一个典型场景项目启动前你要从一份上百页的 PDF 报告里抠出几个数据点还要对一堆 CSV 画趋势图。传统做法是人工翻页复制、再手动打开 Excel 画图。Qwen-Agent 把这两件事都交给模型做——它自己读文档、自己写代码把答案和图表直接还给你。核心能力一览文档问答RAG支持 PDF/Word/PPT/TXT/HTML文档先解析分块、带缓存二次问答不重复解析代码解释器模型自主写 Python 并在 Docker 沙箱里执行返回结果和图表Function Calling模型自主调用工具默认模板支持并行工具调用附带 Gradio WebUI、MCP 支持和 BrowserQwen 浏览器助手开箱即用5分钟上手安装并跑通第一次文档问答最小上手路径就 3 步安装框架带 GUI、RAG、代码解释器、MCP 全套依赖pip install -U qwen-agent[gui,rag,code_interpreter,mcp]配置模型密钥export DASHSCOPE_API_KEY你的密钥若自部署 vLLM/Ollama 服务改model_server指向自己的地址即可运行现成示例python examples/assistant_rag.py浏览器会自动打开 WebUI上传你的 PDF 就能提问 小贴士Gradio GUI 需要 Python 3.10 以上环境如果从源码安装git clone https://gitcode.com/GitHub_Trending/qw/Qwen-Agent后pip install -e ./[gui,rag,code_interpreter,mcp]记得带上方括号里的可选依赖否则 RAG 和 GUI 功能装不全。文档问答的分块机制PDF 怎么被模型读懂这个功能解决长文档塞不进模型、硬塞又贵又慢的问题。流程很短核心解析逻辑在 qwen_agent/tools/doc_parser.py它把文档按parser_page_size配置分块同一篇文档第二次提问时直接命中缓存不再重新解析。你只需要这样把文件交给 Agentfrom qwen_agent.agents import Assistant bot Assistant(llm{model: qwen-plus-latest}, files[./paper.pdf])之后发一句这篇论文的结论是什么模型会从相关分块里检索内容作答回答能对应回文档原文。跑代码解释器示例一句话让模型画图表解决有数据但不想手写 pandas 代码的问题。仓库里的 examples/react_data_analysis.py 用 ReActChat 接上内置的code_interpreter工具你带着 CSV 文件提问比如先看一眼文件然后画一条股价走势折线图模型自己写 matplotlib 代码、在 Docker 容器里执行把图返回给你python examples/react_data_analysis.py 小贴士code_interpreter依赖本地 Docker运行前确认 Docker 服务已启动首次构建容器镜像需要几分钟属于一次性开销。实战场景用并行DocQA精读超长论文读论文的人应该最熟悉这个场景拿到新论文先问介绍实验方法再追问主要贡献是什么。examples/parallel_doc_qa.py 走的是并行 QA RAG 召回路线官方 README 提到它在两个长文本基准上超过原生长上下文模型并在 1M token 的大海捞针压力测试中表现完美。运行方式python examples/parallel_doc_qa.py浏览器打开后拖入 PDF中英文都可以直接问用与文档相同的语言提问效果更稳。新手常踩的3个坑及解法报 API 鉴权错误 / 模型无响应→ 原因DASHSCOPE_API_KEY没设置或写错 → 一行解决export DASHSCOPE_API_KEY正确的密钥后重跑示例代码解释器示例报容器相关错误→ 原因Docker 没启动或端口被占用 → 一行解决启动 Docker 服务systemctl start docker或打开 Docker Desktop自部署 QwQ/Qwen3 时工具调用解析乱→ 原因给 vLLM 加了--enable-auto-tool-choice和--tool-call-parser hermes参数Qwen-Agent 会自己解析工具输出两套机制打架 → 一行解决去掉这两个启动参数Qwen3-Coder 除外小结Qwen-Agent 的价值在于一套框架拿到三种能力文档问答、代码执行、工具调用都是几十行代码内跑起来的程度示例目录 examples/ 里还有天气机器人、MCP SQLite、群聊路由等可以直接抄的写法。下一步动作很明确克隆仓库跑一遍python examples/assistant_rag.py上传你自己的 PDF 问第一个问题。【免费下载链接】Qwen-AgentAgent framework and applications built upon Qwen3.0, featuring Function Calling, MCP, Code Interpreter, RAG, Chrome extension, etc.项目地址: https://gitcode.com/GitHub_Trending/qw/Qwen-Agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考