Exemple pédagogique fictif et original. Aucun résultat du modèle n’est prérempli.
Un point de départ modifiable
- 1 · Texte à vérifier
- Objectif : inscrire Dana Lee (dana.lee@example.com) à la conférence. Page actuelle : « Inscription – Étape 2 sur 2 » Éléments visibles : - Champ de texte « Nom complet » : Dana Lee - Champ de texte « E-mail » : vide, marqué comme obligatoire - Case à cocher « J’accepte le code de conduite » : cochée - Bouton « Envoyer l’inscription » : actif - Bandeau : « Votre session expire dans 10 minutes. »
- 2 · Votre question
- Quelle étape unique l’agent doit-il effectuer ensuite pour atteindre l’objectif ?
- 3 · Définissez 2 à 6 options
- Compléter un élément obligatoire
Un champ ou une case obligatoire est encore vide, et l’objectif contient déjà la valeur.
- Appuyer sur le bouton d’envoi
Tous les éléments obligatoires sont complétés et la page est prête à être envoyée.
- Attendre et relire la page
La page est encore en cours de chargement ou de modification ; son état n’est donc pas encore fiable.
- Demander à une personne
Une information manque, ou l’étape a des conséquences que l’agent n’a pas le droit d’assumer.
- Compléter un élément obligatoire
Ce sont des probabilités du modèle, pas une précision mesurée ni une garantie. Oui et Non correspondent à vos règles ; les options sont comparées uniquement parmi celles que vous avez fournies.
Jev peut-il piloter un agent de navigation ?
Pas à lui seul. Jev ne clique pas, ne saisit rien et ne lit aucun écran. Il répond à des questions typées sur l’état que vous lui envoyez. Dans un agent de navigation, cela le destine à une tâche étroite : à partir d’une description textuelle de la page actuelle et d’un objectif, choisir la prochaine étape dans une courte liste que votre code sait déjà exécuter.
Le guide de construction de TypeSafe décrit la même répartition des rôles : le code garde le contrôle et le modèle reçoit des décisions étroites et structurées. La boucle de l’agent, le lecteur de page, le clic et la nouvelle tentative restent du logiciel ordinaire.
Ouvrir le modèle modifiable de prochaine étape. Il contient une page d’inscription fictive, une question et quatre options. Son chargement crée un brouillon ; seule votre demande lance une vérification.
Décrire la page comme un état, pas comme une capture d’écran
Le modèle envoie du texte brut : l’objectif, le titre de la page et les éléments visibles avec leurs valeurs actuelles. C’est votre lecteur de page qui décide quoi inclure. Écartez tout ce dont la décision n’a pas besoin, et n’envoyez jamais de mots de passe, de données de paiement ni de données personnelles d’autres personnes à une démo publique.
| Option | Quand elle doit l’emporter |
|---|---|
| Compléter un élément obligatoire | Un champ ou une case obligatoire est vide, et l’objectif contient déjà la valeur. |
| Appuyer sur le bouton d’envoi | Tous les éléments obligatoires sont complétés. |
| Attendre et relire la page | La page est encore en cours de chargement ou de modification. |
| Demander à une personne | Une information manque, ou l’étape a des conséquences que l’agent n’a pas le droit d’assumer. |
Chaque option correspond à une fonction de votre agent. Jev choisit la fonction ; votre code fournit les arguments qu’il peut vérifier, par exemple le champ qui est vide. Le cookbook de TypeSafe sur l’appel de fonctions adopte la même approche : les choix dans un ensemble fermé deviennent des questions, tandis que le texte libre, les nombres et les dates restent du ressort de votre code.
Modifier un seul élément, puis comparer
- Lancez une vérification avec le modèle tel quel, puis notez l’étape sélectionnée et les autres probabilités.
- Renseignez l’e-mail dans la description de la page et relancez la vérification. Décidez à l’avance de l’étape que vous attendez.
- Retirez l’adresse e-mail de l’objectif en laissant le champ vide. L’agent ne dispose plus de la valeur : une conception prudente devrait alors préférer demander à une personne.
Aucune réponse attendue n’est préremplie, et une seule exécution n’est pas une mesure. Si deux options restent en concurrence, réécrivez leurs descriptions jusqu’à ce qu’une personne puisse les appliquer sans deviner ; consultez Gérer les catégories qui se chevauchent.
Laisser les enjeux fixer le seuil
Le schéma de routage conditionné par la confiance de TypeSafe utilise la confiance comme second signal : la réponse dit quoi faire, la confiance dit s’il faut agir. Son exemple accepte une action à faible risque avec une confiance modeste et en exige une bien plus élevée avant d’approuver un virement. Appliquez la même idée ici. Relire une page coûte peu ; envoyer un formulaire, payer ou supprimer, non. Choisissez vos propres seuils à partir d’exemples étiquetés, et lisez d’abord Distinguer probabilité et confiance.
Ce que la communauté a essayé
La galerie Projets renvoie vers un prototype communautaire d’agent de navigation qui confie l’étape de décision à Jev. Les gains de vitesse annoncés sont ceux de l’auteur et résultent de plusieurs changements simultanés ; ils n’isolent donc pas l’effet de Jev. Considérez ces comptes rendus comme des idées à tester, puis constituez un petit ensemble d’états de page issus de votre propre produit et vérifiez chaque étape à la main avant qu’un agent n’agisse sur de vrais comptes.
Sources et lectures complémentaires
Ce guide s’appuie sur la documentation officielle et les témoignages de la communauté liés. Les observations de la communauté sont attribuées à leurs auteurs.
- TypeSafe: Comment construire avec TypeSafe
- TypeSafe: Cookbook sur l’appel de fonctions
- TypeSafe: Routage conditionné par la confiance