Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agno.com/llms.txt

Use this file to discover all available pages before exploring further.

Software is becoming agentic and many parts of your product will become agent-driven. Most products start with a chat copilot, then add more agent-driven surfaces: smart empty states, inline workflow recommendations, personalized help notes, proactive nudges. Each one is its own agent with its own job. Agno runs all of them in one place. Sessions, memory, knowledge, and auth are shared across every surface, so the product feels like one system. 
from agno.agent import Agent
from agno.db.postgres import PostgresDb
from agno.models.openai import OpenAIResponses
from agno.os import AgentOS

db = PostgresDb(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai")

agent = Agent(
    name="Product Copilot",
    model=OpenAIResponses(id="gpt-5.5"),
    db=db,
    add_history_to_context=True,
    num_history_runs=5,
    enable_agentic_memory=True,
)

agent_os = AgentOS(agents=[agent])
app = agent_os.get_app()

if __name__ == "__main__":
    agent_os.serve(app="copilot:app", port=7777)
That is the start of your product copilot. Persistent multi-turn history, per-user memory, and an HTTP API with streaming, sessions, and auth.

​
Auth and tenancy are built in

Your AgentOS ships with JWT-based authentication. Turn it on and identity is read from a bearer token. user_id, session_id, and scope claims all come from the token. 
from agno.os import AgentOS

agent_os = AgentOS(agents=[agent], authorization=True)
# Every endpoint now requires a valid JWT. user_id, session_id,
# and scopes are read from the token before any agent code runs.

​
The mental model

The agent runs in your AgentOS as a service. Every product surface is a client that calls it over HTTP.
SurfaceHow it reaches the agent
In-app copilot panelPOST /agents/{id}/runs scoped to user_id and a per-thread session_id
Inline action (“summarize this”, “draft a reply”)The same endpoint, a short-lived session_id
Slack / Telegram / WhatsAppAn interface adapter maps the channel onto runs and sessions
Backend event (webhook, cron)A custom FastAPI route calling agent.arun(...)
Every surface shares the same (user_id, session_id) state. A user the agent met in the chat panel is already known to the inline action agent.

​
Guided paths

You haveYou wantStart with
A B2B SaaS productPer-customer, per-user isolation out of the boxServe as an API
Users in Slack or the browserThe same agent where they already workInterfaces
Internal docs, Drive, databasesAn agent grounded in live company dataConnecting your data
Multi-day user relationshipsMemory that persists per user across surfacesSessions and memory

​
Explore

Serve as an API

Turn the agent into an HTTP service with streaming, sessions, and auth.

Sessions and memory

Persistent multi-turn history and per-user memory, with no state layer to build.

Connecting your data

Give the agent live access to Slack, Drive, databases, and MCP servers.

Interfaces

Slack, Telegram, WhatsApp, and browser surfaces with one line each.

​
Developer Resources