Étape 2 : Préparer un ensemble de prompts
Un ensemble de prompts regroupe plusieurs prompts dédiés à un usage de l'IA dans SquashTM (aujourd'hui, la génération de cas de test classiques). C'est ce qui dicte à l'IA comment répondre : son rôle, le format de sortie attendu, les variables injectées depuis SquashTM.
Prérequis
- Compte avec droits administrateur (pour un ensemble au niveau de l'instance) ou de chef de projet (pour un ensemble au niveau d'un projet).
- Licence SquashTM Ultimate 💎.
Option A : Utiliser un ensemble fourni par défaut
SquashTM livre deux ensembles de prompts pré-configurés, l'un en français et l'autre en anglais. Chaque ensemble contient trois prompts prêts à l'emploi, qui produisent des cas de test de plus en plus riches :
| Prompt | Ce que contient le cas de test généré |
|---|---|
| Génération standard | Nom, description, prérequis et pas de test. |
| Génération détaillée | Idem, plus l'importance et la référence. |
| Génération détaillée avec jeux de données | Idem, plus des jeux de données permettant de variabiliser le cas de test. |
Ces ensembles sont identifiés par le badge "S" (Système) dans le tableau de gestion. Ils sont en lecture seule et ne peuvent pas être supprimés.
Pour un démarrage rapide, utiliser un ensemble de prompts du système
Si c'est votre première mise en place, passez directement à l'étape 3 en associant l'ensemble de prompts du système correspondant à la langue de votre projet. Vous pourrez créer un ensemble personnalisé plus tard.
Option B : Créer un ensemble de prompts personnalisé
Si vous avez besoin d'adapter le ton, le format de sortie ou d'injecter des données spécifiques, créez votre propre ensemble. Selon vos droits, deux niveaux sont possibles :
- au niveau de l'instance (droits administrateur) : ensemble disponible pour tous les projets. Rendez-vous dans Administration > Entités, puis cliquez sur l'ancre Ensembles de prompts
; - au niveau d'un projet (droits de chef de projet) : ensemble utilisable uniquement dans ce projet. Rendez-vous dans la configuration IA du projet, puis cliquez sur le bouton [Gérer les ensembles de prompts du projet].
Dans les deux cas, le tableau de gestion et la création d'ensembles fonctionnent de façon identique.
Plus rapide : dupliquer un ensemble existant
Plutôt que de partir de zéro, dupliquez un ensemble existant (par exemple un ensemble du système) depuis le tableau de gestion : la copie reprend tous ses prompts et est immédiatement modifiable.
Créer l'ensemble
Cliquez sur Ajouter 
et renseignez :
- Nom : unique, obligatoire ;
- Usage : Génération de cas de test classiques (seul usage disponible aujourd'hui) ;
- Description : facultative.
Ajouter un ou plusieurs prompts à l'ensemble
Ouvrez l'ensemble en cliquant sur son # ou son Nom, puis ajoutez un prompt avec .
Un prompt est composé de trois éléments :
- un modèle du prompt système : définit le rôle de l'IA et le format JSON attendu en sortie ;
- un modèle du prompt utilisateur : porte la demande, enrichie des données de l'exigence (
{{requirement.name}},{{requirement.description}}, etc.) ; - un modèle d'encapsulation du contexte (optionnel) : contrôle la façon dont les exigences fournies, les cas de test et les documents joints sont intégrés au message envoyé à l'IA.
Syntaxe Handlebars
Les trois modèles utilisent la syntaxe Handlebars ({{variable}}, {{#if}}…{{/if}}, {{#each}}…{{/each}}). Pour la liste complète des placeholders disponibles et des exemples détaillés, consultez Gérer les ensembles de prompts.
S'inspirer des prompts par défaut
Le contenu complet des trois prompts par défaut (système, utilisateur, encapsulation du contexte) est consultable dans la page de référence : Exemples de prompts. Copiez-les comme point de départ et adaptez-les à vos besoins.
À quoi sert l'encapsulation du contexte ?
Le contexte désigne les informations complémentaires que le testeur peut ajouter à sa demande au moment de la génération : exigences, cas de test existants et documents joints (spécifications, maquettes, etc.). Le modèle d'encapsulation du contexte contrôle la façon dont ces informations sont mises en forme et insérées dans le message envoyé à l'IA.
Si ce modèle est rempli, le panneau Contexte & Sources sera proposé au testeur lors de la génération, lui permettant d'ajouter des exigences, des cas de test et des documents en contexte.
Si ce modèle est laissé vide, le panneau ne s'affichera pas et la génération s'appuiera uniquement sur l'exigence source.
Ce que vous avez accompli
- Vous avez décidé d'utiliser un ensemble de prompts du système ou créé un ensemble personnalisé ;
- l'ensemble retenu contient au moins un prompt prêt à l'emploi ;
- cet ensemble est désormais disponible dans la configuration IA des projets concernés : tous les projets pour un ensemble créé au niveau de l'instance, le projet seul pour un ensemble créé au niveau du projet.