Saltar para o conteúdo principal
POST
Reportar Anomalia
Reporta uma anomalia comportamental detetada na atividade de um agente de IA. As anomalias são observações sinalizadas que indicam que um agente pode estar a operar fora do seu envelope comportamental esperado — como picos de taxa súbitos, violações de âmbito, quedas na pontuação de confiança ou anomalias de acesso geográfico. Os relatórios de anomalias criam alertas acionáveis para equipas de segurança e podem acionar políticas de resposta automatizadas (por exemplo, limitação, revogação de sessão ou suspensão de agente) dependendo da gravidade e da configuração do inquilino.

Tipos de Anomalia

Níveis de Gravidade

Resposta

string
Identificador de anomalia único no formato MAIP (maip-anom:ULID).
string
O agente associado à anomalia.
string
Tipo de anomalia relatada.
string
Nível de gravidade.
string
Status da anomalia. Sempre open na criação.
string
Ação de resposta automatizada tomada (se houver), com base na gravidade e na política do locatário.
string
Carimbo de data/hora de criação ISO 8601.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Parâmetros de caminho

agentId
string<uuid>
obrigatório

Identificador do agente

Corpo

application/json
anomaly_type
string
obrigatório

Classificação (por exemplo, scope_escalation, unusual_volume, auth_failure_burst)

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

Descrição legível por humanos da anomalia

Resposta

Anomalia reportada

anomaly_id
string<uuid>
agent_id
string<uuid>
anomaly_type
string
severity
enum<string>
Opções disponíveis:
low,
medium,
high,
critical
details
object
status
enum<string>
Opções disponíveis:
open,
investigating,
resolved,
dismissed
resolution
string
resolved_by
string
created_at
string<date-time>
resolved_at
string<date-time>