Saltar al contenido principal
POST
Reportar Anomalía
Reporta una anomalía de comportamiento detectada en la actividad de un agente de IA. Las anomalías son observaciones marcadas que indican que un agente puede estar operando fuera de su envolvente de comportamiento esperado, como picos repentinos de velocidad, violaciones de alcance, caídas en la puntuación de confianza o anomalías de acceso geográfico. Los informes de anomalías crean alertas procesables para los equipos de seguridad y pueden activar políticas de respuesta automatizadas (por ejemplo, limitación, revocación de sesión o suspensión de agentes) según la gravedad y la configuración del inquilino.

Tipos de anomalías

Niveles de gravedad

Respuesta

string
Identificador único de anomalía en formato MAIP (maip-anom:ULID).
string
El agente asociado con la anomalía.
string
Tipo de anomalía reportada.
string
Nivel de gravedad.
string
Estado de anomalía. Siempre open en la creación.
string
Acción de respuesta automatizada tomada (si la hay), basada en la gravedad y la política del inquilino.
string
Marca de tiempo de creación ISO 8601.

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
anomaly_type
string
requerido

Clasificación (por ejemplo, scope_escalation, unusual_volume, auth_failure_burst)

actual_value
number | null
anomaly_score
number
baseline_value
number | null
description
string

Descripción legible por humanos de la anomalía

Respuesta

Anomalía reportada

anomaly_id
string<uuid>
agent_id
string<uuid>
anomaly_type
string
severity
enum<string>
Opciones disponibles:
low,
medium,
high,
critical
details
object
status
enum<string>
Opciones disponibles:
open,
investigating,
resolved,
dismissed
resolution
string
resolved_by
string
created_at
string<date-time>
resolved_at
string<date-time>