Agents
Un agent Palabre est une entrée de configuration qui décrit comment appeler une IA.
Palabre supporte deux familles d'agents :
- les agents CLI, comme Claude Code, Codex CLI, Gemini CLI ou OpenCode ;
- les agents locaux, comme Ollama via son API HTTP.
Agents CLI
Un agent CLI est lancé comme une commande de terminal. Palabre lui envoie un prompt, récupère sa sortie, puis ferme le process.
Chaque CLI garde ses propres règles : authentification, modèle par défaut, abonnement, limites d'usage et options de configuration. Certaines CLIs peuvent fonctionner avec une offre gratuite, un abonnement, un provider local ou un provider cloud ; dans tous les cas, les quotas et erreurs de limite viennent de l'agent utilisé, pas de Palabre.
Agents locaux
Un agent local comme Ollama utilise un modèle installé sur votre machine. C'est utile pour des rôles de critique, d'exploration ou de synthèse légère. Si vous configurez Ollama avec une offre cloud ou un service payant, les limites associées restent celles d'Ollama ou du provider choisi.
Ollama ne lit pas vos fichiers directement. Pour lui donner du contexte, utilisez --files ou --context.
Voir les agents disponibles
palabre agents
Si une CLI installée n'apparaît pas dans la configuration :
palabre config --sync-agents
Rôles
Chaque agent a un rôle qui influence le prompt :
| Rôle | Usage |
|---|---|
implementer | Proposer une solution concrète. |
reviewer | Chercher les risques, régressions et tests manquants. |
critic | Challenger les hypothèses. |
architect | Structurer les options techniques. |
scout | Explorer rapidement un sujet. |
summarizer | Produire une synthèse fidèle. |
Les rôles ne changent pas le modèle utilisé. Ils changent la consigne envoyée dans le prompt.
Utiliser un rôle
Un rôle se configure dans palabre.config.json, dans l'entrée de l'agent. Il n'existe pas encore d'option de commande comme --role-a ou --role-b.
Exemple :
"codex": {
"type": "cli",
"command": "codex",
"role": "implementer"
},
"claude": {
"type": "cli",
"command": "claude.exe",
"role": "reviewer"
}
Avec cette configuration :
palabre codex-claude "Critique ce plan" -t 4
Codex reçoit une consigne de proposition concrète, tandis que Claude reçoit une consigne de relecture critique.
Pour utiliser deux comportements différents avec la même CLI, créez deux agents distincts dans la configuration, par exemple claude-reviewer et claude-summarizer.
Modèles passés en commande
Quand vous utilisez --model-a, --model-b ou --summary-model, Palabre ne vérifie pas la liste des modèles disponibles chez le provider. La valeur est transmise à la CLI concernée via son option modèle configurée. Si le modèle n'existe pas ou n'est pas autorisé par votre compte, c'est la CLI qui renvoie l'erreur.