Qwen-Agent 框架说明：面向工具调用与规划的 LLM 应用开发

用途与定位

Qwen-Agent 是一个用于开发 LLM 应用的框架，基于 Qwen 模型的指令遵循、工具使用、规划与记忆能力构建。框架提供原子组件（继承自 BaseChatModel 的 LLM、继承自 BaseTool 的工具）与高层组件（继承自 Agent 的 Agent 类），并附带 Browser Assistant、Code Interpreter、Custom Assistant 等示例应用。来源说明其当前也作为 Qwen Chat 的后端。

开发方式

可按需安装 PyPI 稳定版（可选依赖包含 gui、rag、code_interpreter、mcp），或从源码安装开发版。模型服务可选择 DashScope，也可自行部署 OpenAI 兼容接口（如 vLLM、Ollama）。自定义工具通过 @register_tool 装饰器注册，需声明 description 与 parameters；可继承 Assistant 等内置 Agent，也可继承 Agent 自行实现。框架还提供基于 Gradio 的 WebUI 用于快速启动演示。

工具与能力

LLM 类提供函数调用（工具调用），FnCallAgent、ReActChat 等 Agent 也构建于该能力之上，默认工具调用模板原生支持并行函数调用。代码解释器工具基于本地 Docker 容器实现隔离执行；MCP 支持按示例配置多个 MCP 服务器。针对超长文档问答，来源提到快速 RAG 方案与并行文档问答代理两种路径。

时间线与限制

来源列出多条时间记录，包括 2026 年 2 月 16 日开源 Qwen3.5、2026 年 1 月 27 日开源 DeepPlanning 评测基准、2025 年 9 月 23 日新增 Qwen3-VL 工具调用示例、2025 年 7 月 23 日新增 Qwen3-Coder 工具调用示例与原生 API 工具调用接口支持等；这些为来源标注的时间，不代表当前时间。

需注意：来源声明基于 Docker 的代码解释器仅挂载指定工作目录并做基础沙箱隔离，在生产环境仍应谨慎使用；另有说明指出 Qwen2.5-Math 示例的 Python 执行器未做沙箱隔离，仅适合本地测试、不适用于生产。GUI 需 Python 3.10 及以上。具体版本行为与兼容性建议以官方文档和示例为准。