Drag, drop, and orchestrate Agents, Teams, and Workflows on a live canvas to deploy production-ready agentic systems with AgentOS Studio.
Concepts
| Concept | Description |
|---|
| Agents | Build and configure agents with models, tools, and instructions |
| Teams | Compose multi-agent teams with coordination modes |
| Workflows | Design step-based workflows with conditions, loops, routers, and parallel execution |
| Registry | Browse and manage registered tools, models, databases, and schemas |
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.
- Register your components in a
Registry
- Pass the registry and a database to
AgentOS
- Open Studio in the 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. Drag components from the Registry, configure properties, and wire everything together.
2. Save Draft
Save your work as a draft version. Drafts are not accessible via the API but can be tested, restored, and published later. You can save multiple draft versions to checkpoint your progress.
3. Test
Once saved, test your draft in the AgentOS Control Plane:
- Chat Page: Interact with your agent, team, or workflow in real-time
- 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. Publish
Move from draft to production with one click. Publish the visual blueprint of your agentic system after verification.
Manage multiple versions of your system blueprint. Every published version is immediately
accessible via a unique API endpoint. Set any version as Current to make it the default for your production API.
5. Manage Versions
Access the full version history for any agent, team, or workflow:
- Restore: Load any previous version into the editor
- Set Current: Choose which published version is used by default when running via the API
- Delete: Remove old versions you no longer need
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 |
