construction-de-harnais-d-agent

Construction de harnais d'agent

Utilisez cette compétence lorsque vous améliorez la façon dont un agent planifie, appelle des outils, se remet d'erreurs et converge vers la complétion.

Modèle central

La qualité de sortie d'un agent est contrainte par :

1. Qualité de l'espace d'action
2. Qualité des observations
3. Qualité de la récupération d'erreurs
4. Qualité du budget de contexte

Conception de l'espace d'action

1. Utilisez des noms d'outils stables et explicites.
2. Gardez les entrées schéma d'abord et étroites.
3. Retournez des formes de sortie déterministes.
4. Évitez les outils fourre-tout sauf si l'isolation est impossible.

Règles de granularité

• Utilisez des micro-outils pour les opérations à haut risque (déploiement, migration, permissions).
• Utilisez des outils moyens pour les boucles courantes d'édition/lecture/recherche.
• Utilisez des macro-outils uniquement lorsque le coût des aller-retours est le coût dominant.

Conception des observations

Chaque réponse d'outil doit inclure :

• status : succès|avertissement|erreur
• summary : résultat en une ligne
• next_actions : suivis actionnables
• artifacts : chemins de fichiers / IDs

Contrat de récupération d'erreurs

Pour chaque chemin d'erreur, incluez :

• indice de la cause racine
• instruction de nouvelle tentative sécurisée
• condition d'arrêt explicite

Gestion du budget de contexte

1. Gardez le prompt système minimal et invariant.
2. Déplacez les instructions volumineuses dans des compétences chargées à la demande.
3. Privilégiez les références aux fichiers plutôt que l'incorporation de longs documents.
4. Compactez aux frontières de phase, pas à des seuils de tokens arbitraires.

Conseils sur les patrons d'architecture

• ReAct : meilleur pour les tâches exploratoires avec un chemin incertain.
• Appel de fonction : meilleur pour les flux structurés et déterministes.
• Hybride (recommandé) : planification ReAct + exécution typée d'outils.

Banc d'essai

Suivez :

• taux de complétion
• tentatives par tâche
• pass@1 et pass@3
• coût par tâche réussie

Anti-patrons

• Trop d'outils avec des sémantiques qui se chevauchent.
• Sortie d'outil opaque sans indices de récupération.
• Sortie d'erreur uniquement sans prochaines étapes.
• Surcharge de contexte avec des références non pertinentes.