Zum Hauptinhalt springen
POST
Anomalie melden
Meldet eine in der Aktivität eines KI-Agenten erkannte Verhaltensanomalie. Anomalien sind markierte Beobachtungen, die darauf hindeuten, dass ein Agent möglicherweise außerhalb seines erwarteten Verhaltensbereichs agiert – wie plötzliche Ratenanstiege, Bereichsverletzungen, Vertrauenspunktabfälle oder geografische Zugriffsanomalien. Anomalieberichte erstellen umsetzbare Warnungen für Sicherheitsteams und können je nach Schweregrad und Mandantenkonfiguration automatisierte Reaktionsrichtlinien (z. B. Drosselung, Sitzungswiderruf oder Agenten-Sperrung) auslösen.

Anomalie-Typen

Schweregrade

Antwort

string
Eindeutiger Anomalie-Identifikator im MAIP-Format (maip-anom:ULID).
string
Der Agent, der mit der Anomalie verbunden ist.
string
Art der gemeldeten Anomalie.
string
Schweregrad.
string
Anomalie-Status. Bei der Erstellung immer open.
string
Automatische Antwortaktion (falls vorhanden), basierend auf Schweregrad und Mandantenrichtlinie.
string
ISO 8601 Zeitstempel der Erstellung.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Pfadparameter

agentId
string<uuid>
erforderlich

Agenten-Identifikator

Body

application/json
anomaly_type
string
erforderlich

Klassifizierung (z. B. scope_escalation, unusual_volume, auth_failure_burst)

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

Menschenlesbare Beschreibung der Anomalie

Antwort

Anomalie gemeldet

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