Choisissez un export — ou enseignez un workflow — selon ce que vous devez réutiliser.
Une conversation lisible, une trace de diagnostic, une sauvegarde des réglages et un workflow réutilisable sont des artefacts différents. Le choix le plus sûr est le plus étroit qui corresponde à votre objectif ; si vous connaissez déjà les étapes, le mode Enseignant peut les apprendre à partir d'une seule démonstration manuelle.
Quel export ou quel workflow dois-je utiliser ?
| Objectif | Commande | Résultat |
|---|---|---|
| Enregistrer la conversation visible dans le panneau latéral | /export | Une transcription Markdown lisible. |
| Déboguer une exécution d'agent enregistrée | /export --traces | Markdown avec réponses du modèle, appels d'outils, arguments et résultats. |
| Sauvegarder ou déplacer les réglages | /export --config | Un instantané JSON webbrain-config/1. |
| Apprendre un workflow en le réalisant une fois | /teach --start <nom> | Un workflow enregistré sans valeurs, compilé à partir de votre démonstration manuelle. |
| Déplacer une automatisation réutilisable | /workflow --export <id> | Une définition JSON webbrain-workflow/1 assainie. |
Un instantané des réglages peut contenir des clés API de fournisseurs, des données de profil, la mémoire utilisateur, des compétences personnalisées et des choix d'autorisation. Conservez-le comme une sauvegarde de mots de passe ; ne le joignez jamais à un issue public.
Markdown des conversations et des traces
/export enregistre les messages actuellement affichés dans le panneau latéral et consigne la version de WebBrain utilisée pour l'export. Ce fichier est destiné à la lecture et ne peut pas être réimporté dans WebBrain.
/export --traces utilise les traces enregistrées localement pour la conversation actuelle. Il peut contenir des prompts, des sorties du modèle, des URL, des arguments d'outils et des résultats d'outils. Les captures d'écran sont omises de ce fichier Markdown. Si le traçage était désactivé pendant un tour, sa trace ne peut pas être reconstituée par la suite.
Commencez par l'export de conversation. N'utilisez l'export de traces que si des détails au niveau des outils sont nécessaires, et vérifiez chaque fichier à la recherche de données personnelles avant de le partager.
Sauvegarder les réglages
- Saisissez
/export --config. - Conservez en lieu sûr le fichier
webbrain-config-….jsontéléchargé. - Restaurez-le avec
/import --file, ou collez son JSON après/import.
L'instantané contient des valeurs de réglages portables, mais pas les conversations, les traces, les tâches planifiées, les compteurs d'utilisation, les dépenses cumulées, ni les sessions Cloud Sync liées à un appareil et les identifiants d'appareil.
Le champ schema identifie la compatibilité. WebBrain exporte et accepte actuellement webbrain-config/1.
Apprenez un workflow à WebBrain en le réalisant une fois
Utilisez le mode Enseignant lorsque vous connaissez les étapes dans le navigateur et souhaitez les enregistrer sans demander d'abord à l'agent d'effectuer une exécution tracée. La démonstration est limitée à l'onglet et se compile dans le même format webbrain-workflow/1 sécurisé que /workflow --save.
- Ouvrez la page de départ. Utilisez une page
http(s)classique et arrêtez toute exécution d'agent qui occupe actuellement cet onglet. - Commencez l'enseignement. Saisissez
/teach --start <nom>; un indicateur WebBrain Teach violet apparaît sur la page. - Exécutez le workflow manuellement. Dans cet onglet, effectuez les clics de confiance, remplissez les champs, cochez ou décochez cases et boutons radio, validez avec Entrée et naviguez exactement comme le flux réutilisable l'exige.
- Vérifiez la progression au besoin. Saisissez
/teachpour voir le nom du workflow actif et le nombre d'actions capturées. - Compilez et enregistrez. Saisissez
/teach --end, puis ouvrez/workflowpour exécuter, renommer, exporter ou supprimer le workflow appris.
Le code de capture de la page enregistre l'identité sémantique d'un champ, jamais son contenu. Chaque champ rempli devient un paramètre d'exécution ; lors d'une exécution ultérieure du workflow, WebBrain redemande la valeur courante en local.
Limites de la capture
- Seules les actions de confiance dans la page de premier niveau sont capturées ; les actions effectuées par WebBrain lui-même sont exclues de l'enregistrement.
- La session suit la navigation dans le même onglet et enregistre au plus 100 actions normalisées.
- Le mode Enseignant et les exécutions automatisées d'agents ne peuvent pas occuper le même onglet simultanément. Terminez avec
/teach --endavant de lancer une tâche d'agent. - Les cibles non prises en charge ou non sûres sont ignorées ; un avertissement s'affiche dans le résultat enregistré, et la relecture exige toujours une correspondance sémantique unique et non ambiguë.
- Même si aucun workflow ne peut être compilé,
/teach --endclôt la session d'enseignement temporaire ; corrigez la page ou la démonstration et recommencez.
Depuis une trace créer, puis déplacer un workflow enregistré
Le mode Enseignant convient aux démonstrations manuelles. Si l'agent a déjà réussi la tâche avec le traçage activé, enregistrez plutôt cette exécution :
- Activez le traçage et terminez la tâche avec succès.
- Enregistrez-la avec
/workflow --save <nom>. - Exécutez
/workflowpour trouver son ID. - Téléchargez-la avec
/workflow --export <id>. - Utilisez
/workflow --import --filedans une autre instance de WebBrain.
Vous devez inspecter ou modifier un fichier de workflow exporté ? Utilisez l'Éditeur de workflows WebBrain directement dans votre navigateur.
Un workflow portable n'est pas la trace ou la session d'enseignement d'origine. WebBrain supprime les anciennes références d'éléments, les sélecteurs CSS, les coordonnées de clic, les chaînes de requête et fragments d'URL, ainsi que les valeurs saisies dans les champs. Les valeurs deviennent des paramètres, collectés à nouveau en local à chaque exécution.
Le fichier conserve les descriptions sémantiques des cibles, l'origine du site et la portée des chemins, afin que WebBrain puisse retrouver l'élément actuel et s'arrêter de façon sûre en cas de correspondance ambiguë. Les autorisations normales du mode Exécution, la confirmation des envois et la vérification des résultats restent en vigueur.
WebBrain attribue un nouvel ID local et de nouveaux horodatages, sans écraser un workflow existant. Les fichiers de workflow portables sont limités à 1 MiB.
Vérifier avant de partager
| Fichier | Vérification minimale |
|---|---|
| Conversation Markdown | Messages et avis système. |
| Markdown des traces ou JSON de la page Traces | Prompts, URL, arguments, résultats et captures d'écran intégrées. |
| JSON des réglages | Ne partagez pas, sauf si vous avez délibérément supprimé tous les secrets et valeurs privées. |
| JSON du workflow | Nom, métadonnées d'origine, origines de sites et portées de chemins, libellés des cibles et intention des étapes. |
Les champs complets et les règles de compatibilité figurent dans la référence technique des formats (en anglais).
