Le catalogue de capacités
La liste structurée de ce que votre API sait faire — découverte une fois, rédigée par vous et lue par toutes les surfaces.
Le catalogue de capacités est le cœur de Syncanix. C’est une description structurée de tout ce que votre produit sait faire, découverte à partir de votre API et affinée par vous. Toutes les surfaces — le widget, le chat, le serveur MCP — lisent ce catalogue unique, de sorte que ce que votre assistant peut faire reste cohérent partout et se modifie à un seul endroit.
Ce qu’est une capacité
Une capacité est une seule chose que votre API sait faire : un point de terminaison ou une action, comme « consulter une commande » ou « rembourser un paiement ». Chacune est décrite suffisamment pour que l’assistant comprenne ce qu’elle fait, ce dont elle a besoin et quand l’utiliser.
Ce que contient chaque capacité
- Identifiant
- Un id stable de la forme domaine.action (par exemple orders.refund), utilisé partout où la capacité est référencée.
- Méthode et chemin
- La méthode et le chemin HTTP auxquels la capacité correspond (par exemple POST /orders/{id}/refund).
- Entrées
- Les arguments que l’action accepte, avec leurs noms et types — jamais de valeurs d’exemple issues de vos données.
- Description
- Un résumé en langage clair de ce que fait l’action. C’est ce que lit l’assistant pour décider s’il l’utilise et quand.
- Effet
- Si l’action lit, écrit ou est destructrice — ce qui détermine comment elle est confirmée avant de s’exécuter.
- Risque
- Un niveau de risque qui vous permet de traiter certaines actions avec plus de prudence que leur seul effet ne le suggérerait.
- Autorisations requises
- Les autorisations (scopes) qu’un utilisateur doit posséder pour que l’action lui soit ne serait-ce que proposée.
- Indicateur « interne »
- Marque une capacité comme interne pour qu’elle reste hors de portée de l’assistant tout en restant dans votre catalogue.
- Indicateurs de données personnelles
- Marque les entrées ou sorties contenant des données personnelles, afin de les traiter et de les masquer comme il se doit.
Découvert, puis rédigé
La découverte propose le catalogue en lisant votre code de façon statique. Ensuite, c’est à vous de le rédiger : renommer des capacités, affiner les descriptions, définir les effets et le risque, marquer des points de terminaison comme internes et ajuster les autorisations requises — le tout dans le tableau de bord. Vos modifications sont enregistrées comme des surcharges, et survivent donc à la découverte suivante.
Une source unique de vérité
Parce que le widget, la surface de chat et le serveur MCP lisent tous le même catalogue, vous définissez une seule fois ce que l’assistant peut faire. Modifiez une capacité dans le tableau de bord et toutes les surfaces le reflètent.