描述
Qwen-Agent 是一个强大、开源的框架,专为开发复杂的语言模型(LLM)应用而设计。它基于 Qwen 模型 3.0 及更高版本的功能构建,为创建能够理解指令、利用工具、规划复杂任务并跨交互保持记忆的智能代理提供了坚实的基础。该框架设计为模块化,提供原子组件,如支持函数调用的 LLM,以及可扩展的通用工具。高级组件(如派生自基类的 Agent)允许开发人员构建自定义代理实现。
Qwen-Agent 的主要功能包括支持函数调用,使代理能够与外部服务和 API 进行交互。它还集成了代码解释器,允许代理在基于 Docker 的沙箱环境中安全地执行代码、处理数据并返回结果。支持检索增强生成(RAG),增强了代理访问和综合大型文档集信息的能力。该框架还支持多轮对话协议(MCP),促进更自然、更复杂的对话流程。提供了浏览器助手、代码解释器和自定义助手等示例应用程序,展示了该框架的多功能性。
Qwen-Agent 被积极用作 Qwen Chat 的后端,证明了其在现实世界中的适用性。该框架专为希望构建高级 AI 应用的开发人员而设计,从简单的聊天机器人到需要工具集成和推理的复杂系统。其可扩展性允许创建自定义工具和代理行为,以满足广泛的用例。该项目还提供了全面的文档和示例,以促进采用和开发。
安装过程很简单,可以选择从 PyPI 安装具有特定功能集(如 GUI、RAG 或代码解释器)的版本,或者直接从源代码安装以获取最新的开发版本。用户可以利用阿里云的 DashScope 模型服务,或使用开源 Qwen 模型部署自己的模型服务。该框架的灵活性还包括配置 LLM 参数以及与各种部署方法集成,包括用于高吞吐量 GPU 部署的 vLLM 和用于本地 CPU/GPU 部署的 Ollama。
Qwen-Agent的核心功能
用于 LLM 应用的 Agent 框架
基于 Qwen>=3.0 模型构建
支持函数调用(工具调用)
包含带 Docker 沙箱的代码解释器
集成了检索增强生成(RAG)
支持多轮对话协议(MCP)
提供示例应用程序(浏览器助手、自定义助手)
用于 LLM 和工具的模块化组件
允许自定义代理实现
提供基于 Gradio 的 GUI 界面
支持并行和多步工具调用
处理长上下文文档问答
Qwen-Agent入门
克隆仓库:从 GitHub 获取 Qwen-Agent 代码。
安装依赖项:使用 pip 安装带有所需功能的包(例如,`pip install -U "qwen-agent[gui,rag,code_interpreter,mcp]"`)。
配置模型服务:设置 DashScope API 密钥或部署本地模型服务。
开发代理:通过继承 `Agent` 来创建自定义代理,或使用内置实现(如 `Assistant`)。
集成工具:定义和注册自定义工具或使用内置工具(如 `code_interpreter`)。
运行代理:以编程方式执行代理或启动 Gradio GUI。
交互:向代理发送查询并接收响应。
Qwen-Agent的使用案例
- 自定义助手开发
- 代码执行和分析
- 文档问答
- 浏览器自动化
- 工具集成
- 复杂任务规划
- AI 聊天机器人后端








