construction-de-harnais-d-agent

Construction de harnais d'agent

Utilisez ce skill lorsque vous améliorez la façon dont un agent planifie, appelle des outils, se remet des erreurs et converge vers l'achèvement.

Modèle central

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

1. Qualité de l'espace d'action
2. Qualité des observations
3. Qualité de la récupération
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 fondées sur des schémas et étroites.
3. Renvoyez des formes de sortie déterministes.
4. Évitez les outils fourre-tout sauf si l'isolement 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 surcoût des allers-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 exploitables
• artifacts : chemins de fichiers / IDs

Contrat de récupération d'erreurs

Pour chaque chemin d'erreur, incluez :

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

Budgétisation du contexte

1. Gardez l'invite système minimale et invariante.
2. Déplacez les instructions volumineuses dans des skills chargés à la demande.
3. Préférez les références aux fichiers plutôt que l'incorporation de longs documents.
4. Compressez aux limites de phase, pas à des seuils de tokens arbitraires.

Conseils sur les patrons d'architecture

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

Benchmarking

Suivez :

• taux d'achèvement
• nouvelles 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 étapes suivantes.
• Surcharge du contexte avec des références non pertinentes.