Génération SynthLabs

Aperçu

Utilisez cette skill pour les workflows SynthLabs reproductibles et orientés backend, comme lister les sessions, créer des sessions et appeler les routes de génération à partir d'une instance locale saine. Cette skill documente uniquement les routes HTTP SynthLabs existantes et les conseils de workflow zorai. Ne supposez pas qu'il existe des outils SynthLabs zorai dédiés.

Quand l'utiliser

Utilisez cette skill quand :

la tâche peut rester dans des flux de session ou de génération pilotés par HTTP,
l'opérateur souhaite des étapes de génération de dataset scriptées ou reproductibles,
un backend SynthLabs sain existe déjà,
ou le travail de génération longue durée doit être attaché à une tâche ou un objectif zorai.

N'utilisez pas cette skill quand :

l'opérateur a besoin d'une révision par vérificateur, d'un aperçu des données, d'une inspection des paramètres ou du mode DEEP,
l'entrée des credentials du fournisseur doit se faire dans l'interface SynthLabs,
ou la tâche porte sur le démarrage ou la réparation de l'instance locale SynthLabs plutôt que sur son utilisation.

Règles de Workflow Orienté Backend

Commencez en mode backend-first : listez ou créez des sessions via HTTP avant d'ouvrir le navigateur.
Préférez GET /api/sessions et POST /api/sessions pour la découverte reproductible de sessions et la mise en place de sessions.
Confiez le mode DEEP, la révision par vérificateur, l'aperçu des données et les autres workflows inspectés visuellement à synthlabs-ui-operator.
Utilisez les tâches ou objectifs zorai pour le travail de génération longue durée afin que les tentatives, notes et révisions de suivi restent attachées à l'exécution.

Routage Backend vs Interface

Restez en mode backend pour le listage de sessions, la création de sessions, la génération scriptée et les autres workflows HTTP reproductibles.
Basculez vers synthlabs-ui-operator quand l'opérateur a besoin d'inspecter les prompts, de réviser les lignes générées, d'entrer les credentials du fournisseur, d'utiliser le mode DEEP ou de confirmer la sortie visuellement.
Si un appel de route AI direct nécessiterait d'inventer ou de rétro-concevoir le chiffrement de clé, arrêtez-vous et utilisez la configuration SynthLabs ou l'interface à la place.

Limite des Credentials

Utilisez POST /api/ai/generate ou POST /api/ai/generate/stream uniquement quand vous disposez déjà d'une valeur apiKey chiffrée compatible SynthLabs.
server/utils/keyEncryption.js déchiffre apiKey avec AES-256-CBC en utilisant une clé dérivée de VITE_API_KEY_SALT ou API_KEY_SALT.
Ne postez pas une clé de fournisseur en texte clair directement sur les routes AI.
Si le seul credential disponible est une clé de fournisseur en texte clair, routez la configuration via synthlabs-setup ou l'interface SynthLabs au lieu de deviner le format de chiffrement.

Exemples de Sessions

Listez les sessions récentes à partir d'un backend local sain :

curl -fsS "http://localhost:8787/api/sessions?limit=20"

Créez une session shell minimale avant le travail de génération :

curl -fsS -X POST "http://localhost:8787/api/sessions" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "zorai generation run",
    "source": "zorai"
  }'

Si vous savez que l'instance en cours d'exécution attend des métadonnées de mode, étendez la charge utile avec les champs que le backend stocke, tels que appMode, engineMode, externalModel ou config.

Exemple de Génération

Utilisez une route de génération directe uniquement avec une valeur de clé chiffrée produite par un flux client ou interface SynthLabs compatible :

curl -fsS -X POST "http://localhost:8787/api/ai/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "<encrypted iv:ciphertext value from SynthLabs-compatible flow>",
    "provider": "openai",
    "model": "gpt-4.1-mini",
    "baseUrl": "https://api.openai.com/v1",
    "systemPrompt": "You generate concise synthetic reasoning samples.",
    "userPrompt": "Produce 3 algebra tutoring examples in SYNTH-style JSON.",
    "outputFormat": "json"
  }'

Travail Longue Durée

Pour les grands lots de dataset, mettez en file d'attente le travail dans une tâche ou un objectif zorai au lieu de le traiter comme un seul tour de conversation.
Enregistrez l'URL du backend, l'ID de session, le modèle et si l'exécution est restée backend-only ou a nécessité un handoff vers l'interface.
Utilisez la skill de l'opérateur interface pour la vérification post-exécution, la continuation en mode DEEP ou la révision manuelle des données générées.

Erreurs Courantes

Appeler les routes de génération AI avec une clé de fournisseur en texte clair au lieu d'une valeur apiKey chiffrée compatible SynthLabs.
Ouvrir le navigateur pour la création ou le listage de sessions alors que les routes backend couvrent déjà la tâche.
Traiter le mode DEEP ou la révision par vérificateur comme des workflows backend-only.
Exécuter un grand lot de génération en un seul tour ad hoc au lieu de l'attacher à une tâche ou un objectif zorai.

synthlabs-generation