# Manage Workspaces and Environments

Workspaces are the top-level organizational unit in Agentic Studio. This guide covers how to create a workspace and how to navigate between workspaces and environments in your day-to-day work.

#### Before You Start

* You need appropriate permissions to create workspaces in your tenant.
* Plan your workspace structure before creating. You are limited to five workspaces per tenant.
* Use clear, descriptive names and descriptions so other users understand the purpose of each workspace.

### How to Create a Workspace

{% stepper %}
{% step %}
Log in to Agentic Studio.
{% endstep %}

{% step %}
Click the workspace name in the breadcrumb at the top left of any page, or click the Workspaces icon in the main navigation menu.
{% endstep %}

{% step %}
In the workspace panel, select the option to create a new workspace.
{% endstep %}

{% step %}
Enter a name for the workspace that clearly identifies the business area, site, or use case.
{% endstep %}

{% step %}
Enter a description explaining what the workspace is intended for and who manages it.
{% endstep %}

{% step %}
Save the workspace. It will appear in your workspace list immediately.
{% endstep %}
{% endstepper %}

### How to Switch Between Workspaces and Environments

The breadcrumb at the top left always shows your current workspace and environment.

* To switch workspaces: click the workspace name in the breadcrumb and select the desired workspace from the panel.
* To switch environments within a workspace: click the environment name in the breadcrumb (UAT or Production) and confirm the switch.

{% hint style="info" %}
**Reminder:** Changes to Digital Workers, including installation, configuration, and publishing, always happen in UAT. Production is read-only except for HITL configuration, model parameters, and concurrency settings.
{% endhint %}

### Key Rules

| Rule                       | Detail                                                                                          |
| -------------------------- | ----------------------------------------------------------------------------------------------- |
| All installs happen in UAT | Digital Workers can only be installed into the UAT environment, never directly into Production. |
| Changes stay in UAT        | You can only edit the Draft version of a Digital Worker, which exists in UAT.                   |
| Promotion is intentional   | Moving a Digital Worker to Production requires a deliberate publish and promote action.         |
| Maximum 5 workspaces       | Plan your workspace structure before you reach the limit.                                       |

### Workspace Planning Tips

* Create workspaces around business units, sites, or product areas that have distinct processes and data, not around individual Digital Workers or use cases within a single area.
* Document the purpose and owner of each workspace in the description field so the team knows where new Digital Workers should be installed.
* If you are close to the five-workspace limit, review whether any existing workspaces can be consolidated before creating a new one.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.theloops.io/agenticstudio/resource-library/how-to-guides/manage-workspaces-and-environments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.