Qwen-Agent：通义千问官方智能体框架

官方信息表

项目背景

Qwen-Agent 是阿里通义千问团队官方开源的智能体框架，充分利用 Qwen 模型的指令跟随、工具调用、规划和记忆能力。它自带 Browser Assistant、Code Interpreter、Custom Assistant 等示例应用，也是在线产品 Qwen Chat 的后端。2026 年 2 月已支持 Qwen3.5。

核心特性

• Qwen 深度优化：充分利用通义千问的指令跟随、工具调用、规划、记忆能力
• Browser Assistant：浏览器自动化助手
• Code Interpreter：沙箱代码执行
• Custom Assistant：自定义助手
• Qwen Chat 后端：经过大规模真实流量验证
• 多模态：支持 Qwen3-VL 视觉工具调用（缩放、图片搜索、网页搜索）

环境要求

• Python 3.9+
• 通义千问 API Key 或本地 vLLM 部署
• Playwright（浏览器自动化）

部署步骤

pip install -U "qwen-agent[gui,rag,code-interpreter]"
playwright install chromium

使用方法

from qwen_agent.agents import Assistant
bot = Assistant(llm={"model": "qwen-max"}, function_list=["code_interpreter"])

运行内置示例：

python examples/assistant_qwen3.5.py

内置应用

Qwen-Agent 内置三个示例应用：Browser Assistant 通过浏览器插件自动化网页操作；Code Interpreter 在沙箱里执行 Python 代码做数据分析；Custom Assistant 支持自定义工具和提示。它也提供 Qwen3-VL 多模态工具调用示例。

常见问题 FAQ

Q：可以用本地 Qwen 模型吗？ A：可以，配合 vLLM 或 Ollama 启动 OpenAI 兼容接口。

Q：支持微信接入吗？ A：官方提供微信接入示例。

Q：和 LangChain 比有什么区别？ A：深度优化 Qwen 模型，开箱即用浏览器和解释器。

配置项

pip install -U "qwen-agent[gui,rag,code-interpreter]"
playwright install chromium

环境变量：

export DASHSCOPE_API_KEY="sk-..."

更多使用示例

from qwen_agent.agents import Assistant
bot = Assistant(
    llm={"model": "qwen-max"},
    function_list=["code_interpreter", "amap_weather"],
    system_message="你是一个智能助手"
)
# 运行
# for response in bot.run("北京天气怎么样？"):
#     print(response)

跳转链接

• 仓库：github.com/QwenLM/Qwen-Agent
• 文档：qwenlm.github.io/Qwen-Agent
• Qwen Chat：chat.qwen.ai
• DeepPlanning 评测：qwenlm.github.io/Qwen-Agent/en/benchmarks/deepplanning