## 项目概述

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. 将以下提示交给编码智能体：
   ```text
   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 服务器和控制平面。

如需手动编码，可参考官方文档：
- [构建第一个智能体](https://docs.agno.com/first-agent)
- [构建自己的智能体平台](https://docs.agno.com/agent-platform/overview)
- [阅读文档](https://docs.agno.com)

## 典型使用方法

- **构建智能体**：使用 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 仓库](https://github.com/agno-agi/agno)
- [官方文档](https://docs.agno.com)
- [Discord 社区](https://discord.gg/4MtYHHrgA8)
- [X (Twitter)](https://x.com/AgnoAgi)
- [新闻通讯](https://www.agno.com/the-agno-loop-newsletter)

## 信息来源和分析时间

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