Zum Hauptinhalt springen
POST
Agent suspendieren

Agent sperren

POST /v1/agents/{agentID}/suspend Sperrt eine Maschinenagenten-Identität und verhindert sofort, dass sie neue Sitzungen erstellt, Tools aufruft oder authentifizierte Operationen durchführt. Die Sperrung ist reversibel – der Agent kann reaktiviert werden, indem sein Status über den Update-Endpunkt wieder auf "active" aktualisiert wird. Alle aktiven Sitzungen, die zum suspendierten Agenten gehören, werden auf der Zugriffskontrollebene effektiv blockiert. Bestehende Sitzungstoken werden bei Bereichsprüfungen fehlschlagen, bis der Agent reaktiviert wird.
Die Suspendierung ist die empfohlene erste Reaktion bei anomalem Agentenverhalten. Verwenden Sie widerrufen nur bei dauerhafter Stilllegung ist erforderlich.

Authentifizierung

Erfordert X-API-Key Header oder Bearer JWT Token. Der Arbeitsbereich wird aus den authentifizierten Anmeldeinformationen abgeleitet; senden Sie X-Tenant-ID nicht.

Antwort

string
Aktualisierter Status, bei Erfolg immer "suspended".
string
Der MAIP-Agentenbezeichner, der gesperrt wurde.

Beispiel


Reaktivierung eines gesperrten Agenten

Um einen gesperrten Agenten wieder in den aktiven Status zu versetzen, verwenden Sie den Endpunkt PATCH /v1/agents/:

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
reason
string
erforderlich

Menschenlesbarer Grund für die Sperrung

Antwort

Agent suspendiert

id
string<uuid>
agent_type
enum<string>
Verfügbare Optionen:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
Verfügbare Optionen:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
Erforderlicher Bereich: 0 <= x <= 1
public_key
string

Base64-kodierter öffentlicher Schlüssel

session_count
integer
keys
object[]
created_at
string<date-time>
updated_at
string<date-time>