大规模构建、运行和管理智能体软件。
什么是 Agno
Agno 是智能体软件的运行时。用它来构建智能体、团队和工作流，并将其作为可扩展的服务运行，在生产环境中进行监控和管理。
| 层级 | 功能描述 |
|---|---|
| 框架 | 构建具备记忆、知识、防护栏和 100+ 集成的智能体、团队和工作流。 |
| 运行时 | 通过无状态、会话范围的 FastAPI 后端，在生产环境中部署你的系统。 |
| 控制平面 | 使用 AgentOS UI 测试、监控和管理你的系统。 |
快速开始
用大约 20 行代码构建一个有状态、会使用工具的智能体，并将其作为生产 API 提供服务。
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.anthropic import Claude
from agno.os import AgentOS
from agno.tools.mcp import MCPTools
agno_assist = Agent(
name="Agno Assist",
model=Claude(id="claude-sonnet-4-6"),
db=SqliteDb(db_file="agno.db"),
tools=[MCPTools(url="https://docs.agno.com/mcp")],
add_history_to_context=True,
num_history_runs=3,
markdown=True,
)
agent_os = AgentOS(agents=[agno_assist], tracing=True)
app = agent_os.get_app()
运行它：
export ANTHROPIC_API_KEY="***"
uvx --python 3.12 \
--with "agno[os]" \
--with anthropic \
--with mcp \
fastapi dev agno_assist.py
大约 20 行代码，你将获得：
- 一个具有流式响应的有状态智能体
- 按用户、按会话的隔离
- 一个位于 http://localhost:8000 的生产级 API
- 原生追踪功能
连接到 AgentOS UI 来监控、管理和测试你的智能体。
- 打开 os.agno.com 并登录。
- 点击顶部导航栏的 "Add new OS"。
- 选择 "Local" 以连接到本地的 AgentOS。
- 输入你的端点 URL（默认：
http://localhost:8000）。 - 将其命名为 "Local AgentOS"。
- 点击 "Connect"。
https://github.com/user-attachments/assets/75258047-2471-4920-8874-30d68c492683
打开 Chat，选择你的智能体，然后提问：
What is Agno?
智能体会从 Agno MCP 服务器检索上下文，并给出有依据的回答。
https://github.com/user-attachments/assets/24c28d28-1d17-492c-815d-810e992ea8d2
你可以使用完全相同的架构在生产环境中运行多智能体系统。
为什么选择 Agno？
智能体软件带来了三个根本性的转变。
新的交互模式
传统软件接收请求并返回响应。智能体则实时流式输出推理过程、工具调用和结果。它们可以在执行中暂停、等待批准，并在稍后恢复。
Agno 将流式处理和长时间运行执行视为一等公民。
新的治理模式
传统系统执行预先编写的、预定义的决策逻辑。智能体则动态选择行动。有些行动风险较低，有些需要用户批准，有些则需要管理权限。
Agno 允许你将“谁决定什么”作为智能体定义的一部分，提供：
- 审批工作流
- 人在回路
- 审计日志
- 运行时强制执行
新的信任模式
传统系统被设计为可预测的，每条执行路径都是预先定义的。智能体则将概率性推理引入了执行路径。
Agno 将信任构建到引擎本身：
- 防护栏作为执行的一部分运行
- 评估集成到智能体循环中
- 追踪和审计日志是一等公民
为生产环境而构建
Agno 在你的基础设施中运行，而不是我们的。
- 无状态、可水平扩展的运行时。
- 50+ API 和后台执行能力。
- 按用户和按会话的隔离。
- 运行时审批强制执行。
- 原生追踪和完全可审计性。
- 会话、记忆、知识和追踪数据存储在你的数据库中。
你拥有系统。你拥有数据。你定义规则。
你可以构建什么
Agno 为基于上述相同原语构建的真实智能体系统提供动力。
- Pal → 一个学习你偏好的个人智能体。
- Dash → 一个基于六层上下文的自学习数据智能体。
- Scout → 一个管理企业上下文知识的自学习上下文智能体。
- Gcode → 一个随时间改进的后 IDE 编码智能体。
- Investment Team → 一个进行辩论和资本分配的多智能体投资委员会。
单个智能体。协同工作的团队。结构化的工作流。全部基于一个架构构建。
开始使用
IDE 集成
将 Agno 文档添加为你的编码工具的源：
Cursor: Settings → Indexing & Docs → 添加 https://docs.agno.com/llms-full.txt
同样适用于 VSCode、Windsurf 和类似工具。
贡献
请参阅贡献指南。
遥测
Agno 会记录使用了哪些模型提供商，以便优先更新。可通过设置 AGNO_TELEMETRY=false 来禁用。