Zum Hauptinhalt springen
GET
Agenten auflisten

Agenten auflisten

GET /v1/agents Gibt eine paginierte Liste aller unter dem authentifizierten Mandanten registrierten Maschinenagentenidentitäten zurück. Die Ergebnisse können nach Agententyp, Status und Vertrauensstufe gefiltert werden. Agenten werden in umgekehrter chronologischer Reihenfolge (neueste zuerst) zurückgegeben.

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

object[]
Array von Agentenidentitätsobjekten. Jedes Objekt enthält den vollständigen Agentendatensatz einschließlich agent_id, agent_type, display_name, status, trust_level, trust_score, scopes, public_key, key_id, metadata, delegation_depth, created_at und updated_at.
integer
Gesamtzahl der Agenten, die den Filterkriterien entsprechen, über alle Seiten hinweg.

Beispiel

Autorisierungen

X-API-Key
string
header
erforderlich

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

Abfrageparameter

agent_type
enum<string>

Nach Agententyp filtern

Verfügbare Optionen:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
status
enum<string>

Nach Agentenstatus filtern

Verfügbare Optionen:
active,
suspended,
revoked
trust_level
string
limit
integer

Maximale Anzahl der zurückzugebenden Agenten

Erforderlicher Bereich: 1 <= x <= 100
offset
integer

Anzahl der zu überspringenden Agenten

Erforderlicher Bereich: x >= 0

Antwort

Paginierte Liste der Agenten

items
object[]
total
integer