Zum Hauptinhalt springen
POST
Agent registrieren

Agent registrieren

POST /v1/agents Registriert eine neue Maschinenagentenidentität für den authentifizierten Mandanten. Die Plattform generiert ein Ed25519-Schlüsselpaar für den Agenten, weist eine MAIP-konforme Agenten-ID zu und zeichnet den ursprünglichen Schlüssel im Schlüsselhistorien-Ledger auf. Neu registrierte Agenten beginnen mit dem Status active und einem anfänglichen Vertrauenswert von 0.500.
Die Anzahl der Agenten, die Sie registrieren können, hängt von Ihrem Abrechnungsplan ab. Wenn Sie Ihr Planlimit überschreiten, gibt die API 402 Payment Required zurück. Kontaktieren Sie den Vertrieb für Agentenlimits der Enterprise-Stufe.

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 im Format maip:<tenant8>:<ulid>. Verwenden Sie diesen Wert in allen nachfolgenden API-Aufrufen, die diesen Agenten referenzieren.
string
UUID des besitzenden Mandanten.
string
Der registrierte Agententyp.
string
Menschenlesbarer Agentenname.
string
Agentenbeschreibung, falls vorhanden.
string
Anfängliches Vertrauensniveau. Neu registrierte Agenten beginnen bei "authenticated".
number
Numerischer Vertrauenswert (0,0 bis 1,0). Neu registrierte Agenten beginnen bei 0.500.
string
Lebenszyklusstatus des Agenten. Bei der Erstellung immer "active".
string
Base64url-kodierter Ed25519-Public-Key, der für diesen Agenten generiert wurde. Speichern Sie diesen sicher zur Signaturprüfung.
string
Eindeutiger Identifikator für den Signierschlüssel des Agenten. Referenziert in Belegen und Bestätigungen.
string[]
Die dem Agenten zugewiesenen effektiven Scopes.
object
Das Metadatenobjekt, falls vorhanden.
number
Aktuelle Tiefe der Delegationskette. Immer 0 für direkt registrierte Agenten. Maximale Tiefe ist 8 pro MAIP-Protokoll.
string
UUID des Benutzers, der den Agenten registriert hat, falls über Benutzer-Token authentifiziert.
string
Ablaufzeitstempel, falls festgelegt.
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

Body

application/json
display_name
string
erforderlich

Menschenlesbarer Agentenname

Maximum string length: 256
agent_type
enum<string>

Klassifizierung des Agenten

Verfügbare Optionen:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
description
string

Freitextbeschreibung des Agentenzwecks

expires_at
string<date-time> | null
metadata
any

Beliebige Schlüssel-Wert-Metadaten

scopes
string[]

Dem Agenten gewährte Berechtigungsumfänge

Antwort

Agent registriert

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>