Éditeur d’invite

L'éditeur d'invites est la zone de texte enrichi d'Agent Builder où vous écrivez l'invite système et l'invite utilisateur. Les arguments, les outils, les contextes, les escalades et les sorties sont représentés sous forme de références en ligne codées en couleur (appelées pilules) plutôt que d'espaces réservés saisis.

L'éditeur d'invites est disponible pour les agents autonomes et conversationnels et s'applique à l'invite système et à l'invite utilisateur.

Le déclencheur @

L'éditeur d'invite utilise une seule touche de déclencheur pour tous les types de référence.

Le fait de saisir @ n'importe où dans l'invite ouvre le sélecteur de référence. Le sélecteur regroupe les références disponibles en cinq sections dans un ordre fixe :

1. Entrées - arguments que l'agent reçoit lors du runtime
2. Outils - outils connectés à l'agent
3. Contexte - sources d'ancrage dans le contexte
4. Escalades - chemins d'escalade
5. Sorties - sorties des étapes précédentes, le cas échéant

Si vous continuer à taper après @, la liste est affinée grâce à une recherche approximative : il n'est pas nécessaire que le préfixe soit exact. Par exemple, @srch correspond à tools.web_search.

Navigation par clavier dans le sélecteur

Clé (Key)	Action
↑ / ↓	Déplacer la sélection vers le haut ou le bas
Tab / Maj+Tab	Identique aux touches fléchées
Enter	Insérez la référence en surbrillance
Esc	Fermez le sélecteur sans insérer
Sélection à la souris	Insérer la référence sélectionnée

Lorsque @ n'ouvre pas le sélecteur

Pour éviter une activation involontaire pendant la saisie normale, le caractère @ ouvre le sélecteur uniquement lorsqu'il apparaît :

• au début d'une ligne, ou
• immédiatement après un caractère d'espace blanc.

Le fait d'écrire [e-mail] au milieu d'une phrase n'ouvre pas le sélecteur ; le @ est conservé en tant que texte brut. La saisie d'un espace avant que @ ne force le sélecteur à s'ouvrir.

Compatibilité avec les espaces réservés {{ }}

Les invites existantes qui contiennent {{argument_name}} continuent de fonctionner sans étape de migration. Lorsque l'éditeur charge une invite, les espaces réservés {{ }} sont automatiquement convertis en pilules à l'écran. Lorsque l'invite est enregistrée, les pilules d'entrée sont réécrites dans le stockage en tant que {{argument_name}} et les pilules d'outil, de contexte et de sortie en tant que @{tools.search} ; ce qui préserve la compatibilité avec tous les systèmes backend qui lisent les invites sous forme de texte.

Le fait de taper {{ ... }} directement pendant la modification n'est pas un déclencheur de création ; il est conservé en tant que texte brut et ne se convertit en une pilule que lorsque l'invite est enregistrée et rouverte, à condition que le nom interne corresponde à un argument existant. Utilisez @ pour insérer des références.

Références comme pilules

Chaque référence d'une invite s'affiche sous forme de pilule en ligne contenant :

• une icône de catégorie
• un libellé - le dernier segment du chemin de référence (par exemple, web_search plutôt que tools.web_search)
• une couleur reflétant la catégorie de référence : entrées en bleu, outils, contextes et escalades en vert, sorties en orange

Les pilules se comportent comme des unités uniques :

• Les touches fléchées permettent de déplacer le curseur sur une pilule en appuyant une seule fois sur une touche.
• La touche Retour arrière ou Suppr supprime la référence dans son intégralité.
• Chaque pilule dispose d'un bouton × qui apparaît au survol de la souris et permet de la supprimer.
• Les pilules peuvent être copiées et collées dans différents champs d'invite du même agent ou dans les invites d'un autre agent. Lorsqu'elles sont collées dans une destination en texte brut en dehors de l'éditeur, les pilules reviennent au format texte {{...}} ou @{...}.

Références non valides

Lorsqu'une référence pointe vers une ressource qui n'existe plus (par exemple, un outil qui a été supprimé ou un argument qui a été renommé manuellement), la pilule devient rouge. Il s'agit d'un signal visuel uniquement ; l'invite est toujours enregistrée telle quelle.

Vous pouvez résoudre une référence non valide en supprimant la pilule rouge et en sélectionnant un remplacement à l'aide de @, ou en renommant la ressource sous-jacente afin que la référence redevienne valide.

Propagation de changement de nom automatique

Lorsqu'un outil, un argument, un contexte, une escalade ou une sortie est renommé dans la définition de l'agent, l'éditeur détecte la modification et met à jour automatiquement chaque pilule qui l'a référencé dans tous les champs d'invite. Les chemins imbriqués sont également réécrits de manière cohérente.

Les changements de nom effectués en dehors de la définition de l'agent, par exemple en modifiant directement JSON brut, ne sont pas détectés.

Modifier et Prévisualiser

La barre d'outils située en haut de l'éditeur inclut un bouton permettant de basculer entre les modes Édition / Aperçu.

• Édition - le mode de modification en direct pour la saisie de texte, l'application de la mise en forme et l'insertion de références.
• Aperçu - un rendu en lecture seule de l'invite avec toutes les pilules et le markdown appliqués. Utilisez l'aperçu pour vérifier l'apparence finale des invites longues ou fortement formatées avant de les enregistrer.

Le passage à l'aperçu préserve le brouillon actuel. Le retour au mode Édition permet de revenir à l'état de modification exact d'avant le changement.

Barre d'outils de formatage

En mode Édition, la barre d'outils expose les actions de formatage suivantes :

Button	Effet	Raccourci clavier
H	Activer/désactiver le titre sur la ligne actuelle	—
B	Mettre en gras le texte sélectionné	—
I	Mettre le texte sélectionné en italique	—
</>	Code en ligne	—
Liste numérotée	Activer/désactiver une liste numérotée	—
Liste à puces	Activer/désactiver une liste à puces	—
Annuler (Undo)	Étape arrière dans les modifications	Ctrl / ⌘ + Z
Rétablir	Étape avant dans les modifications	Ctrl / ⌘ + Maj + Z

Le Markdown appliqué via la barre d'outils est préservé mot pour mot dans l'invite enregistrée et affiché avec le style Markdown complet, y compris les en-têtes, les listes, les blocs de code clôturés, les blocs de citation et les tableaux, en mode Aperçu. La barre d'outils est désactivée lorsque le mode Aperçu est actif.

Faits saillants de la couverture

Lorsque les données de couverture d'invite sont disponibles après l'exécution d'un ensemble d'évaluation, un bouton pour activer le mode Couverture apparaît dans la barre d'outils.

La sélection du mode Couverture bascule l'éditeur en Aperçu avec des surbrillances en ligne indiquant les instructions de l'invite qui ont été appliquées pendant les exécutions d'évaluation. La sélection d'une section en surbrillance ouvre une fenêtre contextuelle avec une liste des exécutions d'évaluation spécifiques qui l'ont couverte. Le bouton ↻ situé à côté du bouton bascule recalcule la couverture lorsque l'invite ou l'ensemble d'évaluation a changé.

Le retour au mode Édition désactive la mise en surbrillance de la couverture.

Examen des suggestions de l'IA

Lorsqu'Autopilot ou un autre assistant d'IA propose de réécrire votre invite, l'éditeur passe en mode différentiel :

• Le contenu supprimé apparaît avec une barre rouge.
• Le contenu ajouté apparaît avec une surbrillance verte.
• L'éditeur est en lecture seule pendant que la comparaison s'affiche.

Deux boutons apparaissent en bas à droite de l'éditeur : Accepter remplace l'invite par la version suggérée et Rejeter ignore la suggestion et restaure l'original. L'invite d'origine est conservée telle quelle jusqu'à ce que l'un de ces boutons soit sélectionné.

Modification en plein écran

L'icône Développer à l'extrémité droite de la barre d'outils ouvre l'éditeur dans une fenêtre modale en plein écran. Cela est utile pour les longues invites où l'espace à l'écran disponible est limité. Les modifications apportées dans le modal sont conservées lorsque le modal est fermé.

Accessibilité

• Chaque bouton de la barre d'outils est accessible au clavier avec Tab et inclut une info-bulle et aria-label.
• Le sélecteur de référence est entièrement basé sur le clavier : l'insertion d'une référence ne nécessite pas de souris.
• Les boutons Édition / Aperçu et Couverture exposent leur état via la sémantique aria-pressed.
• L'éditeur annonce le nom du champ actif aux lecteurs d'écran - par exemple, « Invite système » - via sa configuration ariaLabel.

Questions fréquemment posées

Les invites existantes vont-elles cesser de fonctionner ?

Non. L'éditeur lit et écrit dans le même format qu'auparavant - {{argument}} pour les entrées et @{path} pour les outils, les contextes et les sorties. Les invites existantes s'ouvrent automatiquement en tant que pilules ; aucune étape de migration n'est nécessaire.

Can I still type {{ to insert an argument?

Non. {{ }} n'est plus un déclencheur de création dans l'éditeur. Utilisez plutôt @. Tout {{ ... }} saisi pendant la modification est conservé en tant que texte brut et ne se convertit en une pilule que lorsque l'invite est enregistrée et rouverte, à condition que le nom interne corresponde à un argument existant.

Does the @ trigger conflict with email addresses or social handles?

Non. Le sélecteur s'ouvre uniquement lorsque @ apparaît au début d'une ligne ou directement après un caractère d'espace blanc, de sorte que [e-mail] au milieu d'une phrase est traité comme du texte brut.

Que se passe-t-il si je renomme un argument ou un outil ?

L'éditeur détecte les changements de nom effectués dans la définition de l'agent et met automatiquement à jour chaque référence dans toutes les invites. Une référence ne devient rouge que lorsque la ressource sous-jacente a été supprimée ou que son chemin d'accès a changé d'une manière que l'éditeur ne peut pas déduire.

Puis-je désactiver le nouvel éditeur ?

L'éditeur d'invite est bloqué par un indicateur de fonctionnalité pendant le déploiement. Pour revenir à l'éditeur précédent pendant la période de déploiement, contactez votre représentant UiPath.

Voir également

• Invites - invites système, invites utilisateur et conseils d'écriture d'invites
• Définition des arguments - créez des arguments d'entrée et de sortie et faites-y référence dans les invites