Outils
Actions génériques
Décrire et appeler n’importe quelle Server Action exposée.
Tous ces outils s’appellent en POST avec une clé bbv_. Ce sont aussi les outils du serveur MCP.
vendor_actions_list
Périmètre : lecture, clé read ou write.
Liste les actions de l’espace vendeurs appelables par vendor_action_call : nom, domaine (stock, commandes, devis, factures, messages, points_de_retrait…), signature TypeScript, documentation. Filtrer par domain ou texte q.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
domain | string | non | Domaine exact (ex. stock, commandes). Au plus 60 caractères. |
q | string | non | Texte cherché dans le nom, la signature et la doc. Au plus 120 caractères. |
limit | integer | non | Défaut : 100. Minimum 1. Maximum 300. |
offset | integer | non | Défaut : 0. Minimum 0. Maximum 9007199254740991. |
curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_actions_list \
-H "Authorization: Bearer $CLE" \
-H "Content-Type: application/json" \
-d '{}'vendor_action_call
Périmètre : écriture, clé write seulement.
Appelle une action de l’espace vendeurs comme un membre qui clique, restreinte à l’entreprise de la clé : action = nom donné par vendor_actions_list, args = arguments positionnels de sa signature. Même contrôle, validation et journal que l’écran (en démo, rien ne part vers un client).
| Paramètre | Type | Requis | Description |
|---|---|---|---|
action | string | oui | Nom exact renvoyé par l’outil de liste, ex. stock__createAdminPieceAction. Au moins 3 caractères. Au plus 160 caractères. |
args | unknown[] | non | Arguments POSITIONNELS de l’action, dans l’ordre de sa signature. Un objet passé à un paramètre FormData est converti en formulaire (booléen vrai = « on », tableau répété, objet en JSON texte). Défaut : []. |
curl -X POST https://vendeurs.boudbois.fr/api/agent/tools/vendor_action_call \
-H "Authorization: Bearer $CLE" \
-H "Content-Type: application/json" \
-d '{
"action": "…"
}'