Integrations.fr

Intégrations

WorkPilot AI se connecte à vos outils habituels pour importer des issues, créer des PRs, notifier votre équipe, et étendre les capacités des agents.

---

🐙 GitHub

L'intégration GitHub est la plus riche. Configurez-la dans Paramètres → Intégrations → GitHub.

Capacités

Fonction	Description
Importer les issues	Récupère les issues ouvertes, filtres par label/assignee/milestone
AI Investigation	Un agent enquête sur une issue et propose une spec ou un fix
PR Review	Passage d'une PR par l'agent pr_reviewer avec commentaires détaillés
Batch Review Wizard	Revue en masse de plusieurs PRs en parallèle
PR auto-création	À la fin d'une tâche, crée la PR avec titre, description, checklist
Auto-triage	Tri automatique des issues entrantes avec labels et priorité
Duplicate detection	Détecte les issues doublons via similarité sémantique

Authentification

• OAuth GitHub (recommandé) — via l'interface
• Personal Access Token — scopes nécessaires : repo, workflow, read:org

Templates de PR

L'agent pr_template_filler complète automatiquement vos templates .github/PULL_REQUEST_TEMPLATE.md.

---

🦊 GitLab

Support complet de GitLab.com et GitLab self-hosted.

Fonction	Description
Issues	Import et synchronisation, catégorisation IA par sévérité
Merge Requests	Revue et commentaires IA
Pipelines	Lecture des logs, Self-Healing sur échec

Configuration

# .env-files/.env
GITLAB_TOKEN=glpat_xxxxx
GITLAB_INSTANCE_URL=https://gitlab.example.com   # optionnel, défaut gitlab.com

---

🔷 Azure DevOps

Intégration pour les Work Items et Pull Requests Azure.

• Import des work items avec filtres (Epic, Feature, User Story, Bug)
• Synchronisation bidirectionnelle du statut
• Création automatique de PR vers les branches de feature
• Opérations en batch sur plusieurs work items

---

📐 Linear

Import en masse des tickets Linear avec filtres :

• Par équipe
• Par projet
• Par état (Backlog, Todo, In Progress…)
• Par priorité
• Par assignee

# .env-files/.env
LINEAR_API_KEY=lin_api_xxxxx

Chaque ticket importé devient une tâche du Kanban avec lien bidirectionnel.

---

🎫 Jira

Gestion des issues Jira Cloud et Jira Server/Data Center :

• Import avec JQL custom
• Mise à jour du statut lors du changement de colonne Kanban
• Ajout de commentaires sur ticket depuis WorkPilot AI
• Liaison automatique PR ↔ ticket Jira

---

💬 Microsoft Teams

Notifications via Incoming Webhook :

• Fin de tâche
• Création de PR
• Alerte de rate limit
• Incident détecté

Configurez l'URL du webhook dans Paramètres → Intégrations → Teams.

---

🪟 Windsurf

WorkPilot AI intègre le moteur Windsurf via le protocole Connect. Utilisations :

• Déléguer certaines tâches à Windsurf Cascade
• Utiliser les fonctionnalités spécifiques de Windsurf (model swap, etc.)

⚠️ Notes techniques importantes

• Connect protocol, pas gRPC brut (application/connect+proto streaming, application/proto unary)
• Les tokens CSRF depuis state.vscdb sont souvent obsolètes — lire depuis l'environnement du process via psutil
• Les messages chat ont une imbrication 3 niveaux : intent(f5) → IntentGeneric(f1) → text(f1)
• Les noms de modèles nécessitent le préfixe MODEL_ : ex MODEL_CLAUDE_4_SONNET
• Flux complet Cascade : StartCascade → SendUserCascadeMessage → StreamCascadeReactiveUpdates

Voir les détails techniques dans le code apps/backend/integrations/windsurf_proxy/.

---

🔌 MCP (Model Context Protocol)

WorkPilot AI inclut une marketplace MCP pour étendre les capacités des agents avec des outils externes.

MCPs pré-intégrés

MCP	Utilité
Chrome DevTools MCP	29 outils navigateur (navigation, clic, capture, réseau, émulation)
Electron MCP	Permet aux agents QA d'interagir avec l'app Electron (take_screenshot, click_by_text, fill_input, get_page_structure, send_keyboard_shortcut, eval)
grepai	Recherche sémantique de code avec embeddings vectoriels
Marketplace publique	Dizaines de MCPs communautaires installables en un clic

Activer Chrome DevTools MCP

Via l'UI : Paramètres du projet → Agent Tools → MCP Servers → toggle « Chrome DevTools »

Via env :

CHROME_DEVTOOLS_MCP_ENABLED=true
CHROME_DEVTOOLS_PORT=9222   # optionnel — pour réutiliser une Chrome existante

Créer un MCP custom

WorkPilot AI permet de définir et héberger ses propres MCPs avec authentification locale. Voir la documentation MCP officielle et utiliser le template fourni dans la marketplace.

---

🔎 grepai (recherche sémantique)

grepai est un moteur de recherche de code sémantique local, utilisé par les agents Insights et Coder.

Setup

cd src/connectors/grepai
python test_grepai.py   # test l'intégration

Usage dans les agents

from src.connectors.grepai.client import GrepaiClient

client = GrepaiClient("http://localhost:9000")
results = client.search("user authentication flow", top_k=5)

Features

• Recherche en langage naturel (« où est gérée la session utilisateur ? »)
• Embeddings vectoriels pour la similarité sémantique
• Traçage d'appels via grepai trace
• Sortie JSON pour agents
• Fallback sur grep classique si indisponible

Diagnostic

curl http://localhost:9000/health
# Démarrer si besoin
python src/connectors/grepai/grepai_launcher.py

---

📊 Observabilité externe

Pour le Self-Healing en production, WorkPilot AI se connecte à :

Fournisseur	Rôle
Sentry	Crashes et erreurs
Datadog	APM, logs, métriques
PagerDuty	Alertes d'astreinte
Prometheus / Grafana	Observabilité custom

L'agent incident_proactive_analyzer lit ces sources, propose et applique des fixes automatiques.

---

🧩 Récapitulatif des intégrations

Catégorie	Outils
Code hosting	GitHub, GitLab, Azure DevOps
Ticketing	Linear, Jira, Azure Boards
Chat	Microsoft Teams (Slack via MCP custom possible)
IDEs	Windsurf, bientôt VS Code et JetBrains
Observabilité	Sentry, Datadog, PagerDuty
Outils agent	Chrome DevTools MCP, Electron MCP, grepai, MCP Marketplace

---

Prochaine étape

➡️ Fournisseurs IA — Claude, OpenAI, Gemini, Grok, Ollama…