Agno propose trois primitives qui répondent à des besoins différents. Un Agent choisit ses actions, une Team coordonne plusieurs spécialistes et un Workflow impose une séquence contrôlée. Commencer directement par une équipe multi-agent ajoute souvent de la complexité sans améliorer le résultat.
Agent : une autonomie ciblée
Utilisez un agent pour une tâche ouverte qui demande de choisir un outil ou d’adapter la réponse au contexte. Un assistant de recherche ou de support peut fonctionner avec un seul agent, quelques outils et une sortie structurée.
Limitez ses permissions, ses itérations et son budget. Si le parcours peut être exprimé par une fonction déterministe, cette fonction reste généralement plus prévisible et moins coûteuse.
Team : plusieurs rôles réellement distincts
Une équipe devient utile lorsque des agents possèdent des responsabilités, outils ou contextes différents. Un coordinateur peut déléguer la recherche à un membre et la vérification à un autre. Cette séparation doit apporter une capacité mesurable, pas seulement reproduire des personnages dans le prompt.
Évaluez la qualité de la délégation, le nombre d’appels et les contradictions entre membres. Définissez également qui produit la réponse finale et comment une erreur d’un membre est traitée.
Workflow : un processus explicite
Choisissez un workflow lorsque l’ordre des étapes, les embranchements ou les validations ont une valeur métier. Il peut combiner agents, équipes et fonctions ordinaires dans une exécution séquentielle, conditionnelle ou parallèle.
Le workflow est adapté au traitement documentaire, à une publication avec approbation ou à un processus qui doit pouvoir être repris. Les décisions réglementaires et les actions irréversibles doivent rester dans des étapes contrôlées.
Une progression raisonnable
Commencez avec une fonction ou un seul agent. Ajoutez une équipe si plusieurs expertises ou permissions séparées améliorent objectivement la qualité. Introduisez un workflow lorsque vous devez garantir le déroulement, la reprise ou l’intervention humaine.
Testez le même scénario avec chaque architecture envisagée et comparez qualité, latence, coût et facilité de diagnostic. Le meilleur choix est la primitive la plus simple qui satisfait les garanties du produit. Agno permet de les composer ; cette flexibilité ne rend pas leur accumulation obligatoire.