AI Providers.fr

Fournisseurs IA

WorkPilot AI est multi-fournisseurs : vous pouvez utiliser Claude, OpenAI, Google Gemini, Grok, Ollama (local), Azure OpenAI, GitHub Copilot, ou n'importe quel endpoint compatible OpenAI. Vous pouvez aussi enregistrer plusieurs profils par fournisseur.

---

🎯 Fournisseurs supportés

Fournisseur	Authentification	Variable d'environnement
Anthropic Claude	OAuth / API Key	ANTHROPIC_API_KEY
OpenAI	OAuth / API Key	OPENAI_API_KEY
Google Gemini	API Key	GOOGLE_API_KEY
Grok / xAI	API Key	XAI_API_KEY
Ollama (local)	Endpoint	OLLAMA_BASE_URL
Azure OpenAI	API Key + Endpoint	AZURE_OPENAI_*
GitHub Copilot	OAuth	via UI
OpenAI-compatible custom	API Key	via UI

---

🔑 Méthodes d'authentification

OAuth (abonnement — recommandé)

Pour Claude, OpenAI et Copilot, si vous avez un abonnement, vous pouvez vous authentifier via OAuth :

Claude

claude
# Tapez : /login
# Le navigateur s'ouvre et vous validez

Le token est stocké dans le trousseau OS (Keychain macOS / Credential Manager Windows / libsecret Linux).

Ou via le CLI

claude setup-token
# Copiez le token et ajoutez-le dans .env-files/.env
# CLAUDE_CODE_OAUTH_TOKEN=...

API Keys

Pour les fournisseurs sans OAuth (ou si vous préférez) :

# .env-files/.env
ANTHROPIC_API_KEY=sk-ant-xxx
OPENAI_API_KEY=sk-xxx
GOOGLE_API_KEY=xxx
XAI_API_KEY=xxx
OLLAMA_BASE_URL=http://localhost:11434
AZURE_OPENAI_API_KEY=xxx
AZURE_OPENAI_ENDPOINT=https://xxx.openai.azure.com

---

👥 Multi-profils & bascule automatique

C'est une des fonctionnalités les plus appréciées : enregistrer plusieurs profils (même fournisseur ou fournisseurs différents) et laisser WorkPilot AI basculer automatiquement quand un compte atteint son rate limit.

Créer plusieurs profils

1. Paramètres → Fournisseurs IA → Ajouter un profil
2. Nommez le profil (ex : « Claude perso », « Claude équipe », « OpenAI fallback »)
3. Ajoutez autant de profils que nécessaire

Comment la bascule fonctionne

profile-scorer.ts évalue chaque profil selon :

• Disponibilité (pas en cooldown rate limit)
• Usage récent (équilibrage de charge)
• Modèle compatible avec la tâche
• Coût estimé

Quand un profil atteint son rate limit, il est marqué en cooldown et le scoreur choisit automatiquement le suivant — le tout sans interruption de la tâche en cours.

Stockage sécurisé

• macOS : Keychain
• Windows : Credential Manager
• Linux : libsecret / kwallet
• Les tokens OAuth sont automatiquement rafraîchis par token-refresh.ts

---

🎛 Configuration par phase

Vous pouvez assigner un modèle différent à chaque type d'agent pour optimiser coût/qualité.

Via l'UI

Paramètres du projet → Modèles par phase :

• spec — création de spec
• planning — planificateur
• coding — coder
• qa_review — revue QA
• qa_fix — correction QA

Exemples de stratégies

Stratégie économique

Phase	Modèle
Spec	Claude Haiku
Planning	Claude Sonnet
Coding	Claude Sonnet
QA Review	Claude Haiku
QA Fix	Claude Haiku

Stratégie qualité max

Phase	Modèle
Spec	Claude Opus
Planning	Claude Opus
Coding	Claude Opus
QA Review	Claude Opus
QA Fix	Claude Sonnet

Stratégie mixte (recommandée)

Phase	Modèle
Spec	Claude Sonnet
Planning	Claude Opus
Coding	Claude Sonnet
QA Review	Claude Sonnet
QA Fix	Claude Sonnet

---

🧠 Budget de réflexion (max_thinking_tokens)

Claude 4+ supporte une phase de réflexion interne avant la réponse. WorkPilot AI permet de budgetiser ce thinking par phase :

Phase	Budget typique
Correction simple	1 000 – 3 000 tokens
Coding	5 000 – 10 000 tokens
Planning complexe	10 000 – 20 000 tokens
Migration multi-module	20 000 – 32 000 tokens

Plus le budget est grand, meilleure est la qualité — mais le coût augmente.

---

🦙 Ollama — exécution locale

Utile pour :

• Confidentialité maximale (pas de données envoyées vers le cloud)
• Prototypage sans coût
• Offline

Setup

1. Installez Ollama
2. Téléchargez un modèle : ollama pull llama3.1:70b
3. Configurez :

OLLAMA_BASE_URL=http://localhost:11434

4. Dans WorkPilot AI, créez un profil Ollama et pointez vers le modèle

⚠️ La qualité des modèles locaux est généralement inférieure aux modèles cloud de pointe. Ollama est idéal pour des tâches simples ou pour expérimenter.

---

🔌 Endpoint custom OpenAI-compatible

Vous pouvez utiliser n'importe quel service qui expose une API compatible OpenAI :

• z.ai — modèles GLM
• Together.ai
• Fireworks.ai
• DeepInfra
• Groq
• Vos propres serveurs self-hosted

Dans Ajouter un profil, choisissez « Custom OpenAI-compatible » et renseignez :

• Base URL (ex : https://api.z.ai/v1)
• API Key
• Modèle par défaut

---

📊 Monitoring de consommation

Analytics Dashboard suit en temps réel :

• Tokens par profil / modèle / projet
• Coût cumulé (estimé selon les tarifs publiés)
• Taux de réussite des tâches
• Temps d'exécution moyen

Rate Limit Monitor affiche :

• Usage courant / plafond pour chaque profil
• Temps avant reset
• Alertes proactives (seuils configurables)

Cost Estimator (avant de lancer une tâche) :

• Estimation de coût par fournisseur
• Comparaison inter-fournisseurs
• Alertes si dépassement de budget

---

🎮 Arena Mode — comparer des modèles

L'Arena permet de lancer la même spec sur plusieurs modèles en parallèle pour comparer :

• Claude Opus vs Sonnet vs Haiku
• Claude vs GPT-4 vs Gemini
• Modèle cloud vs Ollama local

Les résultats sont affichés côte à côte avec métriques (temps, tokens, qualité perçue). Vous votez pour le meilleur — les votes enrichissent une base d'apprentissage qui vous guide pour les choix futurs.

---

🔐 Claude Agent SDK

Règle interne : toutes les interactions IA passent par le Claude Agent SDK (claude-agent-sdk). Cela garantit :

• Journalisation uniforme (workflow logger)
• Hooks de sécurité (sandbox, allowlist)
• Gestion des MCPs homogène
• Gestion d'erreurs et de reprises centralisée

Ne jamais utiliser anthropic.Anthropic() directement ; toujours passer par create_client() de core.client.

---

Prochaine étape

➡️ Système de mémoire — Graphiti et persistance