Saltar al contenido principal
PATCH
Actualizar Agente

Actualizar Agente

PATCH /v1/agents/{agentID} Actualiza los campos mutables en una identidad de agente de máquina existente. Solo se modifican los campos proporcionados en el cuerpo de la solicitud; todos los demás campos permanecen sin cambios. Se debe proporcionar al menos un campo.
Para cambiar los ámbitos de un agente, utilice el sistema de delegación o vuelva a registrar el agente. agente. Los ámbitos no se pueden modificar directamente a través de este endpoint para preservar el registro de auditoría de los cambios de alcance.

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.

Cuerpo de la solicitud

Todos los campos son opcionales, pero al menos uno debe proporcionarse.

Respuesta

Devuelve el objeto de identidad del agente actualizado completo.
string
Clave primaria UUID interna.
string
Identificador de agente compatible con MAIP.
string
El nombre de visualización actualizado.
string
La descripción actualizada.
object
El objeto de metadatos actualizado.
string
Estado actual del ciclo de vida después de la actualización.
string
Marca de tiempo ISO 8601 que refleja la actualización.

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

Cuerpo

application/json
description
string | null
display_name
string | null
Maximum string length: 256
metadata
any
status
string | null

Respuesta

Agente actualizado

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>