Zum Hauptinhalt springen
PATCH
Agent aktualisieren

Agent aktualisieren

PATCH /v1/agents/{agentID} Aktualisiert veränderliche Felder einer bestehenden Maschinenagentenidentität. Nur die im Anfragetext angegebenen Felder werden geändert; alle anderen Felder bleiben unverändert. Mindestens ein Feld muss angegeben werden.
Um die Scopes eines Agenten zu ändern, verwenden Sie das Delegationssystem oder registrieren Sie den Agenten neu. Agenten. Bereiche können nicht direkt über diesen Endpunkt geändert werden, um die den Audit-Trail von Scope-Änderungen.

Authentifizierung

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

Anfragetext

Alle Felder sind optional, aber mindestens eines muss angegeben werden.

Antwort

Gibt das vollständig aktualisierte Agentenidentitätsobjekt zurück.
string
Interner UUID-Primärschlüssel.
string
MAIP-konformer Agentenbezeichner.
string
Der aktualisierte Anzeigename.
string
Die aktualisierte Beschreibung.
object
Das aktualisierte Metadatenobjekt.
string
Aktueller Lebenszyklusstatus nach dem Update.
string
ISO 8601 Zeitstempel, der die Aktualisierung widerspiegelt.

Beispiel

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
description
string | null
display_name
string | null
Maximum string length: 256
metadata
any
status
string | null

Antwort

Agent aktualisiert

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>