Qwen-Agent 5分钟快速开始

基于Qwen的智能体框架,快速搭建支持工具调用的AI应用

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Python >=3.8 必需

所需工具

pip

Python包管理

必需

操作步骤

1

安装Qwen-Agent

使用pip安装稳定版本

安装Qwen-Agent包
pip install qwen-agent

预期结果::Successfully installed qwen-agent-xxx 等依赖包信息

确保网络连接正常,可添加 -i https://pypi.tuna.tsinghua.edu.cn/simple 加速

2

设置模型服务

配置DashScope API密钥或部署本地模型服务

设置环境变量(Linux/macOS)
export DASHSCOPE_API_KEY='your-api-key'
设置环境变量(Windows)
set DASHSCOPE_API_KEY=your-api-key

预期结果::无错误提示,环境变量设置成功

如果没有DashScope API,可跳过此步,但后续需要部署本地模型服务

3

运行简单示例

创建一个基础智能体并测试对话

运行Python代码测试智能体
python -c "from qwen_agent import Assistant; agent = Assistant(); print(agent.chat('你好'))"

预期结果::智能体回复如 '你好!我是Qwen智能体,有什么可以帮您的?'

首次运行可能需要下载模型,确保网络畅通

验证成功

智能体正确响应对话请求

看到智能体的回复文本
无错误信息输出

快速提示

模型服务

使用DashScope API可免部署,快速体验

进阶学习

查看examples目录获取更多应用示例

常见问题

1

安装失败,提示网络错误

检查网络或使用国内镜像源如 -i https://pypi.tuna.tsinghua.edu.cn/simple

2

运行时报错 'DASHSCOPE_API_KEY not set'

确保正确设置环境变量或部署本地模型服务

下一步

探索内置工具如代码解释器

参考FAQ启用Docker运行代码解释器

开发自定义智能体

基于BaseTool和Agent类扩展功能

助手