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

# 03. Using the AI Assistant

## Start a conversation

{% stepper %}
{% step %}

### Open the AI assistant

Open the AI assistant from the available AI control in CXAIR.
{% endstep %}

{% step %}

### Select a model

Select a model from the **Model** list. Only saved models available to your account are shown.
{% endstep %}

{% step %}

### Select a mode

If you are working in a Pages report, select **Data** or **Design** mode as appropriate.
{% endstep %}

{% step %}

### Submit a request

Enter a request and select **Ask**.
{% endstep %}

{% step %}

### Review the result

Review both the response and any resulting report or data changes.
{% endstep %}
{% endstepper %}

## Conversation controls

| Control           | Purpose                                                                                                                          |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Model             | Selects the configured AI model used for subsequent requests.                                                                    |
| New conversation  | Clears the current conversation and its remembered tool context.                                                                 |
| Load conversation | Loads a conversation saved alongside the current saved report when one is available.                                             |
| Data / Design     | Changes the assistant's purpose in a Pages report. Data mode supplies report context; Design mode enables report-design tooling. |
| Image attachment  | Attaches images when the selected model supports image input and the files meet its size limit.                                  |
| Stop              | Cancels the response currently being generated without ending the conversation. Any output already received is kept.             |

## Stopping a response

While the assistant is working on a request, the **Ask** button becomes **Stop** and a Stop option also appears next to the progress indicator. Selecting either cancels that request only: response text already received is kept, and the conversation can continue with a new request.

## Conversation context

CXAIR keeps conversation context in the current session. It can remember tool results such as index names, field names and arguments during that conversation. Starting a new conversation clears this memory.

When a report is supplied as context, the amount included may be limited by the model's context window and administrator settings.