Agent, Team et Workflow correspondent à trois formes de contrôle. Un Agent décide comment répondre avec ses outils. Une Team coordonne plusieurs spécialistes. Un Workflow encode des étapes connues. Choisir l’abstraction la plus puissante par défaut produit souvent un système plus coûteux et moins prévisible.
Agent : une décision locale
Utilisez un Agent lorsqu’un modèle doit interpréter une demande, choisir parmi quelques outils et produire un résultat. Donnez-lui un objectif étroit, des outils typés et une limite d’étapes. Si le chemin est connu à l’avance, une fonction ordinaire reste souvent préférable.
Team : des compétences réellement distinctes
Une Team se justifie lorsque plusieurs rôles ont des instructions, outils ou contextes différents et que leur collaboration améliore une métrique. Définissez qui délègue, quelles informations sont partagées et quand la tâche s’arrête. Comparer une Team à un Agent unique évite de payer plusieurs appels pour une simple mise en scène.
Workflow : le processus avant le modèle
Un Workflow convient aux séquences répétables : collecter, valider, faire approuver puis publier. Les branches et erreurs restent visibles dans le code. Les agents peuvent intervenir dans certaines étapes sans décider eux-mêmes des actions irréversibles. C’est généralement le meilleur choix pour audit, reprise et tests métier.
Une règle de composition
Commencez par des fonctions déterministes, ajoutez un Agent là où une décision linguistique est nécessaire, puis une Team seulement si l’évaluation prouve le bénéfice de plusieurs spécialistes. Encapsulez l’ensemble dans un Workflow si le produit demande étapes, validation humaine ou reprise.
Checklist
- Responsabilité de chaque abstraction définie.
- État isolé par exécution et utilisateur.
- Limites de tours, temps et budget.
- Outils autorisés côté serveur.
- Écritures idempotentes et approbations.
- Traces et évaluations par étape.
FAQ
Une Team est-elle plus fiable ?
Pas nécessairement. Elle peut ajouter critiques et spécialisations, mais aussi erreurs de coordination.
Peut-on appeler un Agent depuis un Workflow ?
Oui, c’est souvent une architecture saine.
Comment décider objectivement ?
Comparez taux de réussite, coût, latence et facilité de diagnostic sur les mêmes scénarios.