SuperAPI AI 工具集

agno

智能体与模型

查看项目

更新于 10-15 14:11

技能介绍

用途

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

(注:资料未提供收费、价格、平台支持范围等具体信息,暂未提供。)