Skip to content
Thomas Leberre edited this page Aug 20, 2026 · 3 revisions

FAQ — Questions fréquentes


🎯 Général

Qu'est-ce que WorkPilot AI, en une phrase ?

Un framework autonome multi-agents qui planifie, code et valide des logiciels à votre place, à partir d'une description en langage naturel.

Quelle différence avec Copilot ou Cursor ?

Copilot et Cursor vous assistent pendant que vous codez (autocomplétion, chat). WorkPilot AI exécute des tâches complètes de bout en bout : il planifie, code, teste, valide, corrige si besoin, puis vous propose une fusion. Vous restez dans la boucle via deux points de contrôle : l'approbation de la spec et la fusion.

Est-ce gratuit ?

WorkPilot AI est open source sous AGPL-3.0 — gratuit à utiliser. Les coûts IA (appels Claude, OpenAI…) sont à votre charge et dépendent de votre abonnement / usage de clés API.

Puis-je l'utiliser en entreprise ?

Oui, sous réserve de respecter l'AGPL-3.0 :

  • Usage interne : aucune obligation supplémentaire
  • Redistribution modifiée ou SaaS exposé : votre code modifié doit aussi être AGPL-3.0

Une licence commerciale closed-source est disponible — contactez l'équipe.


💰 Coût et modèles IA

Combien ça coûte de faire tourner WorkPilot AI ?

Cela dépend entièrement du fournisseur IA, du modèle choisi, et de la taille de vos tâches. À titre indicatif :

  • Tâche SIMPLE avec Claude Haiku : quelques centimes
  • Tâche STANDARD avec Claude Sonnet : 0,10 à 1 €
  • Tâche COMPLEX avec Claude Opus : 1 à 10 € ou plus

Utilisez le Cost Estimator avant de lancer, et surveillez le Analytics Dashboard après.

Puis-je utiliser mon abonnement Claude / ChatGPT ?

Oui. WorkPilot AI supporte OAuth pour Claude et OpenAI — pas besoin d'API key payante si vous avez déjà un abonnement actif.

Quel modèle choisir pour quel usage ?

Stratégie recommandée :

Tâche Modèle
Spec creation Sonnet
Planning complexe Opus
Coding Sonnet
QA Review simple Haiku ou Sonnet
QA Fix Sonnet

Utilisez Arena Mode pour comparer et affiner.

Peut-on tourner 100 % hors-ligne ?

Oui, avec Ollama (modèles locaux) + embeddings Graphiti locaux. La qualité sera inférieure aux modèles cloud de pointe mais l'option existe pour la confidentialité max.


🔐 Sécurité et confidentialité

Mon code est-il envoyé à Anthropic / OpenAI ?

Oui, les fichiers utilisés dans le contexte d'une tâche sont envoyés au fournisseur IA. C'est comment les LLM fonctionnent.

Pour limiter :

  • Le filtrage redacte automatiquement les secrets détectés
  • .env, .git, node_modules/ sont exclus par défaut
  • Vous pouvez désactiver l'envoi de fichiers spécifiques via .workpilotignore

Comment sont stockés mes credentials ?

Jamais en clair. Toujours dans le trousseau OS natif :

  • macOS : Keychain
  • Windows : Credential Manager
  • Linux : libsecret / kwallet

L'IA peut-elle exécuter rm -rf sur ma machine ?

Non. L'allowlist dynamique bloque systématiquement les commandes destructrices, et toutes les opérations filesystem sont confinées au répertoire projet.

Que se passe-t-il si un agent « déraille » ?

  • Les changements sont dans un worktree isolé (main intacte)
  • Vous pouvez abort à tout moment
  • Un Discard supprime tout sans toucher à main
  • Les 50 itérations max de QA empêchent les boucles infinies
  • Le budget de tokens est plafonné (Paramètres → Sécurité → Budget max)

🧠 Modèles et qualité

L'IA fait des erreurs. Comment je me protège ?

Plusieurs garde-fous :

  • Spec Review : vous approuvez avant exécution
  • Human Review : vous inspectez le diff avant fusion
  • Worktree isolé : main inchangée tant que non fusionnée
  • QA automatique : critères d'acceptation validés par un agent indépendant
  • AI Review : 2e agent critique le diff
  • Tests obligatoires (via critères d'acceptation)

Pourquoi ma tâche échoue toujours au QA ?

Les causes les plus fréquentes :

  1. Critères d'acceptation flous — réécrivez-les mesurables
  2. Tests flaky existants qui ne passent pas toujours
  3. Contexte incomplet — l'agent n'a pas vu un fichier pertinent
  4. Conflit entre critères — deux exigences incompatibles

Consultez Agent Replay pour voir exactement où ça coince.

Les agents peuvent-ils se tromper silencieusement ?

Théoriquement oui. C'est pour ça que :

  • Les critères d'acceptation sont vérifiés par un agent indépendant (QA Reviewer)
  • Un Workflow Logger trace tout
  • Vous reviewez le diff avant fusion
  • L'AI Review offre un 2e regard IA

Conseil : ne fusionnez jamais à l'aveugle une tâche dont vous ne comprenez pas le diff.


🏗 Utilisation

Puis-je utiliser WorkPilot AI sur n'importe quel projet ?

Le projet doit être un dépôt Git initialisé. Les frameworks suivants sont détectés automatiquement (liste non exhaustive) : React, Vue, Angular, Svelte, Django, Flask, FastAPI, Express, NestJS, Next.js, Nuxt, Rust/Cargo, Go, Java/Maven, Java/Gradle.

Pour les stacks non détectées, vous pouvez configurer manuellement les commandes de build et test dans Paramètres → Projet.

Puis-je travailler sur plusieurs projets en même temps ?

Oui. Chaque projet a son propre contexte, mémoire, paramètres. Basculez entre projets via la liste en haut à gauche.

Peut-on exécuter des tâches en parallèle ?

Oui — jusqu'à 12 agents simultanés (configurable). Chaque tâche = un worktree isolé, pas d'interférence.

Mon IDE est VS Code / JetBrains. Comment j'intègre ?

WorkPilot AI est une application standalone. Travaillez en parallèle :

  • VS Code pour écrire vous-même
  • WorkPilot AI pour déléguer des tâches à des agents

Une intégration IDE est dans la roadmap.

Puis-je exécuter WorkPilot AI sur un serveur sans écran ?

Oui, utilisez la CLI : voir Utilisation CLI. C'est aussi l'approche recommandée pour CI/CD.


🧪 Développement et contribution

Je veux contribuer. Par où commencer ?

  • Lisez Contribuer
  • Parcourez les issues labellisées good first issue
  • Rejoignez le Discord

Puis-je ajouter un nouveau fournisseur IA ?

Oui — le code est modulaire. Voir apps/backend/integrations/ et le code de Claude/OpenAI comme référence. Ouvrez une issue pour discuter avant de coder.

Comment ajouter un nouvel agent spécialisé ?

  1. Créez un prompt dans apps/backend/prompts/<nom>.md
  2. Créez une invocation via create_client(agent_type="<nom>")
  3. Ajoutez l'entrée UI (bouton, palette) — côté frontend
  4. Ajoutez les traductions i18n

📦 Releases et mises à jour

Les mises à jour sont-elles automatiques ?

Oui, sur desktop — WorkPilot AI vérifie périodiquement et propose la mise à jour en bannière. Vous pouvez désactiver dans Paramètres → Avancé → Auto-update.

Release stable vs beta ?

  • Stable : recommandé pour tous
  • Beta : fonctionnalités en avant-première, potentiellement instable

Changez dans Paramètres → Avancé → Channel.

Comment vérifier l'intégrité d'un téléchargement ?

Chaque release inclut des SHA256 et un scan VirusTotal publié en commentaire de release. Voir Sécurité.


🧭 Mémoire et context

Graphiti prend beaucoup de place ?

Non, quelques MB par projet en général. La compaction périodique (--compact) maintient la taille.

Puis-je désactiver la mémoire ?

Oui : GRAPHITI_ENABLED=false ou Paramètres → Mémoire → Désactiver. Chaque tâche partira alors de zéro.

Les mémoires sont-elles partagées entre projets ?

Non, chaque projet a son propre graphe. C'est voulu : les conventions du projet A ne doivent pas polluer le projet B.


🌍 Internationalisation

WorkPilot AI existe en quelles langues ?

Français et Anglais officiellement. D'autres langues peuvent être ajoutées par contribution — voir Contribuer.

Comment changer la langue ?

Paramètres → Langue — bascule instantanée.

L'IA répond-elle en français ?

Oui, si la langue de l'interface est en français ET si le projet le permet (les commentaires de code restent souvent en anglais selon les conventions projet). Vous pouvez aussi préciser dans la spec : « les messages d'erreur doivent être en français ».


🆘 Problèmes non listés ?

Clone this wiki locally