Agno 智能体开发指南

Agno 是用于构建多智能体系统的生产级 Python 框架，支持 40+ LLM 提供商和 100+ 内置工具。

目录

• 快速入门
• 模块导航
• 核心概念
• 常用模式速查

快速入门

安装

pip install agno                     # 基础安装
pip install "agno[openai]"          # OpenAI 支持
pip install "agno[anthropic]"       # Anthropic 支持
pip install "agno[google]"          # Google Gemini 支持
pip install "agno[postgres]"        # PostgreSQL 生产存储

最简 Agent

from agno.agent import Agent
from agno.models.openai import OpenAI

agent = Agent(
    name="助手",
    model=OpenAI(id="gpt-4o"),
    instructions="你是一个有帮助的助手。"
)

# 同步运行
response = agent.run("你好！")
print(response.content)

# 流式输出
agent.print_response("介绍一下你自己", stream=True)

带工具的 Agent

from agno.agent import Agent
from agno.models.anthropic import Claude
from agno.tools.yfinance import YFinanceTools

agent = Agent(
    name="金融分析师",
    model=Claude(id="claude-sonnet-4-5"),
    tools=[YFinanceTools()],
    instructions="你是专业的金融分析师，使用工具获取实时数据。",
    markdown=True
)

agent.print_response("分析一下 NVIDIA 的股票", stream=True)

带记忆的 Agent

from agno.agent import Agent
from agno.models.openai import OpenAI
from agno.db.sqlite import SqliteDb
from agno.memory import MemoryManager

db = SqliteDb(db_file="agents.db")

agent = Agent(
    name="个性化助手",
    model=OpenAI(id="gpt-4o"),
    db=db,
    memory_manager=MemoryManager(model=OpenAI(id="gpt-4o-mini"), db=db),
    enable_agentic_memory=True,
    add_history_to_context=True
)

# 记忆用户偏好
agent.run("我喜欢科技股，风险承受能力中等", user_id="user-001")

# 后续对话会记住偏好
agent.run("推荐一些股票", user_id="user-001")

模块导航

根据需求选择相应模块：

核心概念

架构层次

┌─────────────────────────────────┐
│   应用层: Agent / Team / Workflow   │
├─────────────────────────────────┤
│   能力层: Tools / Memory / Knowledge │
├─────────────────────────────────┤
│   基础层: Model / Database / VectorDB │
└─────────────────────────────────┘

关键组件

常用模式速查

结构化输出

from pydantic import BaseModel

class StockAnalysis(BaseModel):
    ticker: str
    recommendation: str  # BUY/HOLD/SELL
    target_price: float
    risks: list[str]

agent = Agent(
    model=OpenAI(id="gpt-4o"),
    output_schema=StockAnalysis
)

response = agent.run("分析苹果股票")
analysis = response.output  # 类型化的 StockAnalysis 对象

多智能体团队

from agno.team import Team

bull = Agent(name="看多分析师", model=OpenAI(id="gpt-4o"), role="找投资正面理由")
bear = Agent(name="看空分析师", model=OpenAI(id="gpt-4o"), role="找投资负面理由")

team = Team(
    name="投资研究团队",
    members=[bull, bear],
    model=Claude(id="claude-sonnet-4-5"),
    instructions="综合多空观点给出平衡建议"
)

team.print_response("应该投资特斯拉吗？")

知识库 RAG

from agno.knowledge import Knowledge
from agno.vectordb.chroma import ChromaDb

knowledge = Knowledge(
    name="公司文档",
    vector_db=ChromaDb(name="docs", path="./chromadb")
)

knowledge.insert(path="./documents/")  # 批量导入文档

agent = Agent(
    model=OpenAI(id="gpt-4o"),
    knowledge=knowledge,
    search_knowledge=True
)

agent.print_response("公司的退款政策是什么？")

顺序工作流

from agno.workflow import Workflow, Step

workflow = Workflow(
    name="研究管道",
    steps=[
        Step(name="数据收集", agent=data_agent),
        Step(name="分析处理", agent=analysis_agent),
        Step(name="报告生成", agent=report_agent)
    ]
)

workflow.run("分析2024年市场趋势")