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

# Steeple AI assistant — Overview and use

### Overview

The**AI assistant** is a tool built into Steeple that lets you interact with the platform through conversation. It can answer questions about how Steeple works and perform actions on your behalf (create an event, search for an employee, create a post, etc.).

The feature is in **beta**.

### Access the assistant

The assistant is accessible from a side panel in the Steeple interface. It opens as a sidebar and remains available while navigating the platform.

### Choose a scope

The assistant works by **scopes** (scopes). Each scope provides access to specific features:

* **Administration** : manage users, departments, sites, communities, TV screens
* **Directory** : search for employees, view distribution by department or site
* **News** : manage posts and sections
* **Events** : view the calendar, create events, track attendance
* **Shortcuts** : manage shortcuts to links, documents, or media
* **Feeds** : manage automatic or manual content feeds
* **Job offers** : manage job offers and track applications
* **Notifications** : view notifications and configure preferences
* **Messaging** : view conversations and send messages
* **Documents** : browse, search, and organize documents
* **Profile** : view and edit your account information

The details of the actions available for each scope are described in the article [Scopes and available actions](/en/assistant-ia/assistant-ia-perimetres.md).

### Send a message

* Type the message in the text field at the bottom of the panel
* Press **Enter** to send (or **Shift+Enter** for a line break)
* The assistant displays "Thinking..." while processing the request

### Attach a document

It is possible to attach a document or an image so the assistant can use its content:

* Click the **paperclip** icon next to the input field
* Select a file (PDF, Word, Excel, PowerPoint, OpenDocument, CSV, TXT, RTF, HTML, Markdown, EPUB, or image)
* The content is analyzed and sent to the assistant with the following message

The details of accepted formats, maximum sizes, and use cases are described in the article [Attach a document to the assistant](/en/assistant-ia/assistant-ia-documents.md).

### Action confirmation

When the assistant is about to perform a write action (create, modify, or delete something), a **confirmation request** is displayed with a summary of the intended action. Two buttons allow you to accept (**Yes**) or refuse (**No**).

The assistant never performs any modification action without your approval.

### Actions performed

After each action, a collapsible summary shows what was done (for example "1 action performed"). Click it to see the details of the operations carried out.

### Navigation

The assistant can suggest direct links to other Steeple pages in the form of "Go to \[Page]" buttons. Click them to navigate directly.

### Suggestions

When a conversation is opened, the assistant displays a welcome message with **question suggestions** tailored to the active scope. Click a suggestion to send it directly.

### Give feedback

On the assistant's last message, **thumbs up** and **thumbs down** buttons allow you to rate the response. An optional comment can be added to provide more detail.

### New conversation

To start a conversation over, click the button **New conversation** that appears in the header when the assistant is not processing a request. The previous conversation is replaced.

### Persistence

The current conversation is automatically saved. It is kept even after a page reload or navigation within Steeple. Only one conversation is kept at a time per organization.


---

# 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://help.steeple.com/en/assistant-ia/assistant-ia.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.
