Passer au contenu principal
POST
Enregistrer l'outil

Enregistrer un outil

POST /v1/tools Enregistre un nouvel outil dans le registre d’outils MAIP du locataire. Les outils représentent des capacités externes (API, fonctions, services) que les agents machine peuvent invoquer. Chaque outil est associé à une portée requise, un niveau de risque et une porte d’approbation facultative. La plateforme élève automatiquement le niveau de risque à "high" si le nom de l’outil ou la portée requise contient des verbes d’action dangereux (write, delete, send, execute, deploy, destroy, drop, truncate).
Les noms d’outils doivent être uniques par locataire. Tenter d’enregistrer un outil avec un nom qui existe déjà renvoie 409 Conflict.

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

string
UUID de l’outil nouvellement enregistré.
string
UUID du locataire propriétaire.
string
Nom de l’outil lisible par machine.
string
Nom de l’outil lisible par l’homme.
string
Description de l’outil.
string
Portée requise pour l’invocation.
string
Classification effective du risque (peut être auto-élevée).
boolean
Si une approbation humaine est requise.
integer
Limite de débit par agent.
string
Catégorie d’outil.
string
Statut de l’outil. Toujours "active" à la création.
object
Métadonnées de l’outil.
string
Horodatage de création ISO 8601.
string
Horodatage de dernière mise à jour ISO 8601.

Exemple


Élévation automatique du niveau de risque

La plateforme scanne les noms d’outils et les exigences de portée pour détecter les verbes d’action dangereux. Si détecté, le niveau de risque est automatiquement élevé : Les outils avec un niveau de risque "critical" nécessitent toujours une approbation humaine, quel que soit le paramètre requires_approval.

Autorisations

X-API-Key
string
header
requis

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

Corps

application/json
display_name
string
requis
name
string
requis

Nom d'outil unique

scope_required
string
requis
category
string
description
string

Description de l'outil lisible par l'homme

metadata
any
rate_limit_per_minute
integer
requires_approval
boolean
risk_level
string

Réponse

Outil enregistré

tool_id
string<uuid>
name
string
description
string
schema
object
agent_id
string<uuid>
created_at
string<date-time>