---
title: "Assistants IA - Présentation Fonctionnelle"
module: ai
type: functional
status: active
updated: 2026-07-30
---

# Assistants IA - Présentation Fonctionnelle

> Document à destination des CSM et équipes commerciales pour présentation clients

---

## Vue d'ensemble

ISI-App intègre désormais un module **Assistants IA** permettant aux utilisateurs de converser avec des intelligences artificielles personnalisées (ChatGPT, Claude, etc.).

**Points clés :**
- Interface de chat intuitive et moderne
- Assistants personnalisables par client
- Gestion fine des accès par groupe utilisateur
- Support des pièces jointes (images, PDF, documents)

---

# PARTIE ADMIN

## Accès

Menu : **Administration > IA > Assistants**

## Création d'un assistant

### Informations générales

| Champ | Description |
|-------|-------------|
| **Entité** | Client concerné, ou "Tous les clients" pour un assistant global |
| **Nom** | Nom affiché aux utilisateurs (ex: "Assistant Support") |
| **Slug** | Identifiant technique unique |
| **Description** | Texte explicatif (optionnel) |
| **Catégorie** | Regroupe l'assistant dans la galerie utilisateur (Rédaction & contenu, Juridique, Technique & SI, Gestion de projet, Communication). Optionnel — sinon classé dans « Autres assistants » |
| **Icône** | Icône FontAwesome (ex: fa-solid fa-robot), affichée si aucun logo |
| **Couleur** | Couleur d'accent de la carte (palette : bleu, indigo, violet, rose, rouge, ambre, vert, cyan, gris) |
| **Logo** | Image personnalisée (PNG, JPG, SVG, WebP — max 2 Mo) affichée à la place de l'icône |

### Configuration IA

| Champ | Description |
|-------|-------------|
| **Provider** | Fournisseur IA (OpenAI, Anthropic, Mistral...) |
| **Modèle** | Modèle à utiliser (GPT-4, Claude 3, Mistral...) |
| **Prompt système** | Instructions de comportement de l'assistant |
| **Température** | Créativité (0 = précis, 2 = créatif) |
| **Max tokens** | Limite de longueur des réponses |
| **Recherche web** | Active la recherche web temps réel (modèles compatibles uniquement) |
| **Recherche web premium** | Variante premium avec sources presse vérifiées (Mistral medium+) — disponible uniquement si la recherche web est activée et le modèle compatible |
| **Raisonnement étendu** | Active le mode *extended thinking* (Claude uniquement) — disponible uniquement si le modèle l'autorise |

### Recherche web

Quand activée sur un assistant, l'IA peut interroger le web pour répondre. Les sources
utilisées s'affichent automatiquement en pied de réponse sous forme de pastilles cliquables.

**Variantes :**
- **Standard** (`web_search`) : moteur de recherche généraliste, supporté par OpenAI et Mistral medium+.
- **Premium** (`web_search_premium`) : sources presse vérifiées, supporté uniquement par Mistral. Facturation à l'usage différente.

L'admin doit cocher le support web search au niveau du modèle (`Administration > IA > Modèles`)
avant que le toggle apparaisse sur l'assistant.

### Raisonnement étendu (Claude)

Quand activé, le modèle Anthropic alloue un **budget adaptatif de tokens de raisonnement**
avant de produire sa réponse finale. Cela améliore la qualité des réponses sur des problèmes
complexes (analyse, planification, debug). Spécifique aux modèles Claude.

**Configuration en deux niveaux :**
1. **Modèle** (`Administration > IA > Modèles`) : l'admin coche `Raisonnement étendu` et
   définit le **budget en tokens** (min 1024, défaut 8000). Le toggle apparaît uniquement
   pour les modèles dont le provider est Anthropic.
2. **Assistant** (`Administration > IA > Assistants`) : l'admin coche
   `Activer le raisonnement étendu` uniquement si le modèle sélectionné l'autorise.
   Le budget n'est pas configurable au niveau de l'assistant (il provient du modèle).

**Affichage côté utilisateur :**

La réponse (raisonnement inclus) est générée en arrière-plan et s'affiche
**progressivement** : le texte se remplit au fil de l'eau (rafraîchissement ~1 s)
sans bloquer l'interface.

- **Pendant la réponse** : un encart « Raisonnement en cours… » se remplit avec le
  raisonnement de l'IA, puis le texte de la réponse prend le relais.
- **Après la réponse complète** : le raisonnement se collapse en un bouton
  « Voir le raisonnement » qui reste disponible pour rouvrir le résumé.

**Points d'attention :**
- Les tokens de raisonnement sont facturés comme des **tokens de sortie**.
- L'API Anthropic exige `temperature = 1` quand le raisonnement étendu est actif ;
  la valeur configurée sur l'assistant est forcée automatiquement à 1 pour ces appels.

### Permissions

| Champ | Description |
|-------|-------------|
| **Groupes autorisés** | Groupes d'utilisateurs ayant accès |

## Types d'assistants

### Assistant spécifique (mono-entité)

- Rattaché à **une seule entité** (client)
- Seuls les utilisateurs de cette entité y ont accès
- Les groupes proposés sont ceux de l'entité

**Exemple :** Assistant support technique pour le client "Hôpital Saint-Louis"

### Assistant global (multi-entités)

- **Aucune entité** sélectionnée → badge vert "Toutes les entités"
- Accessible à **tous les clients** (selon les groupes sélectionnés)
- Les groupes sont affichés avec le format : `Entité - Groupe`

**Exemple :** Assistant RH accessible aux groupes "Direction" de toutes les entités

## Gestion des assistants

| Action | Description |
|--------|-------------|
| **Activer/Désactiver** | Un assistant désactivé n'apparaît plus pour les utilisateurs |
| **Modifier** | Édition complète de la configuration |
| **Supprimer** | Suppression définitive (avec confirmation) |

---

# PARTIE UTILISATEUR

## Accès

Menu : **IA** (ou via le menu configuré)

## Liste des assistants

L'utilisateur voit uniquement les assistants :
- **Actifs**
- Rattachés à son entité **ou** globaux
- Dont il fait partie d'**au moins un groupe autorisé**

La galerie « Trouvez le bon assistant en un coup d'œil » propose :
- une **barre de recherche** (filtre instantané sur le nom et la description) ;
- des **pills de filtre par catégorie** (« Tous » + une pastille par catégorie réellement présente) ;
- un **regroupement par sections** (une section par catégorie, les assistants sans catégorie en « Autres assistants »).

Chaque carte affiche :
- le **logo** de l'assistant (ou son icône dans une pastille colorée si aucun logo) ;
- le **nom** ;
- le **modèle · provider** utilisé ;
- une flèche d'accès au chat (la carte entière est cliquable).

## Interface de chat

### Zone de conversation

- **Historique** des messages avec l'assistant
- Messages utilisateur à droite, réponses assistant à gauche
- Horodatage des messages
- Affichage des pièces jointes

### Sidebar (historique)

- Liste des conversations passées
- Groupement par date : Aujourd'hui, Hier, Cette semaine, Ce mois, Plus ancien
- Actions sur chaque conversation :
  - **Renommer** (clic sur le titre)
  - **Exporter** en fichier texte
  - **Supprimer**

### Envoi de messages

- Zone de saisie avec support multi-lignes
- Bouton d'envoi (ou touche Entrée)
- Indicateur de chargement pendant la réponse
- **Traitement asynchrone** : la réponse de l'assistant est générée en arrière-plan.
  L'interface n'est pas bloquée pendant l'attente — vous pouvez continuer à lire,
  naviguer dans l'historique ou rédiger le message suivant. La réponse s'affiche
  progressivement dès qu'elle est disponible.

### Pièces jointes

**Formats supportés :**
- Images : JPG, PNG, GIF, WebP
- Documents : PDF, Word (DOC, DOCX), Texte brut

**Limites :**
- 3 fichiers maximum par message
- 10 Mo maximum par fichier

**Usage :**
- Glisser-déposer ou clic sur le bouton d'ajout
- Prévisualisation avant envoi
- Suppression possible avant envoi

**Mémoire des fichiers dans la conversation :**
- Le fichier joint au message en cours est transmis intégralement à l'assistant
  (images comprises, qui sont réellement « vues » par les modèles compatibles).
- Aux questions suivantes, l'assistant conserve le **contenu texte** des fichiers
  envoyés précédemment : inutile de re-joindre le même document à chaque message.
  Pour les documents volumineux, seul un extrait est rappelé — si votre question
  porte sur une partie précise d'un long document, re-joignez-le.
- Les images envoyées lors des messages précédents ne sont plus analysables : leur
  nom seul est rappelé. Pour une nouvelle analyse visuelle, re-joignez l'image.

---

## Cas d'usage types

### Support technique
> "Créez un assistant connecté à GPT-4 avec un prompt orienté support technique. Limitez l'accès au groupe 'Techniciens'."

### Assistant RH global
> "Créez un assistant global accessible aux groupes 'Direction' de toutes les entités pour répondre aux questions RH."

### Analyse de documents
> "Les utilisateurs peuvent envoyer des PDF ou images et demander à l'assistant de les analyser, résumer ou extraire des informations."

---

## FAQ

**Q : Un utilisateur ne voit pas un assistant, pourquoi ?**
> Vérifier : (1) l'assistant est actif, (2) l'utilisateur appartient à un groupe autorisé, (3) l'entité correspond ou l'assistant est global.

**Q : Peut-on avoir plusieurs assistants par client ?**
> Oui, sans limite. Chaque assistant peut avoir une configuration et des permissions différentes.

**Q : Les conversations sont-elles sauvegardées ?**
> Oui, l'historique complet est conservé. L'utilisateur peut exporter ou supprimer ses conversations.

**Q : Quels providers sont disponibles ?**
> OpenAI (GPT-4, GPT-3.5), Anthropic (Claude 3), et potentiellement d'autres selon configuration.

---

## Visuels clés

### Admin - Liste des assistants
- Tableau avec colonnes : Nom, Slug, Entité, Provider, Modèle, Groupes, Statut
- Badge vert "Toutes les entités" pour les assistants globaux
- Actions rapides en ligne

### Admin - Formulaire assistant
- Formulaire en sections : Général, Configuration IA, Permissions
- Sélecteur de groupes avec format "Entité - Groupe" si global

### Utilisateur - Liste assistants
- Cartes visuelles avec icône, nom, description
- Clic pour ouvrir le chat

### Utilisateur - Interface chat
- Design moderne type ChatGPT/Claude
- Sidebar conversations à gauche
- Zone de chat principale à droite
- Zone de saisie en bas avec support pièces jointes
