用途
Agno 是一个轻量级、模型无关的 AI 智能体框架,用于构建生产级智能体、多智能体团队、工作流与 MCP 集成,并可通过 AgentOS 部署。适用于构建带工具、记忆、结构化输出或知识的 AI 智能体,创建基于角色委派的多智能体团队,实现顺序、并行、条件或路由步骤的工作流,集成 MCP 服务器,以及调试智能体行为或优化性能。
架构概览
- Agent:单个自主 AI 单元(模型 + 工具 + 指令)
- Team:由领导者协调的多个智能体(route/broadcast/tasks 模式)
- Workflow:基于管道的执行(Step、Parallel、Condition、Loop、Router)
- AgentOS:用于将智能体部署为生产 API 的 FastAPI 运行时
- LearningMachine:跨会话的持久学习(用户画像、记忆、知识)
主要能力
- 基础智能体:可配置模型、工具、日期时间上下文与 Markdown 输出。
- 结构化输出:通过 Pydantic 的 output_schema 获得结构化响应。
- 会话持久化:使用存储(如 SqliteDb)与 session_id 实现跨运行连续对话,可配置历史上下文条数。
- 记忆:通过 MemoryManager 与 enable_agentic_memory 让智能体自主决定存储/召回用户偏好。
- 多智能体团队:成员智能体带角色,由团队领导者协调并综合结论。
- 工作流:顺序步骤(Step)等管道式执行。
- MCP 集成:支持 stdio、SSE、Streamable HTTP 传输,以及 MultiMCPTools 连接多个 MCP 服务器。
- LearningMachine:持久学习,支持用户画像配置(如 LearningMode.ALWAYS)。
- 自定义工具:通过 @tool 装饰器定义工具函数。
- 调试模式:debug_mode=True 输出消息、工具、令牌的详细日志。
- 同步与异步:所有公开方法均有异步变体(以 a 为前缀)。
使用方式
安装:pip install agno
基本用法示例(基础智能体):
from agno.agent import Agent from agno.models.google import Gemini from agno.tools.yfinance import YFinanceTools
agent = Agent( name="Finance Agent", model=Gemini(id="gemini-3-flash-preview"), tools=[YFinanceTools()], add_datetime_to_context=True, markdown=True, )
agent.print_response("Give me a quick brief on NVIDIA", stream=True)
结构化输出使用 output_schema 指定 Pydantic 模型;会话持久化使用 db 与 session_id;记忆使用 memory_manager 与 enable_agentic_memory;多智能体团队使用 Team 与 members;工作流使用 Workflow 与 Step;MCP 集成使用 MCPTools 或 MultiMCPTools,并注意关闭连接。
适用场景
- 构建带工具、记忆、结构化输出或知识的 AI 智能体
- 创建基于角色委派的多智能体团队
- 实现顺序、并行、条件或路由步骤的工作流
- 集成 MCP 服务器(stdio、SSE 或 Streamable HTTP)
- 使用 AgentOS 部署智能体
- 使用 LearningMachine 管理用户画像、实体记忆、会话上下文
- 调试智能体行为或优化性能
重要规则与限制
- 不要在循环中创建智能体,应复用智能体以提升性能
- 使用 output_schema 获得结构化响应,而非自由格式解析
- 生产环境使用 PostgreSQL,SQLite 仅用于开发
- 始终关闭 MCP 连接,使用 try/finally 或异步上下文管理器
- 排查问题时启用 debug_mode=True
参考文件
详细文档位于 references/ 目录:agents.md、teams.md、workflows.md、mcp.md、tools.md、learning.md、models.md。
资源
- 文档:https://docs.agno.com
- GitHub:https://github.com/agno-agi/agno
- Cookbook 示例:https://github.com/agno-agi/agno/tree/main/cookbook
- 安装:pip install agno
(注:资料未提供收费、价格、平台支持范围等具体信息,暂未提供。)