> For the complete documentation index, see [llms.txt](https://help.meltingspot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.meltingspot.io/english/coach-ai/configuration/configuring-your-ai-coach.md).

# Configuring your AI Coach

The more context you give your AI Coach, the more relevant its responses will be. This configuration is done from **Settings > AI Coach**, across three tabs:

* **Persona** and **Context**: global settings, for all your playbooks,
* **Playbooks**: settings specific to a playbook.

{% hint style="info" %}
AI Coach and playbook settings are reserved to **Spot admins**.
{% endhint %}

### Persona tab (global)

#### Proactivity

* **Proactive messages**: the AI Coach spontaneously suggests content (👉 more information [here](https://help.meltingspot.io/english/coach-ai/user-experience/proactive-messages.md)).
* **Two-way conversations**: your users can ask the AI Coach questions and get answers. When it's off, the AI Coach only suggests resources.
* **Grounded trainer mode**: enabled by default. The AI Coach first drafts a response using the available resources, then shares those resources for deeper study (👉 more information [here](https://help.meltingspot.io/english/coach-ai/user-experience/grounded-trainer-mode.md)).

When you turn on **two-way conversations**, you are asked to confirm. Indexing of all your Spot's content then starts. A status shows its progress: **Indexing**, then **On** (or **Failed** if something goes wrong).

When you turn it off, the index is deleted. If you turn it back on later, a full indexing runs again.

{% hint style="warning" icon="eyes" %}
If **two-way conversations** are off, you can still edit the conversation, context and playbook settings, but the AI Coach doesn't use them.
{% endhint %}

#### Coach visibility

Choose who sees the AI Coach, based on your Spot's groups (up to **50 groups**):

* **Hidden from...**: members of the selected groups don't see the AI Coach. All other members have access to it.
* **Only visible to...**: only members of the selected groups see the AI Coach.

{% hint style="warning" %}
In **Only visible to...** mode, if you don't select any group, no one has access to the AI Coach.
{% endhint %}

#### Conversation

* **Coach name**: the name displayed to your users.
* **Tone of voice**: choose one or more tones among Professional, Friendly, Technical and Concise. **Professional** is selected by default, and at least one tone is required.
* **Avoid topics**: the topics the AI Coach should not discuss.

{% hint style="info" %}
If you answered the MeltingSpot agent's questions when creating your Spot, these fields are already pre-filled. Edit them at any time from this page.
{% endhint %}

#### Customization

Give the AI Coach your brand's look: icons, font and colors (👉 more information [here](https://help.meltingspot.io/english/coach-ai/configuration/customizing-the-ai-coachs-appearance.md)).

### Context tab (global)

#### Company

* **Company name**
* **Website URL**
* **LinkedIn company URL**

#### Guidelines

* **Introduction and objectives**: describe what you want to achieve and why you are creating an AI Coach.
* **Audience**: the users or user groups the AI Coach addresses.
* **Use case**: the situations in which the AI Coach supports your users (for example: onboarding free users, adopting a new feature, training your partners).

#### Documents

Add up to **3 documents** to enrich the sources the AI Coach relies on to answer your users.

{% hint style="warning" %}
Only **PDF** files are accepted. Each document is limited to **20 MB** and **30 pages**. A scanned PDF (an image, with no selectable text) cannot be read by the AI Coach.
{% endhint %}

Each document's status updates live: uploading, indexing, creating the summary, ready, or failed. A document can fail if it has more than 30 pages, contains no extractable text, or is unreadable.

Once the document is indexed, click it to read a summary of its content. You can delete a document at any time from the list: it is then no longer used by the AI Coach.

{% hint style="warning" %}
A failed document still counts toward the limit of 3 documents. Delete it to free up the slot.
{% endhint %}

{% hint style="info" %}
These settings apply to all your playbooks. Complete them with specific context from the **Playbooks** tab.
{% endhint %}

### Playbooks tab (per playbook)

Select the playbook to configure via the selector at the top of the tab. The **Open playbook** button takes you to its management page (👉 more information [here](https://help.meltingspot.io/english/coach-ai/configuration/managing-your-playbooks.md)).

#### Fallback behavior

Enable a fallback to a human or external resource in case of uncertainty: 1-1 discussion, channel, forum, or external link (👉 more information [here](https://help.meltingspot.io/english/coach-ai/configuration/configuring-the-ai-coachs-fallback.md)).

#### Guidelines (specific to this playbook)

* **Introduction and objectives**
* **Use case**
* **Avoid topics**

These guidelines add to those of the **Context** tab, they don't replace them. If they conflict, the playbook guidelines take precedence. The playbook's topics to avoid add to those set for the whole Spot.

#### Documents

Add up to **3 documents** to enrich the context of this playbook. The same rules as in the **Context** tab apply: PDF only (no scanned PDFs), 20 MB and 30 pages max, status updated live, and a failed document counts toward the limit until you delete it.

{% hint style="info" %}
These documents are only used for conversations that take place on this playbook.
{% endhint %}

### Testing your configuration

The **Test AI Coach** button opens a test window reflecting the actual behavior for the selected playbook, fallback included.

The button is only available when:

* your **company name** (**Context** tab) and the **coach name** (**Persona** tab) are filled in,
* **two-way conversations** are turned on,
* the AI Coach is active on your Spot,
* **SSO** is configured on your Spot.

{% hint style="info" %}
The test window is a sandbox. Each time you open it, a new conversation starts. Content cards cannot be opened and feedback is not offered. Your test conversations are not visible to members.
{% endhint %}

From this window, the **Open preview as member** link lets you go further: preview the AI Coach exactly as a specific member of your Spot would see it (👉 more information [here](https://help.meltingspot.io/english/coach-ai/configuration/preview-as-a-member.md)).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.meltingspot.io/english/coach-ai/configuration/configuring-your-ai-coach.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
