> ## 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.

# Configure an Assistant

> Set instructions, recommended model, avatar, conversation starters, knowledge files and skills

The assistant editor is one page with sections for identity, behavior, starters, tools, knowledge and access. Open it from **Assistant Studio** with **Create assistant**, or with **Edit** on an existing assistant.

![An assistant’s settings](https://mintcdn.com/blackmountaingmbh/XFag3CE4nO-WN3UD/images/screens/en/assistants/edit.png?fit=max\&auto=format\&n=XFag3CE4nO-WN3UD\&q=85\&s=cd05237118d3dd330dc42170fd7a1563)

## Identity

How the assistant appears across 48°.

* **Icon / Avatar**: pick an icon or emoji, or click **Upload image**. Images can be PNG, JPEG or WebP, up to 2 MB.
* **Name** (required): the name colleagues see in the assistant list and the chat picker.
* **Description**: one short sentence on what the assistant helps with.

## Behavior

### Instructions

The instructions are the core of the assistant. They are sent as a system message at the start of every conversation. Instructions are required.

Write what the assistant is, who it helps and how it should answer:

```text theme={null}
You are a proposal writer for our consulting team.
Write in British English, in a confident but plain tone.
Always structure proposals as: Context, Approach, Timeline, Price.
Never invent prices. If a price is missing, ask for it.
```

> [!WARNING]
>
> PII protection does not scan assistant instructions. Anything you type here reaches the model as written in every chat that uses this assistant.

### Recommended Model

The model a chat starts on when someone picks this assistant. Choose **No recommended model** to use each person's own default. Users can always switch the model in the chat.

### Category

Optional. Pick **Research**, **Support**, **Automation** or **Productivity** to make the assistant easier to filter in Assistant Studio.

## Conversation starters

Conversation starters are prompt templates shown as chips above the chat input when the assistant is selected. You can add up to four.

1. Click **Add template** and choose a template from Prompt Studio.
2. Use **Move up** and **Move down** to set the order.
3. Click **Remove starter** to drop one.

When a starter has variables, the user fills them in before the text goes into the composer.

> [!WARNING]
>
> If a template is shared with fewer people than the assistant, the editor warns you. Attaching it makes its text visible to everyone who can use the assistant.

## Tools

Optional extensions that expand what the assistant can do. This section only shows the options your organization has turned on.

* **Toolset**: tools from your connected integrations. See [Tools and toolsets](https://docs.blackmountain.io/assistants/tools-and-toolsets.md).
* **Skills**: skills and skill groups the assistant can load when relevant.
* **Newsroom** and **Transport order → v4 CSV**: module tools for organizations that use [Newsroom](https://docs.blackmountain.io/modules/newsroom) or [Freightcheck](https://docs.blackmountain.io/modules/freightcheck.md).

### Skills

Click **Choose skills** and select skills or skill groups. The assistant sees each skill's name and description and loads the full skill only when it's relevant.

Skills must be shared at least as widely as the assistant:

* A private assistant can use any skill you have access to.
* A team assistant can only use skills shared with that team.
* Workspace and organization assistants cannot use skills.

If a skill is shared more narrowly, saving fails and the editor names the skills to fix. See [Attaching skills](https://docs.blackmountain.io/editor/skills/attaching-skills.md).

## Knowledge

Files you upload here are included as context in every chat that uses the assistant. Drag files onto the upload area or click to browse. Supported are PDF, Word, Excel, CSV and TXT files up to 25 MB each.

* **When creating**: files are uploaded when you click **Create**. If any upload fails, the assistant is not created.
* **When editing**: files are saved as soon as you upload or remove them. You don't need to click **Update**.

> [!WARNING]
>
> PII protection does not scan knowledge files. Every chat with this assistant sends these files to the model as they are.

## Access

Choose who can use the assistant: **Private** (only you), **Team**, **Workspace** or **Organization**. You only see the shared options for scopes where you are a Manager or Owner. See [Visibility and sharing](https://docs.blackmountain.io/assistants/visibility-and-sharing.md).

## Save

Click **Create** for a new assistant, or **Update** for an existing one. **Update** stays disabled until you change something. If you leave with unsaved changes, 48° asks you to confirm.

Changes take effect from the next message, including in chats that already use the assistant.

## Related

> [card] [Tools and toolsets](https://docs.blackmountain.io/assistants/tools-and-toolsets.md)
>
> Connect an assistant to your integrations.

> [card] [Prompt Studio](https://docs.blackmountain.io/chat/prompt-studio.md)
>
> Create templates to use as conversation starters.

> [card] [Skills](https://docs.blackmountain.io/editor/skills/introduction.md)
>
> Reusable instructions an assistant loads on demand.

> [card] [Prompting basics](https://docs.blackmountain.io/resources/prompting-basics.md)
>
> Write better instructions.


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