Saltar al contenido principal
GET
Obtener Agente

Obtener Agente

GET /v1/agents/{agentID} Devuelve el registro completo de identidad del agente para el agente especificado, incluyendo información de clave criptográfica, puntuación de confianza actual, ámbitos asignados, profundidad de delegación y todos los metadatos. El agente debe pertenecer al inquilino autenticado.

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

string
Clave primaria UUID interna.
string
Identificador de agente compatible con MAIP.
string
UUID del inquilino propietario.
string
Clasificación del tipo de agente.
string
Nombre del agente legible por humanos.
string
Descripción del agente.
string
Nivel de jerarquía de confianza. Uno de: "platform_root", "verified_org", "verified_individual", "authenticated", "self_asserted", "anonymous".
number
Puntuación de confianza numérica entre 0.0 y 1.0. Ajustada con el tiempo según el agente comportamiento, detección de anomalías e historial de atestaciones.
string
Estado actual del ciclo de vida: "active", "suspended", o "revoked".
string
Clave pública Ed25519 codificada en Base64url para este agente.
string
Identificador de clave único para la verificación de la firma del recibo y la atestación.
string[]
Ámbitos de permiso asignados en formato resource:action.
object
Metadatos arbitrarios adjuntos al agente.
string
Si este agente fue creado mediante delegación, el ID MAIP del agente padre.
number
Posición en la cadena de delegación (0 = raíz, máximo 8).
string
UUID del usuario que registró el agente, si corresponde.
string
Marca de tiempo ISO 8601 si la clave del agente fue marcada como comprometida.
string
Marca de tiempo de expiración automática, si está configurada.
string
Marca de tiempo de creación ISO 8601.
string
Marca de tiempo de última actualización ISO 8601.

Ejemplo

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Parámetros de ruta

agentId
string<uuid>
requerido

Identificador de agente

Respuesta

Detalles del agente

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

Clave pública codificada en Base64

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