agno
Python Agent 开发框架:一条命令搭建生产级 Agent 服务,内置鉴权、追踪与多模型支持
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
Python Agent 开发框架:一条命令搭建生产级 Agent 服务,内置鉴权、追踪与多模型支持
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
图1:Agno 官方 Logo
想象一下,你刚用 LangChain 写好了一个 AI Agent,产品经理跑过来问:"这个能支持多用户吗?能加权限控制吗?线上跑的时候能看到每次调用的情况吗?"
你打开代码,发现——没有,这些都没有。你需要从头写 Session 管理、写 JWT 鉴权、接 OpenTelemetry、写数据库迁移……一个本来只想"让 AI 帮用户整理文件夹"的 Agent,光生产级基础设施就要搭上好几天。
这就是大多数 AI Agent 开发者正在经历的现实:框架帮我们解决了"怎么让 AI 思考",但没有解决"怎么让 AI 稳定、安全、可控地跑在生产环境里"。
Agno 正是为了解决这个问题而诞生的。
Agno 由开发者 Ashpreet Bedi 创建,定位是 "Agent 平台 SDK",与当时已经占据主流的 LangChain、CrewAI 不同,Agno 从一开始就走了一条差异化路线:不追求做"最大的框架",而是做"最能上生产的基础设施层"。
项目于 2024 年快速崛起,GitHub 星标数从年初的几千一路飙升至 4 万+,成为 2024-2025 年 AI Agent 领域最受关注的新框架之一。背后有几个原因:
核心 Slogan 很直接:"Build, run, and manage agent platforms" —— 做 Agent 平台,不是做 Agent 本身。
如果把开发 AI Agent 比作"开一家餐厅":
换句话说,Agno 把"怎么让 Agent 在生产环境跑得稳"这件事封装好了,开发者只需要专注于"让 Agent 做什么事"。
Agno 的核心亮点是 AgentOS(Agent Operating System)。这不是一个操作系统,而是一个完整的生产级 Agent 运行框架,提供了:
| 功能模块 | 具体能力 |
|---|---|
| API 层 | 50+ REST 端点,支持 SSE 流式输出和 WebSocket |
| 会话管理 | SQLite/PostgreSQL 等多种数据库存储,持久化对话历史 |
| 内存系统 | Agentic Memory,Agent 能跨会话记住关键信息 |
| 知识库 | 支持向量检索,构建 RAG 知识增强 |
| 链路追踪 | OpenTelemetry 集成,每次调用全程可追溯 |
| 权限控制 | JWT-based RBAC,多用户/多租户隔离 |
| 人工审批 | Human-in-the-loop,敏感操作可暂停等人工确认 |
用 20 行代码就能启动一个完整的、带 Web UI 的 Agent 服务,开发者反馈"2 分钟就能跑起来"。
Agno 最大的技术亮点之一是框架无关。它不要求你用 Agno SDK 写 Agent,而是可以接入:
这解决了一个长期痛点:换框架不需要重新部署,重新搭建基础设施。
Agno 提供了超过 100 种预置工具包(Toolkits),覆盖:
开发者不需要自己写 API 调用封装,直接引入 toolkit 即可。
Agno 支持构建 Agent Teams——多个 Agent 分工协作,共享工具和上下文,适合复杂任务的分解执行场景。例如一个"调研 Agent Team"可以包含:搜索 Agent、分析 Agent、写作 Agent,各司其职。
从代码层面看,Agno 的技术选型非常务实:
agno[os] 安装可选依赖Python 版本支持 3.7~3.12,依赖极简,不引入大型 ML 依赖链,对已有系统侵入性低。
pip install agno
# 或
uv pip install agno
from agno.agent import Agent
agent = Agent(model="openai:gpt-4o", tools=[...])
agent.print_response("帮我整理桌面文件")
agno[os])pip install 'agno[os]'
fastapi dev app.py
# 打开 os.agno.com 连接本地服务,浏览器访问 Web UI
门槛提示:Agno 的 SDK 用法确实简洁,官方宣称"20 行代码跑起来",但如果要做生产部署,需要理解 FastAPI 路由、Session 存储、数据库配置等概念,有一定 Web 开发背景会更容易上手。
作为快速迭代的项目,部分功能文档存在滞后,新版本 API 变更时文档更新不够及时。
LangChain 有 thousands of 社区教程、Stack Overflow 答案,Agno 的社区积累相对较少,遇到问题需要更多靠自己排查。
没有提供 Dockerfile 或 docker-compose,对习惯容器化部署的团队来说需要自己编写。
AgentOS 的多租户隔离、高并发场景下的 Session 管理,在超大规模部署场景下的稳定性尚未经过充分验证。
Agno 的出现代表了 2024-2025 年 AI Agent 开发领域的一个趋势转变:
从"怎么让 AI 更聪明"转向"怎么让 AI Agent 更可靠"。
它没有试图重新发明 LLM 调用方式,而是把精力放在了:上线后怎么管、怎么监控、怎么扩展、怎么安全——这些问题才是企业真正买单的关键。
从 Stars 增长曲线看,Agno 的增速在同类型项目中名列前茅,代表了开发者社区对"轻量 + 生产级"框架的强烈需求。随着 Agent 应用从 Demo 走向落地,Agno 这类专注于"Agent 基础设施"的项目价值会越来越凸显。
# 1. 安装
pip install agno openai
# 2. 设置 API Key
export OPENAI_API_KEY=sk-...
# 3. 写 Agent
python -c "
from agno.agent import Agent
Agent(model='openai:gpt-4o').print_response('给我讲一个关于 AI Agent 的有趣故事')
"
# 4. 带 Web UI 启动
pip install 'agno[os]'
# 参考文档: https://docs.agno.com/first-agent
项目主页: https://agno.com | 文档: https://docs.agno.com | GitHub: https://github.com/agno-agi/agno