AgentScope 快速上手教程：三步跑通你的第一个多智能体应用-北京尧图网络

AgentScope 快速上手教程三步跑通你的第一个多智能体应用【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscopeAgentScope 是阿里通义实验室开源的多智能体开发框架Python 包名agentscope核心是用几行代码组装一个能调工具、能协作、能托管成服务的智能体Agent。它适合想从零搭建智能体应用、又不想自己写调度循环和权限校验的 Python 开发者。读完本文你会装好环境、在终端里跑通第一个 Agent并知道如何把它升级成一个带 Web 界面的多会话服务。环境准备Python 3.11 装包一次到位AgentScope 2.0 要求Python 3.11 及以上这是本文唯一的硬性前提版本过低会在安装或直接报requires-python错误。确认版本后一条命令装好核心包python --version # 确认 ≥ 3.11 uv pip install agentscope不想用uv的话pip install agentscope同样有效。后续要体验 Agent 服务、沙箱工作区等完整能力时再按提示安装[full]等可选依赖即可。第一个示例终端里聊一个会动手的 Agent跑通第一个 Demo 分三步设置模型密钥。示例使用 DashScope通义千问作为模型先执行export DASHSCOPE_API_KEYsk-你的密钥用 OpenAI、Anthropic 等其它厂商换成对应的 credential 即可。保存下面这段代码为main.py并运行python main.py。预期看到终端打开一个流式对话界面你输入问题Agent 边推理边回答当它要执行工具时会在终端弹出确认按CtrlC可随时中断。import asyncio, os from agentscope.agent import Agent from agentscope.console import launch_console from agentscope.credential import DashScopeCredential from agentscope.model import DashScopeChatModel from agentscope.tool import Toolkit, Bash, Read, Grep, Write async def main(): agent Agent( nameFriday, system_promptYoure a helpful assistant named Friday., modelDashScopeChatModel( credentialDashScopeCredential(api_keyos.environ[DASHSCOPE_API_KEY]), modelqwen3.6-plus, ), toolkitToolkit(tools[Bash(), Read(), Grep(), Write()]), ) await launch_console(agent) asyncio.run(main())这段代码里每个组件都有明确分工Agent是推理-行动的循环主体DashScopeChatModel负责调大模型Toolkit挂上Bash/Read/Grep/Write四个内置工具让 Agent 从只会说话变成能真正读写文件、执行命令。launch_console则把流式输出、工具调用确认、中断这些交互细节全部代办。场景一让 Agent 帮你写代码、查项目把上面的Toolkit理解成 Agent 的手。给 Agent 装上Bash、Grep、Read、Write后你问它帮我在当前目录找出所有 TODO 并汇总它会自己先Grep搜索、再Read相关文件、最后写出汇总而不是一句请你自己去查。框架内置的编码工具shell、文件编辑、搜索都在agentscope.tool模块里另外还支持挂载 MCP 服务器和自定义技能Skill需要更多能力时不用手写胶水代码。场景二从单个 Agent 到多智能体团队协作当任务复杂到单个 Agent 顾不过来AgentScope 的思路是一个 Leader 拉起多个 Worker。你不用手写消息路由Leader Agent 通过内置的 team 工具创建团队、分派子任务各 Worker 并行干活后把结果汇总回来。这套能力随 Agent 服务Agent Service一起提供——一个 FastAPI 后端加预置 Web UI把 Agent 变成多租户、多会话的在线应用。跑起来只需两个终端一个在examples/agent_service下执行python main.py需先启动 Redis 作为存储另一个在examples/web_ui下执行pnpm install和pnpm dev然后浏览器里把接口指向http://localhost:8000就能开聊。运行中的 Agent 还会自动做任务规划Task Planning把复杂工作拆成可跟踪的计划表并实时更新。服务版还有两个新手容易忽略的细节权限系统让你对每次工具调用确认/放行/绕过对应界面右上角的 Default/Bypass 切换长耗时工具会自动转入后台执行结果就绪后再唤醒 Agent 继续对话界面不会卡死。常见坑与排障提示Python 版本不够低于 3.11 装不上或运行报错先换解释器再装别在 3.10 环境里死磕。KeyError: DASHSCOPE_API_KEY环境变量没设或没生效重新export后在新终端验证echo $DASHSCOPE_API_KEY有输出再运行。Agent 服务起不来八成是 Redis 没启动服务依赖它做会话和状态存储Web UI 需要 Node.js 20 以上且带npx。换模型报错model参数填的模型名必须和你的密钥所属厂商匹配src/agentscope/model/下能看到 OpenAI、Anthropic、Gemini、DeepSeek 等各家实现按厂商换对应的 Model 与 Credential 即可。下一步看哪里装完跑通只是起点建议按这个顺序往下走官方文档与路线图在 docs/终端调试的完整可运行版在 examples/console/含长期记忆中间件想直接体验服务版就从 examples/agent_service/ 和 examples/web_ui/ 入手多个 Agent 按固定逻辑串行的流水线玩法见 examples/pipeline/。【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

AgentScope 快速上手教程：三步跑通你的第一个多智能体应用

相关推荐

10分钟数据跑通RVC实时变声：参数选择与高频坑速查

鸿蒙开发实战十五

3个维度×5类工具：打造你的开源效率系统

更多资讯

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

综合之自动售货机2.0

AHT10读取温湿度

ws2812动态滚动显示图片

MIPI协议介绍

【后端】ORM / ODM

今日更新

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

本周精选

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

读完文章，想聊聊您的网站？