> For the complete documentation index, see [llms.txt](https://docs.onlymonster.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onlymonster.ai/ai-magic-assistant/custom-replies.md).

# Custom Replies

The **AI Tools → AI Suggestions → Replies** tab holds every reply in your organization. Here you can review the built-in system replies and create your own, running on your organization's model.

#### What the Reply Card Shows

* The reply name
* A description for system replies, or the preset model for custom ones
* The type: **System** or **Custom**
* The **Connected** status, if the reply is enabled on at least one account

Use the **Type** filter, the **Hide Connected** toggle and the search field to navigate the list. The counter next to **All Replies** shows how many replies the organization has.

#### Creating a Custom Reply

Create a preset in AI Gateway before you start — a custom reply cannot be saved without one. 

**Step 1. Choose the Reply Type**

Click **New Reply** and select what the reply is built from:

* **Custom** — build your own reply using an AI Gateway preset
* **System Mode** — start from a ready-made system reply

Click **Continue**. The selected type is displayed in the page header next to the reply name.

**Step 2. Reply Basics**

This section sets the name and the model the reply runs on.

| Field                 | What to enter                                                                 |
| --------------------- | ----------------------------------------------------------------------------- |
| **Reply Name**        | The name of the reply — this is how members will see it in chat               |
| **AI Gateway Preset** | The preset from AI Gateway that defines the model, the key and the parameters |

The reply name is the button label in the message bar, so keep it short — long names are hard to read in a row of buttons. 

**Step 3. Prompt**

The **Prompt** section holds the instructions the model follows when it generates a suggestion.

**System Prompt** — the main instruction applied to every generation. This field is empty by default: you need to write it yourself. Use it to describe the tone, the style and any rules the model should follow.

**User Message** — the request sent to the model together with the conversation. This is where the message being answered is inserted. The field is pre-filled and can be used as it is; edit it only if you need a different structure.

An example of a completed **User Message**:

```
Conversation so far:
{chatHistory}

Suggest a reply to: {lastFanMessage}
```

**Variables**

Variables are placeholders that are automatically replaced with real data at the moment of generation. The available variables are shown as chips under each field; an asterisk marks a variable that is required in that field.

| Variable           | What it inserts                                        | Where it is available                  |
| ------------------ | ------------------------------------------------------ | -------------------------------------- |
| `{chatHistory}`    | Recent messages from the conversation, used as context | System Prompt; User Message — required |
| `{lastFanMessage}` | The message being answered                             | System Prompt, User Message            |

**Step 4. Post-Processing**

Post-processing is applied to the finished suggestion, after the model has responded.

| Option                    | What it does                                               |
| ------------------------- | ---------------------------------------------------------- |
| **No Dots Before Emojis** | Removes the period before an emoji: `Sure. 😊` → `Sure 😊` |

**Step 5. Customization**

**Customization** sets the writing style and the typing habits applied to the generated text, in the same way as for outgoing translators.

**Step 6. Save**

Click **Create**. The blue dots next to the sections in the left menu mean that a section still has empty required fields.

Once created, the reply appears in the **Replies** list, but it only starts working after you connect it to accounts.

#### Reply Actions

| Action                 | What it does                                                                                  |
| ---------------------- | --------------------------------------------------------------------------------------------- |
| **Edit**               | Opens the reply settings                                                                      |
| **Connect to Account** | Connects the reply to accounts                                                                |
| **Duplicate**          | Creates a copy of the reply — useful for building a variant with a different prompt or preset |
| **Delete**             | Deletes the reply                                                                             |

**Connect to Account**

This is the fastest way to enable a reply on several accounts at once. In the **Connect to Account** window, open the **Select accounts** dropdown and pick the targets:

* the **Accounts** tab — individual accounts, or **Select All** for the whole organization,
* the **Groups** tab — an account group, which connects the reply to every account in it.

The same result can be achieved from the account side: the **Accounts** tab opens the suggestion setup for a specific account. See Connecting Replies to Accounts. 

#### Editing a Reply

Open a reply from the **Replies** list, or select **Edit** in the actions menu. Apply your changes with **Save Changes**. After you save, all new suggestions use the updated settings.

For system replies, only **Customization** is available: the writing style can be changed, the prompt and the model cannot.

*A custom reply stops working if the preset behind it stops working — for example, after its API key is deleted. Open the preset in AI Gateway, select a valid key and save.* 

#### Permissions

| Permission                | What it allows                                           |
| ------------------------- | -------------------------------------------------------- |
| **AI Assistant Settings** | Configure and edit replies and their account settings    |
| **AI Replies**            | Use the reply buttons in chat                            |
| **View AI Gateway**       | Select a preset while creating or editing a custom reply |

**AI Assistant Settings** opens or closes access to the module as a whole: without it, the member cannot open AI Suggestions at all.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.onlymonster.ai/ai-magic-assistant/custom-replies.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.