> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-studio-tools-doc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Studio

> Let an agent create, edit, run, and version AgentOS Studio components.

`StudioTool` gives an agent access to Studio component operations. The agent can inspect the Registry, create agents, teams, and workflows, edit Studio-created components, run them, delete them, and manage versions when enabled.

Use it for builder agents that turn natural language into AgentOS components.

## Example

```python cookbook/05_agent_os/studio_tool/studio_tools_agent.py theme={null}
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.openai import OpenAIResponses
from agno.registry import Registry
from agno.tools.duckduckgo import DuckDuckGoTools
from agno.tools.hackernews import HackerNewsTools
from agno.tools.studio import StudioTool

db = SqliteDb(id="studio-db", db_file="tmp/studio.db")

registry = Registry(
    name="Studio Registry",
    tools=[DuckDuckGoTools(), HackerNewsTools()],
    models=[OpenAIResponses(id="gpt-5.5")],
    dbs=[db],
)

studio_agent = Agent(
    id="studio-agent",
    name="Studio Agent",
    model=OpenAIResponses(id="gpt-5.5"),
    tools=[
        StudioTool(
            registry=registry,
            db=db,
            default_model_id="gpt-5.5",
            versions=True,
        )
    ],
    instructions=[
        "List available models and tools before creating components.",
        "Use exact Registry tool names.",
        "Return the component id, version, next action, and Studio route.",
    ],
    db=db,
    markdown=True,
)

studio_agent.print_response(
    "Create an agent named paper-review-assistant that finds research papers."
)
```

## Toolkit Params

| Parameter          | Type                       | Default           | Description                                                                      |
| ------------------ | -------------------------- | ----------------- | -------------------------------------------------------------------------------- |
| `registry`         | `Registry`                 | -                 | Registry used to resolve models, tools, functions, databases, agents, and teams. |
| `db`               | `Optional[BaseDb]`         | first Registry DB | Database used to persist Studio-created components.                              |
| `agents_list`      | `Optional[list[Agent]]`    | `None`            | Code-defined agents exposed for discovery and composition.                       |
| `teams_list`       | `Optional[list[Team]]`     | `None`            | Code-defined teams exposed for discovery and workflow composition.               |
| `workflows_list`   | `Optional[list[Workflow]]` | `None`            | Code-defined workflows exposed for discovery.                                    |
| `default_model_id` | `Optional[str]`            | `None`            | Model id to use when a create call omits `model_id`.                             |
| `agents`           | `Optional[bool]`           | `True`            | Enable agent create/edit/delete/run tools.                                       |
| `teams`            | `Optional[bool]`           | `False`           | Enable team create/edit/delete/run tools.                                        |
| `workflows`        | `Optional[bool]`           | `False`           | Enable workflow create/edit/delete/run tools.                                    |
| `versions`         | `bool`                     | `False`           | Enable versioning tools. Edits become drafts when true.                          |

Passing `agents_list` auto-enables team and workflow tools unless explicitly disabled. Passing `teams_list` auto-enables workflow tools unless explicitly disabled.

## Toolkit Functions

Discovery tools are always available:

| Function         | Description                                         |
| ---------------- | --------------------------------------------------- |
| `list_models`    | List registered models.                             |
| `list_tools`     | List registered toolkits, functions, and callables. |
| `list_functions` | List registered workflow functions.                 |
| `list_dbs`       | List registered databases.                          |
| `list_agents`    | List code-defined and DB-backed agents.             |
| `list_teams`     | List code-defined and DB-backed teams.              |
| `list_workflows` | List code-defined and DB-backed workflows.          |

Create, edit, delete, and run tools are exposed for enabled component types:

| Component | Functions                                                                             |
| --------- | ------------------------------------------------------------------------------------- |
| Agents    | `get_agent`, `create_agent`, `edit_agent`, `delete_agent`, `run_agent`                |
| Teams     | `get_team`, `create_team`, `edit_team`, `delete_team`, `run_team`                     |
| Workflows | `get_workflow`, `create_workflow`, `edit_workflow`, `delete_workflow`, `run_workflow` |

With `versions=True`, the toolkit also exposes `list_versions`, `get_version`, `publish_component`, `set_current_version`, and `delete_version`.

## Notes

* Create operations save a published `v1`.
* With `versions=True`, edits save as drafts until `publish_component` is called.
* With `versions=False`, edits publish immediately.
* `StudioTool` only edits Studio-created DB components. Code-defined components are discoverable and reusable, but not edited in place.
* Use `requires_confirmation_tools` for destructive or state-changing functions.

## Developer Resources

* [StudioTool with HITL](/agent-os/studio/tools)
* [AgentOS Studio](/agent-os/studio)
* [Source](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/studio.py)
* [cookbooks](https://github.com/agno-agi/agno/tree/main/cookbook/05_agent_os/studio_tool)
* [Components examples](/examples/components/overview)