# Module AI — Guide fonctionnel

Cartographie des fonctionnalités IA d'ISI-APP côté utilisateur et chef de projet.
Objectif : savoir **par où commencer** et **quelle doc ouvrir selon le besoin**.

> Vous cherchez le *comment* (architecture, code, packs techniques) ? Voir la doc
> technique : [`.claude/technical-docs/ai/`](../../.claude/technical-docs/ai/README.md).

---

## Par où commencer

Le cœur du module est l'**assistant IA conversationnel** : un chat branché sur des
modèles (ChatGPT, Claude, Mistral…), configurable par entité. Commencez par
[`ai-integration.md`](ai-integration.md) — c'est la présentation d'ensemble (à quoi
sert le module, comment on crée et partage un assistant, suivi des coûts). Tout le
reste vient enrichir cet assistant.

---

## Selon votre besoin

### Je veux comprendre / présenter les assistants IA
[`ai-integration.md`](ai-integration.md) — vue d'ensemble à destination des CSM et
équipes commerciales : chat, assistants personnalisés, permissions par groupe, envoi
de fichiers, historique, suivi de la consommation de tokens et des coûts.

### Je veux configurer les fournisseurs d'IA (admin)
[`ai-connectors-backend.md`](ai-connectors-backend.md) — paramétrage des connecteurs
IA (OpenAI, Mistral…) dans `/admin/ai` : clés, modèles, sans toucher au code.

### Je veux que l'assistant agisse sur les données (« tool-calling »)
Par défaut l'assistant génère du texte. En lui activant des **packs d'outils**, il
peut interroger et modifier l'application en temps réel. Le socle côté utilisateur est
décrit dans [`ai-tool-calling-ui.md`](ai-tool-calling-ui.md) (rien à apprendre : le
chat fonctionne comme avant, mais les réponses s'appuient sur des données réelles ;
l'admin active les packs par assistant).

Les packs se lisent ensuite selon le domaine visé :

| Nature | Pack | Doc |
|--------|------|-----|
| Consultation seule | Contrats fournisseurs (+ lecture des PJ) | [`ai-tool-calling-contract-pack.md`](ai-tool-calling-contract-pack.md) |
| Consultation seule | Core Model SI (aide à la rédaction de doc) | [`ai-tool-calling-core-model-pack.md`](ai-tool-calling-core-model-pack.md) |
| Consultation | Projets, backlogs, tâches (+ contexte utilisateur) | [`ai-tool-calling-lot-bc.md`](ai-tool-calling-lot-bc.md) |
| Écriture | Saisie de temps CRM par conversation | [`ai-tool-calling-time-pack.md`](ai-tool-calling-time-pack.md) |
| Écriture | Patrimoine Isi-Immo : bâtiments, lots, pièces, équipements | [`ai-tool-calling-gmao-pack.md`](ai-tool-calling-gmao-pack.md) |
| Écriture | Portail interne : événements & actualités | [`ai-tool-calling-portal-pack.md`](ai-tool-calling-portal-pack.md) |
| Génération | Fichiers téléchargeables Word / Excel / PDF | [`ai-tool-calling-document-pack.md`](ai-tool-calling-document-pack.md) |

> Toutes les actions d'un pack respectent vos **droits** et votre **entité** : l'IA ne
> peut lire ou modifier que ce que votre profil vous autorise déjà.

### Je veux gagner du temps sur la saisie (pré-remplissage & génération)
- [`ai-auto-fill.md`](ai-auto-fill.md) — **pré-remplir** un formulaire/une fiche à
  partir de documents (PDF, Word, Excel, PowerPoint, CSV) ou de notes : l'IA propose,
  vous validez avant application.
- [`backlog-ai-generation.md`](backlog-ai-generation.md) — générer un **backlog de
  projet** à partir d'un cahier des charges PDF, avec revue avant création.
- [`rich-editor-ai.md`](rich-editor-ai.md) — **générer du contenu** directement dans
  l'éditeur de texte enrichi (bouton Assistant IA du ribbon).

### Je cherche un contenu documentaire (fiches, livrets, schémas)
[`documentation-search.md`](documentation-search.md) — la page
`Documentation › Recherche` qui centralise fiches, livrets et schémas Draw.io.

---

## Vue d'ensemble des regroupements

- **Assistants conversationnels** — le socle (`ai-integration`) et sa configuration
  admin (`ai-connectors-backend`).
- **Tool-calling / packs** — l'assistant qui agit : socle chat (`…-ui`) + packs par
  domaine (lecture seule, écriture, génération de fichiers).
- **Pré-remplissage & génération assistée** — auto-fill, génération de backlog,
  rich-editor.
- **Recherche documentaire** — recherche unifiée des contenus.