> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackmountain.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistant Studio

> Browse, create and manage the assistants you can use

**Assistant Studio** is the home of your assistants. It lists every assistant you can use in your current organization: your own private ones and the ones shared with your teams, workspaces and organization. From here you start chats, create new assistants and edit existing ones.

Open it from the sidebar. Assistant Studio is built for larger screens; on a phone you see a "Desktop recommended" notice instead.

## The assistant list

Each row shows the assistant's **Name**, **Description**, **Model**, **Category**, number of **Chats** and when it was last **Updated**. An assistant that has never been used carries an **unused** tag.

When no filter is active, assistants are grouped by who they are shared with:

* **Organization: \{name}**
* **Workspace: \{name}**
* **Team: \{name}**
* **Personal** (your private assistants)

Click a group header to collapse it, or use the collapse button in the toolbar to collapse or expand all groups.

![The Assistant Studio](https://mintcdn.com/blackmountaingmbh/XFag3CE4nO-WN3UD/images/screens/en/assistants/studio.png?fit=max\&auto=format\&n=XFag3CE4nO-WN3UD\&q=85\&s=12f8da5ad26d4f63863c932e62ecfc1e)

### Filter the list

* **Filter by name...** searches names and descriptions.
* The team filter shows **All teams**, **Personal** (private assistants only) or one team.
* The category filter shows **All categories** or one category: **Research**, **Support**, **Automation** or **Productivity**.

## Start a chat

Click an assistant's row or name, or hover the row and click **Start Chat**. A new chat opens with the assistant selected.

## Create an assistant

1. Click **Create assistant**.
2. Give it a name and write its **Instructions**. Both are required.
3. Set the other options you need. See [Configure an assistant](https://docs.blackmountain.io/assistants/configuration.md).
4. Click **Create**.

![Creating an assistant](https://mintcdn.com/blackmountaingmbh/XFag3CE4nO-WN3UD/images/screens/en/assistants/new.png?fit=max\&auto=format\&n=XFag3CE4nO-WN3UD\&q=85\&s=d48607941b28dc14399df311b976a7f7)

## Row actions

Hover a row to see its actions:

| Action | What it does |
| - | - |
| **Start Chat** | Opens a new chat with the assistant. |
| **Edit** / **View** | Opens the editor. You see **View** and a read-only editor when you can use the assistant but not change it. |
| **Duplicate** | Creates a private copy for you, named "\{name} (Copy)". |
| **Delete** | Deletes the assistant after you confirm. Only shown if you can edit it. |

### Duplicate an assistant

Duplicating is the way to adapt a shared assistant you can't edit. The copy is private to you and keeps the description, instructions, recommended model, category, icon or avatar, conversation starters and skills. It keeps the toolset only if you are allowed to use that toolset yourself.

Knowledge files are not copied. Upload them to the copy again if you need them.

### Delete an assistant

Deleting cannot be undone. The assistant's knowledge files are deleted with it. Existing chats remain, but they are no longer associated with the assistant.

> [!TIP]
>
> Not sure who can edit a shared assistant? See [Visibility and sharing](https://docs.blackmountain.io/assistants/visibility-and-sharing.md).

## Related

> [card] [Configure an assistant](https://docs.blackmountain.io/assistants/configuration.md)
>
> Every setting in the assistant editor.

> [card] [Visibility and sharing](https://docs.blackmountain.io/assistants/visibility-and-sharing.md)
>
> Who can use and who can edit an assistant.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.