# IaGenify SDK 0.3.2 donne aux agents une carte de leurs outils disponibles.

Canonical URL: https://www.iagenify.com/fr/news/iagenify-sdk-agent-capability-catalogue

Les instructions de l’agent s’appuient sur les outils et actions réellement activés pour l’exécution, afin qu’il choisisse parmi les capacités présentes au lieu de se fier à une documentation générique.

## Key points
- L’agent reçoit un inventaire compact des capacités disponibles dans son exécution.
- Cet inventaire reflète les outils réellement activés par l’application, le mode et l’environnement.
- Un contrôle de contrat compare les méthodes du SDK aux outils accessibles à l’agent ou à une exclusion motivée.

Un agent ne peut choisir correctement que s’il sait quelles actions sont disponibles. Une liste générale de la documentation ne suffit pas : l’application peut n’activer qu’un sous-ensemble, l’environnement peut ne pas disposer d’une fonction, ou le mode d’autorisation peut interdire une action. IaGenify SDK 0.3.2 ajoute une carte des capacités fondée sur les outils réellement accessibles à l’exécution.

## Décrivez l’exécution réelle, pas la plateforme théorique

Au début de l’exécution, l’agent reçoit un aperçu compact des groupes d’outils actifs et de leurs actions. Si l’application retire un outil, il disparaît de cette carte. Si l’environnement ne peut pas fournir une action, l’agent ne reçoit pas la promesse qu’il saura l’accomplir. Sa planification reste ainsi proche de ce qui peut vraiment être exécuté.

## Un catalogue aide à prendre plusieurs décisions

Le même catalogue aide l’agent à choisir une opération, à trouver la documentation détaillée correspondante et aide les développeurs à comprendre où se trouve une capacité. Le résumé décrit ce qui existe ; la référence détaillée explique comment l’utiliser. Cette séparation garde la carte initiale courte et les explications suivantes pertinentes.

## La couverture peut être vérifiée plutôt que mémorisée

Un contrôle de contrat compare les méthodes exposées par les ressources du SDK au code des outils de l’agent. Chaque méthode doit être accessible par un outil ou disposer d’un motif documenté pour rester hors de portée. Une capacité oubliée est alors repérée pendant le développement, plutôt que laissée à la vigilance de quelqu’un qui doit synchroniser plusieurs listes.

Ce contrôle évite aussi les accès accidentels. Certaines méthodes restent hors de portée car elles touchent à l’autorité du compte ou à des secrets ; d’autres ne sont pas disponibles dans un environnement donné. Le catalogue distingue ces limites volontaires d’une simple omission.

## Une carte compacte peut décrire un SDK étendu

La version mesure l’accès de l’agent par actions plutôt que par noms d’outils de premier niveau. Un seul outil peut regrouper plusieurs opérations ; compter uniquement les noms masque donc ce que l’agent peut faire. Un aperçu concis donne au modèle le contexte nécessaire sans une longue suite d’appels de découverte.

> Un agent doit planifier à partir des capacités réellement présentes dans son exécution, pas d’une brochure de tout ce que la plateforme pourrait prendre en charge.

IaGenify SDK 0.3.2 facilite la maintenance de la frontière entre le SDK et sa boucle d’agent : les capacités proviennent du catalogue de l’exécution et un contrôle de contrat surveille leur cohérence avec les outils.

## FAQ
### La carte active-t-elle toutes les méthodes du SDK ?
Non. Elle décrit ce qui est accessible dans cette exécution ; la sélection de l’application, l’environnement et les permissions restent déterminants.

### En quoi la carte diffère-t-elle de la documentation ?
Elle résume les capacités de l’exécution. La documentation détaillée explique comment utiliser une opération prise en charge.

### Pourquoi compter les actions plutôt que les noms d’outils ?
Un outil peut regrouper plusieurs opérations ; le nombre d’actions décrit mieux ce que l’agent peut réellement faire.

### Les opérations sensibles sont-elles exposées automatiquement ?
Non. Les méthodes liées à l’autorité du compte ou aux secrets peuvent être exclues, avec une raison suivie par le contrôle de contrat.