L1SDK 构建层
Agent、Team、Workflow 三种核心抽象覆盖单兵、编队与流程三类场景;记忆、知识库、护栏(guardrails)与 100 多个预置工具包(GitHub、Slack、Postgres、金融数据等)都在这一层组装[2]。工具以函数装饰器的姿势挂载,写起来接近 FastAPI 的体验。
AGENT STACK 观察 · 第 07 篇
在 GitHub 搜索 phidata,你会被带到一个叫 agno-agi/agno 的仓库——这不是搜索出了错,而是这个项目两年里最关键的一次转身。Phidata 是一个用 Python 构建 AI 智能体的开源框架,靠「给大模型配上工具、知识与记忆」这套简洁抽象在开发者社区迅速蹿红;2025 年初,项目整体更名为 Agno,并从单一框架升级为「框架 + 运行时 + 控制台」的完整智能体平台方案[1]。截至本文定稿,其主仓库星标已突破 4.1 万、复刻数接近六千[1],新一代 agno 3.0.0 也已于 2026 年 8 月 24 日登陆 PyPI[3]。
这篇长文不复述官方 README,而是回答三个更实际的问题:这次改名到底改掉了什么?三层架构分别替工程师省了哪些事?以及,当团队在 Agno、LangChain 与 CrewAI 之间摇摆时,什么信号出现才值得押注前者。
理解 Agno 的最好方式不是读功能列表,而是看它在几个关键路口怎么选的。下面这条时间线上的每个日期都能在公开记录里对上号。
agno.models 命名空间[3]。这一版的 API 断裂面很大,也埋下了后来社区吐槽升级成本的伏笔。官方文档把产品切成三层,这个切法比大多数「框架」竞品都更接近操作系统的思路——每一层都可以单独替换或自建[2]。
Agent、Team、Workflow 三种核心抽象覆盖单兵、编队与流程三类场景;记忆、知识库、护栏(guardrails)与 100 多个预置工具包(GitHub、Slack、Postgres、金融数据等)都在这一层组装[2]。工具以函数装饰器的姿势挂载,写起来接近 FastAPI 的体验。
把你写好的智能体跑成一个无状态的 FastAPI 服务:50 多个 REST 端点开箱即用,流式输出走 SSE 与 WebSocket;会话、记忆与追踪数据写进你自己的 Postgres,而不是某个 SaaS 的黑盒;运行时还顺手内置了一个 MCP server[2][6]。
配套的 Web UI 用来盯会话、追踪、内存与用量数据,配合模拟(simulation)与真实使用反馈,把智能体平台变成一条「学习回路」。官方明确强调:数据、内存与安全边界(JWT 鉴权 + RBAC)都留在你自己的栈里[1]。
官方文档宣称「20 行代码构建你的第一个智能体」[2],下面这段是最接近 phidata 时代教科书案例的现代写法——一个会查股价的分析助手:
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.yfinance import YFinanceTools
agent = Agent(
model=OpenAIChat(id="gpt-4o-mini"),
tools=[YFinanceTools(stock_price=True)],
markdown=True,
)
agent.print_response("特斯拉现在的股价是多少?", stream=True)
三处细节值得一提。其一,模型类从 agno.models 导入是 2.0 之后的规矩,网上大量旧教程还在用 phi. 前缀,照抄必报错。其二,工具包按需安装对应的 extras(比如金融数据组),不必吞下全家桶。其三,协议侧它既能消费外部的 MCP server,也能把自己暴露成 MCP 服务,接入 Claude Desktop 或 Cursor 这类宿主时几乎是声明式的[7]。模型选择上也相当开放:Anthropic、Google、Mistral、Groq、Ollama、vLLM 等几十个模型源都有官方适配组,国产模型通常经由 LiteLLM 或兼容 OpenAI 接口的网关即可接入[3]。
| 维度 | Agno | LangChain / LangGraph | CrewAI |
|---|---|---|---|
| 技术栈 | Python 优先,运行时一体 | Python / JS 双线,生态最大 | Python,角色化抽象 |
| 核心心智 | 智能体即服务,附操作系统式运行时 | 链与图的编排,积木最多 | 一支角色分工的「船员」小队 |
| 生产运行时 | 内置:REST 端点、鉴权、追踪、控制台齐备 | 依赖 LangServe 及周边拼装 | 需自行补齐部署与观测设施 |
| 性能取向 | 主打轻量实例化与低资源占用(官方口径) | 功能全但抽象层次多、栈偏重 | 上手快,规模上去后要看调优 |
| 更适合谁 | 要把智能体当长期在线服务运维的工程团队 | 需要海量现成集成与链式自由的团队 | 想几天内验证多角色协作玩法的团队 |
一句话总结选型逻辑:如果你只是做原型演示,三家差距不大;一旦需求里出现「租户」「审计」「灰度」「值班告警」这类词,Agno 的三层底盘就开始兑现价值——因为它从一开始就是按「运行别人家的生产负载」设计的,而不是按「跑通一个 demo」设计的[2]。
phidata 与 agno 同时存在,旧教程 import phi、新教程 import agno,环境里同时残留两者会出现各种难查的导入冲突。升级第一步永远是干净卸载旧包再装新包。AGNO_TELEMETRY=false 关闭[1]。同一项目的两个名字。2025 年初 phidata 整体更名为 Agno,代码库迁至 agno-agi/agno,旧地址会自动跳转过去[1]。开发火力已全面转向 agno 包,新项目请直接安装 agno,旧 phidata 包仅作历史兼容看待。
核心框架按 Apache-2.0 协议完全开源,自托管没有任何授权费[8]。商业模式聚焦在企业级托管与增值能力上;对个人与中小团队而言,典型姿势是免费用框架层、基础设施自理,成本主要落在模型调用与大促期间的算力账单。
判断标准就一条:要不要「运行时」。纯做编排原型,三家都胜任;一旦要把智能体当长期在线服务运维——涉及鉴权、多租户、追踪审计、人工审批——Agno 这些都是出厂件,另两家则需要围绕框架自行拼装运维设施[2]。
不绑定任何单一厂商。官方可选依赖覆盖 Anthropic、Google、Mistral、Groq、Ollama、vLLM、AWS Bedrock、Azure 等数十种模型源[3];本地推理用 Ollama 或 LM Studio 即可离线跑,国产模型一般通过 LiteLLM 或 OpenAI 兼容网关接入。
数字出自官方基准,量级上有参考意义——它的实例路径确实刻意做得极轻。但你真实的延迟大头几乎总在模型推理与网络往返上,框架开销占比很小;建议用自己的业务负载实测,别让营销数字替你做决策。