Passer au contenu principal
POST
Invoquer l'outil

Invoquer l’outil

POST /v1/tools/{toolName}/invoke Demande l’invocation d’un outil enregistré au nom d’un agent machine. La plateforme effectue un contrôle d’accès multicouche avant d’accorder l’accès :
  1. Statut de l’agent — l’agent doit être "active"
  2. Vérification de la portée — l’agent doit détenir la portée requise par l’outil
  3. Limite de débit — l’agent ne doit pas dépasser la limite de débit par minute de l’outil
  4. Porte d’approbation — si l’outil nécessite une approbation, la réponse est pending_approval ; le gestionnaire actuel ne crée pas de demande d’approbation
Si toutes les vérifications sont réussies, l’invocation est enregistrée. Les reçus d’outils actuels utilisent un marqueur système plutôt qu’une signature cryptographique. Ce sont des enregistrements d’audit, et non des preuves signées vérifiables de manière indépendante.
Ce point de terminaison effectue la décision de contrôle d’accès et enregistre la décision. Il ne proxy pas l’exécution réelle de l’outil. Votre application est responsable d’appeler le point de terminaison sous-jacent de l’outil après avoir reçu un "allowed" réponse.

Authentification

Nécessite l’en-tête X-API-Key ou un jeton JWT Bearer. L’espace de travail est dérivé de l’identifiant authentifié ; n’envoyez pas X-Tenant-ID.

Réponse

boolean
Si l’invocation a été autorisée. true si toutes les vérifications de contrôle d’accès passé.
string
Statut de l’invocation. L’un des suivants : "allowed", "denied", "pending_approval".
string
Explication lisible par l’homme lorsque l’invocation est refusée ou en attente. Non présent lorsque autorisé.
string
Identifiant de reçu unique pour l’invocation, lié à la piste d’audit. Uniquement présent lorsque status est "allowed".
boolean
true lorsque l’outil nécessite une approbation humaine. L’invocation n’est pas automatiquement mise en file d’attente pour approbation. Présent uniquement lorsque status est "pending_approval".

Exemple : Invocation autorisée


Flux de contrôle d’accès

Modèle d’intégration

Après avoir reçu une réponse "allowed", exécutez l’outil et enregistrez éventuellement le résultat :

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Paramètres de chemin

toolName
string
requis

Nom de l'outil enregistré.

Corps

application/json
agent_id
string
requis
session_id
string<uuid>

Session active à invoquer sous

Réponse

Résultat de l'invocation de l'outil

result
object
receipt_id
string<uuid>
execution_ms
integer