agno-agi / agno

agno-agi/agno

open_in_new前往仓库

Agno 是一个用于构建、运行和管理智能体平台的开源框架与运行时，提供 SDK、AgentOS 运行时和 Web UI，支持自托管、JWT 权限控制及多租户隔离。

项目概览

项目概述

Agno 是一个开源框架和运行时，用于构建、运行和管理智能体平台。它提供 Agno SDK 用于构建智能体，AgentOS 运行时用于运行智能体服务，以及 AgentOS UI 用于管理平台。Agno 允许用户完全掌控自己的智能体栈，包括数据、记忆和安全（基于 JWT 的 RBAC），并通过模拟和使用数据将智能体平台转变为学习循环。

核心功能

  • 生产级 API：提供 50+ 端点，支持 SSE 和 WebSocket，便于构建产品。
  • 存储：在自有数据库中存储会话、记忆、知识和追踪记录。
  • 100+ 集成：通过预构建工具包连接 GitHub、Slack、Postgres 等。
  • 上下文提供器：从 Slack、Drive、Wiki、MCP 和自定义源访问实时数据。
  • 人工审批：暂停运行以等待用户确认，阻止需要管理员批准的工具。
  • 可观测性：支持 OpenTelemetry 追踪、运行历史和审计日志。
  • 安全性：开箱即用的 JWT 基于角色的访问控制（RBAC）和多用户、多租户隔离。
  • 接口：通过 Slack、Telegram、WhatsApp、Discord、AG-UI、A2A 等暴露智能体。
  • 调度：无需外部基础设施即可实现基于 Cron 的调度和后台任务。
  • 随处部署：可在任何支持容器的云平台上运行，如 Docker、Railway、AWS、GCP 等。

适用与不适用场景

适用场景：

  • 需要构建生产级智能体平台，并希望拥有完整控制权的团队。
  • 需要多用户、多租户隔离和细粒度权限控制的企业应用。
  • 需要将智能体集成到 Slack、Telegram 等现有通信渠道的场景。
  • 需要调度任务、后台作业和人工审批流程的自动化场景。

不适用场景：

  • 仅需简单原型或一次性脚本，无需完整平台管理。
  • 对平台依赖极低，希望完全从零构建的极简项目。
  • 需要非容器化部署或特定非云环境的场景（尽管 Agno 支持多种云，但可能不覆盖所有边缘情况）。

技术架构与依赖

  • 语言：Python
  • 运行时：AgentOS 运行时，支持 Docker 容器化部署。
  • 数据库：PostgreSQL（用于存储会话、记忆、知识、追踪等）。
  • 通信：REST API、SSE、WebSocket。
  • 安全：JWT 认证和 RBAC。
  • 可观测性：OpenTelemetry。
  • 集成：100+ 工具包，支持 MCP 服务器。
  • 许可证：Apache-2.0

安装与快速开始

推荐使用编码智能体（如 Claude Code、Cursor、Codex）快速搭建：

  1. 将以下提示交给编码智能体： 
    Help me set up my agent platform.
Clone https://github.com/agno-agi/agentos-railway into a folder called
agent-platform, cd in, read the README, and follow the get started guide.
  2. 编码智能体会自动设置平台并在本地使用 Docker 运行，提供 REST API、Postgres 数据库、MCP 服务器和控制平面。

如需手动编码，可参考官方文档：

典型使用方法

  • 构建智能体：使用 Agno SDK 定义智能体，配置模型、工具和上下文。
  • 运行智能体服务：通过 AgentOS 运行时将智能体作为 REST API 服务运行。
  • 管理平台：使用 AgentOS UI 监控运行、管理用户和权限。
  • 集成到现有系统：通过 Slack、Telegram 等接口暴露智能体，或使用 MCP 服务器集成到编码智能体。
  • 调度任务：使用 Cron 调度定期运行智能体任务。

配置与部署要点

  • 部署：支持 Docker、Railway、AWS、GCP、Azure、Fly、Render、Modal、Helm 等，可通过不同的 starter 模板快速部署。
  • 环境变量：可通过设置 AGNO_TELEMETRY=false 禁用遥测。
  • 安全：默认启用 JWT 认证和 RBAC，确保多租户隔离。
  • 存储：使用 PostgreSQL 存储数据，需配置数据库连接。
  • 可观测性：配置 OpenTelemetry 以收集追踪和指标。

限制、风险与许可证

  • 限制：仓库资料未提供明确的限制说明，但作为框架，可能存在学习曲线和特定云平台的兼容性问题。
  • 风险：遥测事件会发送至 Agno 团队（但不会发送提示、消息和输出），需注意隐私政策。
  • 许可证：Apache-2.0，允许自由使用和修改。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、CONTRIBUTING.md、最新发布信息（v2.9.0）。
  • 分析时间：2026年8月13日（基于最新发布信息）。