Guide complet de Sector

Sector est une plateforme d'orchestration visuelle d'IA. Vous chaînez des blocs qui transforment une entrée en sortie : appels LLM, recherche web, scraping, conditions, parallélisme, code custom.

Sector fonctionne en deux modes complémentaires :

• Mode local (instantané) — vous prototypez dans le builder, le workflow s'exécute dans votre navigateur. Idéal pour itérer rapidement, sans compte.
• Mode Cloud (production) — vous sauvegardez le workflow sur nos serveurs, il s'exécute côté serveur, peut être planifié en cron et utiliser des secrets chiffrés. Continue de tourner même si votre navigateur est fermé. Nécessite un compte (gratuit).

Pages principales :

• / — accueil et templates
• /builder — atelier de construction
• /login — connexion (email + Google)
• /app — vos workflows sauvegardés
• /app/runs — historique des exécutions serveur
• /app/vault — coffre-fort de secrets
• /s/<slug> — vue publique d'un workflow partagé
• /guide — cette page

L'écran se découpe en cinq zones :

1. Toolbar — Run, Stop, Save, Partager, ☁ Cloud, Undo/Redo, auto-trigger, import/export JSON.
2. Palette — tous les blocs disponibles, ajoutables au workflow.
3. Canvas — la chaîne de nœuds avec leur statut (idle, running, success, error), leur sortie et leurs logs.
4. Inspector — configuration du nœud sélectionné : prompt, modèle, retries, conditions…
5. Panneaux latéraux — Variables globales, Historique, Stats (coût, latence).

Sector propose plus de 25 blocs, regroupés en familles.

Déclencheurs & entrée

Intelligence Artificielle

Web & contenu

Logique & données

Sortie & interaction

Dans n'importe quel champ d'un bloc, vous pouvez référencer :

• {{input}} — sortie du nœud précédent
• {{trigger}} — entrée initiale du workflow
• {{outputs.NodeId}} — sortie d'un nœud spécifique
• {{var.NOM}} — variable globale persistante (publique)
• {{item}} — élément courant dans un bloc Map
• {{secret.NOM}} — secret chiffré du Vault, résolu uniquement côté serveur

Variables vs Secrets. Les variables sont stockées avec le workflow (visibles si vous partagez le JSON). Les secrets vivent dans le Vault, ne sont jamais envoyés au navigateur, et seul leur nom apparaît dans le workflow. Voir la section Vault.

Le mode local est l'expérience par défaut : tout tourne dans votre onglet.

• Run / Stop — exécution complète avec interruption propre via AbortController.
• Run from here — relance à partir d'un nœud précis en réutilisant le contexte de la dernière exécution.
• Retries (0-5) — par nœud, en cas d'échec.
• Continue on error — empêche un échec de casser tout le workflow.
• Auto-trigger local — boucle navigateur toutes les 10s à 5min, tant que l'onglet reste ouvert.
• URL hash auto-run — un workflow se lance via #run=....

⚠️ Limites du mode local : si votre onglet ferme ou s'endort, le workflow s'arrête. Pour des automatisations fiables, passez en mode Cloud.

Bouton ☁ Cloud dans la toolbar du builder. Ouvre un panneau qui expose toutes les actions serveur du workflow actif.

• Sauvegarder — enregistre le workflow dans votre compte (table chiffrée RLS).
• Exécuter sur le serveur — le workflow tourne côté backend, indépendamment de votre navigateur. Sortie renvoyée et stockée dans Runs.
• Partager (lien court) — génère /s/abc123 à diffuser.
• Activer une planification — exécution cron (voir section 8).

Garde-fous d'exécution serveur : timeout global de 8 minutes, blocs Map plafonnés à 1000 éléments avec concurrence ≤ 50, HTTP plafonné à 50 000 caractères, scraping avec User-Agent réaliste et extraction d'article/main, retries par nœud, et bloc Code exécuté dans une sandbox sans accès à fetch, process, require ou aux globaux du runtime.

Calcul quantitatif. Le bloc Codeet le nœud Reduce exposent un objet quant avec :sum, mean, median, min, max, variance, stddev, returns, sharpe, maxDrawdown, var, cvar, correlation, zscore, percentile, toNums. Vous pouvez ainsi calculer ratio de Sharpe, Max Drawdown, VaR 95% ou CVaR sur une série de prix directement dans un workflow planifié.

Page /app/vault. Vos secrets (clés API tierces, tokens) sont chiffrés en AES-GCM côté serveur avant d'être stockés. La valeur n'est jamais renvoyée au navigateur — seul son nom est listable.

1. Allez dans /app/vault, ajoutez un secret au format MAJUSCULES_SOULIGNES.
2. Dans n'importe quel bloc (HTTP header, prompt, code), utilisez {{secret.MON_API_KEY}}.
3. L'interpolation a lieu uniquement quand le workflow s'exécute en mode Cloud — jamais côté client.

⚠️ En mode local, les {{secret.X}} ne sont pas résolus (le navigateur n'y a pas accès). Utilisez le mode Cloud pour tout workflow qui consomme des secrets.

Depuis le panneau ☁ Cloud, choisissez une fréquence (toutes les minutes, 5min, 15min, heure, jour) et cliquez Activer. Le workflow est sauvegardé puis ajouté à la file de planification.

Notre serveur cron tourne toutes les minuteset déclenche les workflows dont la prochaine échéance est passée. Chaque exécution crée une ligne dans Runs avec son statut, sa durée, ses logs et sa sortie.

✅ Continue de tourner navigateur fermé.
✅ Une planification par workflow (réactiver écrase l'ancienne fréquence).
⏸️ Désactivez depuis /app → section « Planifications actives ».

Deux modes de partage coexistent :

• Share URL (local) — bouton « Partager » encode tout le workflow en Base64 dans l'URL. Aucun compte requis, mais limite ~2KB et JSON visible.
• Lien court (Cloud) — depuis ☁ Cloud, génère /s/abc123. Tient pour des workflows volumineux. Les variables sont automatiquement strippées (les secrets ne sont jamais inclus). Le destinataire voit un aperçu JSON et peut « Ouvrir dans le builder » d'un clic.

Une fois connecté, l'en-tête expose trois onglets :

• Workflows (/app) — liste de vos workflows sauvegardés, avec actions Ouvrir / Supprimer, et la liste des planifications actives.
• Runs (/app/runs) — 50 dernières exécutions (manuelles + planifiées), statut, durée, sortie, erreur. Auto-refresh toutes les 5s.
• Vault (/app/vault) — gestion des secrets chiffrés.

• Logs live (mode local) — affichage en temps réel par nœud dans le builder.
• Historique local — 50 dernières exécutions navigateur avec inputs/outputs.
• Runs serveur — historique persistant avec statut, durée et sortie pour chaque exécution Cloud (manuelle ou planifiée).
• Stats builder — nombre d'appels, latence moyenne, estimation de coût.

1. Ajoutez un Trigger et tapez votre entrée (ex. un sujet d'article).
2. Branchez une IA Streaming avec {{input}} dans le prompt.
3. Ajoutez une Condition : si la sortie contient un mot-clé, route vers Translate, sinon vers Summarize.
4. Pour appeler une API tierce, ajoutez un HTTP avec un header Authorization: Bearer {{secret.MON_TOKEN}}.
5. Testez en local (Run). Quand c'est satisfaisant, cliquez ☁ Cloud → Sauvegarder.
6. Cliquez Exécuter sur le serveur pour valider en conditions réelles.
7. Activez une planification (ex. toutes les heures). C'est en production.
8. Suivez les exécutions dans /app/runs.

• Isolation par utilisateur — Row-Level Security sur toutes les tables : workflows, runs, schedules, secrets. Personne d'autre ne voit vos données.
• Secrets chiffrés — AES-GCM avec clé serveur. Jamais transmis au client.
• Garde-fous d'exécution — timeout 8min, Map ≤ 1000 / concurrence ≤ 50, retries par nœud.
• Bloc Code (JS) sandboxé côté serveur — exécuté sans accès à fetch, process, require, setTimeout ni aux globaux du runtime. Seuls JSON, Math, Date, les types de base et l'objet quant sont exposés.
• Partage Cloud — les variables/secrets sont strippés du snapshot partagé.