Paramètres d'instructions de l'agent

Aperçu

Le paramètre Instructions dans la configuration de l'agent définit l'identité fondamentale, les responsabilités, le ton et les contraintes comportementales de votre agent par le biais de prompts système.

Il garantit que votre agent comprend son rôle, respecte des limites opérationnelles strictes et répond de manière cohérente aux interactions des utilisateurs. L'estimation intégrée du coût en crédits offre une visibilité totale sur la consommation de jetons, tandis que la gestion des versions de prompts et l'optimisation par IA vous permettent d'expérimenter en toute sécurité et d'affiner vos instructions au fil du temps.

Utilisez cette fonctionnalité chaque fois que vous créez un nouvel agent, ajustez des directives comportementales, réduisez la consommation de crédits ou restaurez une version précédente de prompt enregistrée.

Prérequis

Avant de configurer les instructions de l'agent, assurez-vous de disposer de :

• Un compte Swiftask actif sur n'importe quel forfait.

• Les autorisations d'espace de travail pour modifier les agents (Propriétaire, Administrateur ou Éditeur).

• Un agent existant ou nouvellement créé prêt à être configuré.

Guide étape par étape

1. Ouvrir les paramètres des instructions

1. Dans la barre latérale gauche, cliquez sur Agents.

2. Sélectionnez l'agent à modifier et cliquez sur l'icône de crayon pour passer en mode édition.

3. Dans le panneau de configuration à gauche, développez Agent Instruction et sélectionnez Instructions.

2. Configurer le prompt et vérifier le coût en crédits

1. Saisissez les directives de votre agent directement dans la zone de texte Prompt. Structurez vos instructions avec des sections claires comme Your role, Tasks et Rules.

2. Consultez la mention d'estimation du coût en crédits au-dessus de l'éditeur :
   « For reference, this prompt costs about X credits ([Nom du modèle sélectionné]). »
   Ce calcul s'ajuste automatiquement selon la longueur du prompt et le modèle défini dans les paramètres LLM.

3. Notez la mention de sauvegarde automatique sous l'éditeur : toutes les modifications sont enregistrées automatiquement.

3. Optimiser les instructions avec Vérifier et optimiser

1. Dans la barre d'outils en haut à droite de l'éditeur de prompt, cliquez sur Check & optimize.

2. Une fenêtre modale Prompt review s'ouvre pendant que l'agent Prompt Optimizer analyse la structure, la clarté et les contraintes d'outils de votre prompt.

3. Une fois l'analyse terminée, examinez la vue fractionnée :

• Recommendations (panneau de gauche) : Liste d'améliorations concrètes (clarification des protocoles, comportements de secours pour les outils, qualité des citations).

• Optimized prompt (panneau de droite) : Version entièrement réécrite et prête à l'emploi intégrant toutes les recommandations.

3. Cliquez sur l'icône de copie dans le panneau de droite pour copier le texte dans votre presse-papiers, ou cliquez sur le bouton rouge Apply optimized prompt pour remplacer immédiatement le prompt dans l'éditeur.

4. Pour conserver votre prompt initial sans appliquer de modifications, cliquez sur la croix (X) pour fermer la fenêtre modale.

4. Enregistrer une version de prompt

1. Dans la barre d'outils en haut à droite de l'éditeur, cliquez sur Save this version.

2. Dans la boîte de dialogue Save this version, saisissez un nom ou une étiquette de version (ex. : v0.1 ou v1.0-support-baseline).

3. Cliquez sur Validate pour sauvegarder l'instantané, ou sur Cancel pour annuler.

4. Après l'enregistrement, l'identifiant de la version active s'affiche dans la barre d'outils (ex. : Version: v0.1). Cliquez sur l'icône de crayon à côté du libellé pour renommer la version directement.

5. Consulter et restaurer les versions précédentes

1. Dans la barre d'outils supérieure, cliquez sur See versions.

2. Dans la modale Select the saved versions, parcourez les versions enregistrées. Vous pouvez utiliser le champ de recherche Search any agent en haut pour filtrer les versions.

3. La version actuellement active est marquée d'une coche (✓).

4. Cliquez sur les trois points verticaux (⋮) à droite de la version de votre choix.

5. Cliquez sur Apply this version pour charger ce prompt dans l'éditeur.

6. Supprimer des versions enregistrées

1. Dans la barre d'outils supérieure, cliquez sur See versions.

2. Cliquez sur les trois points verticaux (⋮) à droite de la version à supprimer.

3. Cliquez sur Remove pour supprimer définitivement cette version de votre liste.

Cas d'usage pratiques

Itération sécurisée et tests comparatifs (A/B testing)
Enregistrez une version de base telle que v1.0-concise, puis testez des directives plus exhaustives. Basculez entre vos versions via See versions pour comparer le comportement de l'agent dans des conditions rigoureusement identiques.

Restauration après optimisation par IA
Sauvegardez votre prompt actuel avant de cliquer sur Check & optimize. Si la nouvelle version générée par l'IA ne répond pas parfaitement à vos cas limites, restaurez votre version précédente en deux clics.

Gestion de la consommation de crédits
Surveillez l'estimation du coût en crédits tout en supprimant les formulations superflues. Réduire les explications redondantes diminue le nombre de jetons consommés lors de chaque message traité par l'agent.

Conseils et bonnes pratiques

• Structurez avec des titres explicites : Organisez votre prompt avec des sections claires (Your role, Tasks, Rules) pour faciliter la compréhension du modèle LLM.

• Enregistrez une version avant toute optimisation : Cliquez toujours sur Save this version avant d'appliquer un prompt optimisé afin de conserver une version de secours.

• Adoptez une nomenclature précise : Nommez vos versions par étape ou objectif (ex. : v1.0-production, v1.1-test-outils) pour simplifier leur gestion.

• Surveillez les coûts en crédits : Vérifiez l'indicateur de crédits estimés lors du changement de modèle dans les paramètres LLM, les coûts de traitement variant selon le modèle choisi.

Dépannage

Problème : Le chargement de « Check & optimize » prend trop de temps
Cause : L'agent d'optimisation traite un prompt très long ou le réseau subit un ralentissement temporaire.
Solution : Patientez jusqu'à 30 secondes. Si la fenêtre ne s'affiche pas, fermez-la puis cliquez à nouveau sur Check & optimize.

Problème : Les boutons d'action sont désactivés ou invisibles
Cause : L'agent est verrouillé ou votre rôle ne dispose pas des droits d'édition.
Solution : Vérifiez que le commutateur de verrouillage de l'agent est désactivé et que vous disposez des droits d'administration ou d'édition dans l'espace de travail.

Problème : Les modifications du prompt n'apparaissent pas dans les conversations en cours
Cause : Les sessions de chat existantes conservent le contexte et les instructions chargés au lancement de la conversation.
Solution : Démarrez une nouvelle conversation avec l'agent pour tester les nouvelles instructions appliquées.

Ressources complémentaires

• Tester et interagir avec l'agent – Validez les ajustements de prompt au cours d'interactions réelles.

• Bonnes pratiques pour optimiser l'utilisation des crédits Swiftask – Maîtrisez les stratégies pour réduire la consommation de crédits IA dans votre espace de travail.