Saltar al contenido principal
POST
Registrar agente

Registrar Agente

POST /v1/agents Registra una nueva identidad de agente de máquina para el inquilino autenticado. La plataforma genera un par de claves Ed25519 para el agente, asigna una ID de agente compatible con MAIP y registra la clave inicial en el libro mayor del historial de claves. Los agentes recién registrados comienzan con el estado active y una puntuación de confianza inicial de 0.500.
El número de agentes que puede registrar depende de su plan de facturación. Si excede el límite de su plan, la API devuelve 402 Payment Required. Póngase en contacto con ventas para límites de agentes de nivel empresarial.

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 en formato maip:<tenant8>:<ulid>. Use este valor en todas las llamadas API posteriores que hagan referencia a este agente.
string
UUID del inquilino propietario.
string
El tipo de agente registrado.
string
Nombre del agente legible por humanos.
string
Descripción del agente, si se proporciona.
string
Nivel de confianza inicial. Los agentes recién registrados comienzan en "authenticated".
number
Puntuación de confianza numérica (0.0 a 1.0). Los agentes recién registrados comienzan en 0.500.
string
Estado del ciclo de vida del agente. Siempre "active" en la creación.
string
Clave pública Ed25519 codificada en Base64url generada para este agente. Almacene esto de forma segura para la verificación de firmas.
string
Identificador único para la clave de firma del agente. Referenciado en recibos y atestaciones.
string[]
Los alcances efectivos asignados al agente.
object
El objeto de metadatos, si se proporciona.
number
Profundidad actual de la cadena de delegación. Siempre 0 para agentes registrados directamente. La profundidad máxima es 8 por protocolo MAIP.
string
UUID del usuario que registró el agente, si se autenticó mediante un token de usuario.
string
Marca de tiempo de vencimiento, 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

Cuerpo

application/json
display_name
string
requerido

Nombre del agente legible por humanos

Maximum string length: 256
agent_type
enum<string>

Clasificación del agente

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

Descripción de texto libre del propósito del agente

expires_at
string<date-time> | null
metadata
any

Metadatos arbitrarios de clave-valor

scopes
string[]

Ámbitos de permiso concedidos al agente

Respuesta

Agente registrado

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>