# Assistants & Prompts

If you give the same instructions again and again, save them: as an **assistant** (a model with fixed instructions,
knowledge and tools) or as a **prompt** (a text snippet you insert with `/`).

## Assistants

An assistant is a custom model built on one of our models, with its own system prompt and, optionally, knowledge bases
and tools. Examples: a writing helper with your style guide, a course assistant with the lecture notes, or a reviewer
for grant proposals.

1. Go to **Workspace → Models** and click **Create**.
2. Give it a **name** and choose a **base model** from the [model list](https://datalab.tuwien.ac.at/aiml/aqueduct/models/).
3. Write the **system prompt** (see below).
4. Optionally attach **knowledge bases** from [Documents & Knowledge](https://datalab.tuwien.ac.at/aiml/openwebui/documents/) and turn on capabilities such as
   web search or the code interpreter.
5. Save. The assistant now appears in the model selector.

A good system prompt covers:

- **Role and goal:** *"You are a writing assistant for TU Wien press releases."*
- **Behavior:** tone, language, what to do if information is missing.
- **Knowledge:** *"Answer only based on the attached documents and name the document you used."*
- **Format:** length, structure, e.g. *"Answer in bullet points."*

!!! warning "Base models change"

    Our models are usually replaced every few months. When a base model is retired, edit your assistant and choose a
    new one. See [How long does a model stay available?](https://datalab.tuwien.ac.at/aiml/faq/#how-long-does-a-model-stay-available)

See [Models](https://docs.openwebui.com/features/workspace/models) in the official documentation for all options.

## Prompts

A prompt is a reusable text you insert into any chat by typing its command, e.g. `/summarize`.

1. Go to **Workspace → Prompts** and click **Create**.
2. Set a **command** (e.g. `summarize`) and write the **prompt content**.
3. In a chat, type `/` and pick the prompt.

Prompts can contain variables that open a small form when you use them:


```
Summarize this text in {{length | select:options=["short","long"]}}
form for {{audience}}:

{{text | textarea}}
```


Built-in variables such as `{{CURRENT_DATE}}` or `{{CLIPBOARD}}` are filled in automatically.
See [Prompts](https://docs.openwebui.com/features/workspace/prompts) in the official documentation for all variable
types.

Assistants and prompts can be [shared](https://datalab.tuwien.ac.at/aiml/openwebui/team-collaboration/) with colleagues.