Zum Hauptinhalt springen
POST
Tool registrieren

Tool registrieren

POST /v1/tools Registriert ein neues Tool im MAIP-Tool-Register des Mandanten. Tools repräsentieren externe Fähigkeiten (APIs, Funktionen, Dienste), die Maschinenagenten aufrufen können. Jedes Tool ist mit einem erforderlichen Geltungsbereich, einem Risikograd und einem optionalen Genehmigungs-Gate verbunden. Die Plattform erhöht das Risikoniveau automatisch auf "high", wenn der Toolname oder der erforderliche Umfang gefährliche Aktionsverben (schreiben, löschen, senden, ausführen, bereitstellen, zerstören, löschen, kürzen) enthält.
Werkzeugnamen müssen pro Mandant eindeutig sein. Der Versuch, ein Werkzeug mit einem Name, der bereits existiert, gibt 409 Conflict zurück.

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
UUID des neu registrierten Werkzeugs.
string
UUID des besitzenden Mandanten.
string
Maschinenlesbarer Toolname.
string
Menschenlesbarer Toolname.
string
Werkzeugbeschreibung.
string
Erforderlicher Bereich für den Aufruf.
string
Effektive Risikoklassifizierung (kann automatisch erhöht werden).
boolean
Ob eine menschliche Genehmigung erforderlich ist.
integer
Ratenbegrenzung pro Agent.
string
Werkzeugkategorie.
string
Werkzeugstatus. Bei der Erstellung immer "active".
object
Werkzeugmetadaten.
string
ISO 8601 Erstellungszeitstempel.
string
ISO 8601 Zeitstempel der letzten Aktualisierung.

Beispiel


Automatische Erhöhung des Risikolevels

Die Plattform scannt Toolnamen und Scope-Anforderungen nach gefährlichen Aktionsverben. Bei Erkennung wird das Risikoniveau automatisch erhöht: Tools mit dem Risikograd "critical" erfordern immer eine menschliche Genehmigung, unabhängig von der Einstellung requires_approval.

Autorisierungen

X-API-Key
string
header
erforderlich

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

Body

application/json
display_name
string
erforderlich
name
string
erforderlich

Eindeutiger Werkzeugname

scope_required
string
erforderlich
category
string
description
string

Menschenlesbare Toolbeschreibung

metadata
any
rate_limit_per_minute
integer
requires_approval
boolean
risk_level
string

Antwort

Tool registriert

tool_id
string<uuid>
name
string
description
string
schema
object
agent_id
string<uuid>
created_at
string<date-time>