Passer au contenu principal
POST
Enregistrer l'agent

Enregistrer un agent

POST /v1/agents Enregistre une nouvelle identité d’agent machine pour le locataire authentifié. La plateforme génère une paire de clés Ed25519 pour l’agent, attribue un ID d’agent conforme à MAIP et enregistre la clé initiale dans le registre de l’historique des clés. Les agents nouvellement enregistrés commencent avec le statut active et un score de confiance initial de 0.500.
Le nombre d’agents que vous pouvez enregistrer dépend de votre plan de facturation. Si vous dépassent la limite de votre plan, l’API renvoie 402 Payment Required. Contactez les ventes pour les limites d’agents de niveau entreprise.

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
Clé primaire UUID interne.
string
Identifiant d’agent conforme à MAIP au format maip:<tenant8>:<ulid>. Utilisez cette valeur dans tous les appels API ultérieurs faisant référence à cet agent.
string
UUID du locataire propriétaire.
string
Le type d’agent enregistré.
string
Nom de l’agent lisible par l’homme.
string
Description de l’agent, si fournie.
string
Niveau de confiance initial. Les agents nouvellement enregistrés commencent à "authenticated".
number
Score de confiance numérique (0,0 à 1,0). Les agents nouvellement enregistrés commencent à 0.500.
string
Statut du cycle de vie de l’agent. Toujours "active" à la création.
string
Clé publique Ed25519 encodée en Base64url générée pour cet agent. Stockez ceci en toute sécurité pour la vérification de la signature.
string
Identifiant unique de la clé de signature de l’agent. Référencé dans les reçus et attestations.
string[]
Les portées effectives attribuées à l’agent.
object
L’objet de métadonnées, s’il est fourni.
number
Profondeur actuelle de la chaîne de délégation. Toujours 0 pour les agents directement enregistrés. La profondeur maximale est de 8 par protocole MAIP.
string
UUID de l’utilisateur qui a enregistré l’agent, si authentifié via un jeton utilisateur.
string
Horodatage d’expiration, si défini.
string
Horodatage de création ISO 8601.
string
Horodatage de dernière mise à jour ISO 8601.

Exemple

Autorisations

X-API-Key
string
header
requis

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

Corps

application/json
display_name
string
requis

Nom d'agent lisible par l'homme

Maximum string length: 256
agent_type
enum<string>

Classification de l'agent

Options disponibles:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
description
string

Description textuelle libre de l'objectif de l'agent

expires_at
string<date-time> | null
metadata
any

Métadonnées clé-valeur arbitraires

scopes
string[]

Portées de permission accordées à l'agent

Réponse

Agent enregistré

id
string<uuid>
agent_type
enum<string>
Options disponibles:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
Options disponibles:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
Plage requise: 0 <= x <= 1
public_key
string

Clé publique encodée en Base64

session_count
integer
keys
object[]
created_at
string<date-time>
updated_at
string<date-time>