Opérateur UI SynthLabs

Présentation

Utilise cette compétence quand SynthLabs est mieux opéré en tant qu'application plutôt que par une route backend. Suppose que synthlabs-setup a déjà confirmé une instance saine avant de commencer. Cette compétence ne fournit pas d'outils SynthLabs dédiés à zorai ; elle mappe le travail sur le workflow browser existant de zorai.

Quand l'utiliser

Utilise cette compétence quand :

• la tâche nécessite une revue par vérificateur, une approbation manuelle ou une inspection au niveau des lignes,
• l'opérateur a besoin d'un aperçu des données ou d'une confirmation visible de l'état du dataset,
• les modifications de paramètres ou l'inspection de paramètres doivent se faire dans l'app,
• le mode DEEP fait partie du workflow demandé,
• ou l'opérateur demande explicitement une opération pilotée par le browser plutôt qu'une automatisation backend.

N'utilise pas cette compétence quand :

• la tâche est la découverte de session, la création de session, ou la génération répétable qui s'adapte aux routes backend,
• la tâche est autoscore, rewrite, remove-items, migrate-reasoning, ou job polling,
• ou l'instance SynthLabs locale doit encore être démarrée ou réparée.

Règles de l'agent

• Utilise les outils browser uniquement après que synthlabs-setup ait confirmé que SynthLabs est sain.
• Privilégie la navigation UI pour la revue par vérificateur, l'aperçu des données, les modifications de paramètres et le mode DEEP.
• Suis le workflow browser dans skills/operating/browser.md : commence par ouvrir un pane browser, lis le DOM avant d'interagir, utilise la découverte d'éléments au lieu de deviner les sélecteurs, privilégie les clics basés sur le texte quand c'est possible, et relis le DOM après la navigation.
• Utilise les outils browser existants comme open_canvas_browser, browser_read_dom, browser_get_elements, browser_click et browser_type ; ne suppose pas que des outils SynthLabs spécifiques à zorai existent.
• N'utilise pas le browser juste pour confirmer des données ou déclencher un travail que des routes backend stables couvrent déjà.
• Confie le travail de CRUD de session et la génération répétable à synthlabs-generation.
• Confie autoscore, rewrite, remove-items, migrate-reasoning, orphan checks et job polling à synthlabs-curation.

Workflow piloté par le browser

1. Confirme l'URL SynthLabs auprès de l'opérateur ou auprès de l'instance locale saine déjà validée par synthlabs-setup.
2. Ouvre l'app dans un pane browser et lis la page avant de cliquer sur quoi que ce soit.
3. Découvre les contrôles pertinents pour la surface cible : Verifier, Data Preview, Settings, Generator/Engine, ou mode DEEP.
4. Capture l'état visible que tu examines ou modifies pour que le travail suivant puisse reprendre à partir de la bonne session ou du bon écran.
5. Si la tâche devient répétable via /api/sessions, /api/ai/generate, ou /api/jobs, arrête d'utiliser le browser et bascule vers la compétence axée sur le backend qui possède cette route.

Surfaces visuelles possédées

Écrans Generator et Engine

• inspecte la configuration visible de la session,
• vérifie les champs de prompt et les options de génération avant une exécution,
• confirme quel mode ou écran l'opérateur utilise,
• et capture tout état visuel qui devrait être restitué au travail de génération backend plus tard.

Revue par vérificateur

• inspecte les lignes,
• compare les sorties,
• approuve ou rejette les entrées,
• et enregistre les problèmes quand le jugement de qualité dépend d'une revue visuelle.

Aperçu des données

• parcours les tableaux,
• inspecte les détails des lignes,
• confirme le sens des colonnes,
• et valide visuellement le contenu importé ou généré.

Modifications de paramètres

• mets à jour les paramètres des fournisseurs,
• inspecte le mode DB ou les paramètres de stockage,
• ajuste les options de workflow visibles,
• et confirme qu'une modification de paramètre a pris effet dans l'app.

Mode DEEP et autres workflows visuels

• navigue le mode DEEP quand l'opérateur a besoin de l'état visible et des étapes intermédiaires,
• inspecte les contrôles ou panneaux spécifiques au mode,
• et garde les flux visuellement complexes dans le browser jusqu'à ce qu'ils puissent être confiés à un chemin répétable par backend.
• capture assez d'état visuel pour confier le travail à synthlabs-generation ou synthlabs-curation quand la phase exclusivement UI est terminée.

Règles de transmission

• Si la tâche peut s'exprimer comme GET /api/sessions, POST /api/sessions, ou POST /api/ai/generate, bascule vers synthlabs-generation.
• Si la tâche peut s'exprimer comme GET /api/jobs, GET /api/jobs/:id, ou une route curation /api/jobs/*, bascule vers synthlabs-curation.
• Reste dans cette compétence uniquement tant que l'UI est la véritable surface de contrôle.

Erreurs courantes

• Ouvrir le browser juste pour confirmer des données déjà exposées par /api/sessions ou /api/jobs.
• Répéter les instructions de configuration ici au lieu de nécessiter d'abord synthlabs-setup.
• Traiter le mode DEEP comme une route backend promise quand la tâche est explicitement visuelle.
• Brouiller la limite entre la revue manuelle par vérificateur et la génération ou curation backend répétable.