> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc-studio-tools-doc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 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](/agent-os/studio/agents)** :
Build agent by giving it a model, tools, and instructions. Add knowledge and memory to ground its responses and remember context.
**[Teams](/agent-os/studio/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](/agent-os/studio/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](/agent-os/studio/registry)** :
Register the components Studio composes with: tools, models, databases, schemas, knowledge, `memory_managers`, and `session_summary_managers`. Register existing agents and teams to reuse them as members in Studio teams or steps in Studio workflows.
## 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](https://os.agno.com/studio/agents) to start building
```python theme={null}
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. Manage Versions
Access the full version history for any agent, team, or workflow:
Two actions are available on this page:
* **Restore**: open a draft for editing in Studio.
* **Set Current**: choose which published version the API serves.
Drafts are mutable: you can edit them in Studio and delete them. Published versions are immutable and undeletable. To change a published version, publish a new one. Only published versions can be set as current.
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](/agent-os/studio/agents) |
| Create a workflow | [Studio Workflows](/agent-os/studio/workflows) |
| Compose a team | [Studio Teams](/agent-os/studio/teams) |
| Set up the registry | [Studio Registry](/agent-os/studio/registry) |
| components (API reference) | [Components API reference](/reference-api/schema/components) |
### 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
Two actions are available on this page:
* **Restore**: open a draft for editing in Studio.
* **Set Current**: choose which published version the API serves.
Drafts are mutable: you can edit them in Studio and delete them. Published versions are immutable and undeletable. To change a published version, publish a new one. Only published versions can be set as current.