Passer au contenu principal
GET
Obtenir l'agent

Obtenir l’agent

GET /v1/agents/{agentID} Renvoie l’enregistrement complet de l’identité de l’agent spécifié, y compris les informations de clé cryptographique, le score de confiance actuel, les portées attribuées, la profondeur de délégation et toutes les métadonnées. L’agent doit appartenir au locataire authentifié.

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.
string
UUID du locataire propriétaire.
string
Classification du type d’agent.
string
Nom de l’agent lisible par l’homme.
string
Description de l’agent.
string
Niveau de la hiérarchie de confiance. Un parmi : "platform_root", "verified_org", "verified_individual", "authenticated", "self_asserted", "anonymous".
number
Score de confiance numérique entre 0,0 et 1,0. Ajusté au fil du temps en fonction de l’agent comportement, détection d’anomalies et historique d’attestation.
string
Statut du cycle de vie actuel : "active", "suspended", ou "revoked".
string
Clé publique Ed25519 encodée en Base64url pour cet agent.
string
Identifiant de clé unique pour la vérification de la signature du reçu et de l’attestation.
string[]
Portées de permission attribuées au format resource:action.
object
Métadonnées arbitraires attachées à l’agent.
string
Si cet agent a été créé par délégation, l’ID MAIP de l’agent parent.
number
Position dans la chaîne de délégation (0 = racine, max 8).
string
UUID de l’utilisateur qui a enregistré l’agent, le cas échéant.
string
Horodatage ISO 8601 si la clé de l’agent a été marquée comme compromise.
string
Horodatage d’expiration automatique, si configuré.
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

Paramètres de chemin

agentId
string<uuid>
requis

Identifiant de l'agent

Réponse

Détails de l'agent

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>