L'onglet Texte offre un chat conversationnel intégré pour interagir directement avec des modèles de langage (LLM — Large Language Models : programmes d'IA entraînés à comprendre et générer du texte, comme des assistants virtuels très avancés). C'est le cœur de la génération IA textuelle dans Celestory : vous pouvez co-écrire du contenu, générer du code, rédiger des scripts narratifs, interroger vos données de projet en langage naturel — **et faire construire votre graphe par l'IA**.
### ⚠️ Le point le plus important : ce chat peut modifier votre projet
Ce n'est pas un simple chatbot. Dès que le modèle sélectionné sait manipuler des **outils**, chaque message que vous envoyez déclenche un **tour d'agent** : l'assistant ajoute des blocs, les relie, écrit des dialogues, crée des variables et des personnages **dans le graphe que vous avez sous les yeux**, puis vous raconte ce qu'il a fait.

- Il n'y a **pas de bascule** à activer : c'est le modèle choisi qui décide. Si le modèle n'est pas compatible, un **bandeau d'avertissement** s'affiche (« Le modèle sélectionné (…) ne prend pas en charge les outils : il ne peut pas toucher au graphe et se contentera de répondre dans le chat ») et le chat redevient une simple conversation, sans effet sur votre histoire.
- L'assistant dispose de **29 outils** dédiés au graphe, auxquels s'ajoutent ceux de vos connecteurs MCP (onglet Outils).
- Il enchaîne au maximum **8 séries d'appels d'outils** par réponse ; au-delà il s'arrête, et ce qu'il a déjà construit reste dans le graphe.
- Chaque action s'inscrit dans la conversation sous forme de carte lisible (« Ajout du personnage Alex », « 3 choix posés »), dépliable pour voir le détail.
- Sous le message qui a lancé le travail, un bouton **Annuler ce tour** remet le projet dans l'état d'avant — l'unité annulée est le tour complet, pas chaque modification.

👉 Le détail complet de ce que l'assistant sait faire, ses règles et ses limites : [L'assistant IA qui construit votre graphe](Assistant_Graphe.md) et [L'agent IA du Graphe : ce qu'il peut faire](../../../Découvrir%20Celestory/Découvrir%20Celestory%20v3/L_Agent_IA_Du_Graphe.md).
### Comment ça marche ?
Vous saisissez un message dans le champ de chat. Le modèle reçoit :
1. L'historique de vos échanges précédents (pour maintenir le contexte)
1. Éventuellement des variables textuelles de votre projet attachées au message
1. Votre prompt actuel (l'instruction ou la question que vous envoyez à l'IA)

Il génère une réponse qui s'affiche progressivement dans le chat, rendue en Markdown (format de mise en forme de texte léger : `# Titre`, `gras`, `- liste` → s'affiche proprement comme du texte enrichi) en temps réel.
### Interface de conversation
- **Panneau gauche** : liste de vos conversations précédentes, nommées automatiquement et organisées en groupes. Vous pouvez épingler une conversation importante en haut de la liste, la renommer, la déplacer dans un groupe, ou en créer une nouvelle. La séparation entre les deux panneaux se déplace à la souris.
- **Panneau droit** : zone de chat avec sélection du modèle, compteur de tokens, historique des messages et champ de saisie.
### Fonctionnalités clés
- **Sélection du modèle** : choisissez parmi les modèles disponibles, regroupés par fournisseur (avec le logo de la marque quand il existe). Le coût en crédits du modèle est affiché juste à côté.
- **Compteur de tokens** : l'interface affiche en temps réel le nombre de tokens (unités de texte que l'IA traite — un token ≈ ¾ de mot en français) utilisés par l'historique par rapport à la fenêtre de contexte du modèle sélectionné (ex : 12 530 / 256 000 tokens). Quand le fournisseur remonte la mesure réelle, le détail est indiqué au survol (entrée, sortie, tokens mis en cache, tokens de raisonnement) ; sinon c'est une estimation, et l'interface le dit.
- **Estimation de l'input** : avant d'envoyer un message, le nombre de tokens supplémentaires que votre saisie va consommer est affiché (ex : + 842 tokens).
- **Attachement de variables textuelles** : vous pouvez attacher des variables textuelles de votre projet (un personnage, une règle de jeu, une charte graphique) au prompt. Chaque variable attachée affiche son poids en tokens et est ajoutée à la fin de votre message.
- **Aperçu Markdown** : les réponses de l'IA sont rendues en Markdown en temps réel, idéal pour valider visuellement des documents structurés.
- **Gestion de l'historique** : suppression de messages individuels, rechargement de conversations sauvegardées, annulation d'un tour entier de l'assistant.
### Cas d'usages
- 🏗️ **Construction du graphe** : demander à l'assistant de poser une scène, un embranchement, un groupe de blocs — et le voir apparaître dans le graphe.
- ✍️ **Co-écriture narrative** : rédiger ou réécrire des dialogues, des descriptions de scène ou des embranchements de scénario.
- 💻 **Vibe Coding** : générer du code HTML/CSS/JS pour un bloc HTML5 (voir la section Vibe Coding ci-dessous).
- 🗂️ **Interrogation de données de projet** : poser une question en langage naturel sur une variable texte attachée (une règle de jeu, une charte, un export de données).
- 🧾 **Génération de documents structurés** : produire un compte-rendu, une fiche pédagogique ou un support de formation au format Markdown.
- 🌍 **Traduction et relecture** : traduire ou reformuler un contenu existant du projet.
### Modèles de texte disponibles
La liste des modèles **n'est pas figée dans le logiciel** : elle vit côté serveur, dans une table administrée par Celestory. Elle peut donc changer (ajout, retrait, renommage) sans que vous ayez rien à mettre à jour.

Les fournisseurs identifiés par un logo dans l'interface sont aujourd'hui : **Mistral**, **OpenAI**, **Google**, **Anthropic**, **Meta** et **xAI**. D'autres peuvent apparaître sans logo.

Pour chaque modèle, trois informations comptent :
- sa **fenêtre de contexte** (combien de texte il peut retenir),
- son **coût en crédits** (le badge `©`),
- sa **compatibilité avec les outils** — c'est un réglage porté par le modèle lui-même, et c'est lui qui décide si l'assistant peut toucher à votre graphe.

⚠️ Ne soyez pas surpris si un modèle apparaît, disparaît ou change de nom d'une fois à l'autre : regardez simplement la liste proposée dans le sélecteur au moment où vous générez.
---