Scénarios IA

Configurez les scénarios sur /ai/scenarios. La consultation exige un droit de lecture, la création et la modification un droit de gestion. Sans le droit correspondant, la carte reste indisponible ou en lecture seule.

Contrat du scénario

Définissez un key et un nom stables, description, catégorie, enabled, useCase (text_improve, text_fix, json_analysis, custom), outputMode (text ou json), systemPrompt, userPromptTemplate, tags et éventuellement un responseSchema. Sélectionnez connectionId ou héritez de la connexion par défaut du module.

Les limites sont maxPromptChars, maxOutputChars, maxContextChars, requestTimeoutMs et overflowMode (reject ou truncate). Ne désactivez pas l’instruction système sans en mesurer les conséquences : disableSystemPrompt=true laisse uniquement le modèle utilisateur.

Tester avant activation

Lancez le scénario dans le Playground avec une entrée synthétique. Pour JSON, assurez-vous que le schéma est un objet valide, que les champs requis sont pertinents et que le formulaire cible sait traiter la réponse. Testez une entrée longue, le timeout, une connexion absente et un chargement partiel. Désactivez un scénario obsolète (enabled=false) au lieu de réutiliser son key.

Formulaire et conflits de modification

La création ou la modification exige key et le nom. Si elle est fournie, responseSchema doit être un objet JSON ; saisissez les tags séparés par des virgules. Actualiser dans la fenêtre du scénario recharge les dernières données enregistrées et avertit si l’enregistrement a été supprimé ou est introuvable. Lorsqu’une connexion est liée, sa fiche peut être ouverte depuis le formulaire ; désactiver conserve l’enregistrement et fixe enabled à false.

Sécurité

Les prompts ne doivent pas demander mots de passe, tokens, données personnelles inutiles, montants contractuels ou fichiers d’un autre client. Un scénario qui modifie le CRM, les tâches, le calendrier ou les documents exige toujours une revue humaine. La description doit préciser le responsable, le contexte autorisé et le critère de fin.

Si un scénario ne se charge pas, ne s’exécute pas ou renvoie une réponse vide, affichez la cause et vérifiez à nouveau ses réglages. Pour les démonstrations, utilisez des données synthétiques sans argent ni secrets et vérifiez les libellés dans la langue de l’interface.

Voir aussi : Playground IA, Connexions IA, Réglages IA et Assistant.