Zum Hauptinhalt springen
GET
Agent abrufen

Agent abrufen

GET /v1/agents/{agentID} Gibt den vollständigen Agentenidentitätsdatensatz für den angegebenen Agenten zurück, einschließlich kryptografischer Schlüsselinformationen, aktuellem Vertrauenswert, zugewiesenen Bereichen, Delegationstiefe und allen Metadaten. Der Agent muss zum authentifizierten Mandanten gehören.

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
Interner UUID-Primärschlüssel.
string
MAIP-konformer Agentenbezeichner.
string
UUID des besitzenden Mandanten.
string
Klassifizierung des Agententyps.
string
Menschenlesbarer Agentenname.
string
Agentenbeschreibung.
string
Vertrauenshierarchie-Ebene. Eine von: "platform_root", "verified_org", "verified_individual", "authenticated", "self_asserted", "anonymous".
number
Numerischer Vertrauenswert zwischen 0,0 und 1,0. Im Laufe der Zeit basierend auf dem Agenten angepasst Verhalten, Anomalieerkennung und Bestätigungsverlauf.
string
Aktueller Lebenszyklusstatus: "active", "suspended" oder "revoked".
string
Base64url-kodierter Ed25519-Public-Key für diesen Agenten.
string
Eindeutiger Schlüsselidentifikator für die Überprüfung von Beleg- und Bestätigungssignaturen.
string[]
Zugewiesene Berechtigungsbereiche im Format resource:action.
object
Beliebige Metadaten, die an den Agenten angehängt sind.
string
Wenn dieser Agent über Delegation erstellt wurde, die MAIP-ID des übergeordneten Agenten.
number
Position in der Delegationskette (0 = Root, max. 8).
string
UUID des Benutzers, der den Agenten registriert hat, falls zutreffend.
string
ISO 8601 Zeitstempel, wenn der Schlüssel des Agenten als kompromittiert markiert wurde.
string
Automatischer Ablaufzeitstempel, falls konfiguriert.
string
ISO 8601 Erstellungszeitstempel.
string
ISO 8601 Zeitstempel der letzten Aktualisierung.

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

Antwort

Agentendetails

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>