Overview

A visual editor in AgentOS to build Agents, Teams, and Workflows.

Build and orchestrate Agents, Teams, and Workflows on a live canvas to deploy production-ready agentic systems with AgentOS Studio.

Concepts

Agents Build agent by giving it a model, tools, and instructions. Add knowledge and memory to ground its responses and remember context.

Teams Build multi-agents team that works toward a shared goal. Choose how the leader coordinates with members using coordinate, route, broadcast, or tasks mode.

Workflows Orchestrate agents and teams into step-based pipelines. Control the flow with loops, conditions, routers, and parallel execution.

use functions or cel expressions to evaluate conditions and selectors.

Registry Add tools, models, databases, and schemas that Studio can use to build agents, teams, and workflows.

Register agents and teams in the Registry to reuse them as members in Studio teams and as steps in Studio workflows.

Register knowledge, memory_managers, and session_summary_managers for agents and teams to use.

How It Works

Studio connects to your running AgentOS instance and uses a Registry to populate available components. Build visually, test interactively, and publish when ready.

1. Register your tools, models, databases, and schemas in a Registry
2. Pass the registry and a database to AgentOS
3. Open Studio in the AgentOS Control Plane to start building

from agno.os import AgentOS
from agno.db.postgres import PostgresDb
from agno.registry import Registry
from agno.models.openai import OpenAIChat
from agno.tools.websearch import WebSearchTools

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

registry = Registry(
    name="My Registry",
    tools=[WebSearchTools()],
    models=[OpenAIChat(id="gpt-5-mini")],
    dbs=[db] #Studio requires the `db` parameter to save and load agents, teams, and workflows.
)

agent_os = AgentOS(
    id="my-app",
    db=db,
    registry=registry,
)

app = agent_os.get_app()

Development Lifecycle

Studio manages the full development lifecycle from building to deploying complex agentic systems with AgentOS components.

1. Build

Create your agent, team, or workflow using the visual builder. use tools, models, and knowledge bases from the Registry, add instructions and configure the settings.

2. Save Draft or publish directly

• Save your work as a draft or publish directly. Drafts can be edited and updated. Drafts helps you test your component before publishing it.
• Publish or Draft multiple versions to checkpoint your progress.

3. Test

Once saved, test your draft or published version in the AgentOS:

• Chat Page:

  • Interact with your agent, team, or workflow in real-time
  • run specific version of the component by selecting it in the dropdown.
  

• View Traces: Inspect tool calls, model responses, and reasoning for each run

• Debug Mode: Enable verbose logging to troubleshoot issues

Before publishing, test and make sure your agent handles edge cases and unexpected inputs gracefully.

4. Delete

• Delete the component from the Studio.

5. Manage Versions

Access the full version history for any agent, team, or workflow:

• Restore: edit and update the draft version.

• Set Current: Choose which published version is used by default when running via the API

• only draft versions can be updated and edited in the Studio.

• published versions are immutable and can only be updated by publishing a new version.

• draft version cannot be set as current.

• only draft versions can be deleted from versions page , published versions and current config cannot be deleted.

Use descriptive version labels like v1.2-improved-instructions or before-refactor to make it easy to identify versions later.

Next Steps

Task	Guide
Build an agent	Studio Agents
Create a workflow	Studio Workflows
Compose a team	Studio Teams
Set up the registry	Studio Registry