HTTP-API als Werkzeug einrichten

Ein HTTP-API-Werkzeug lässt den Assistenten einen festen Endpunkt aufrufen — der Assistent füllt dabei nur die freigegebenen Parameter, nie die URL selbst. Eingerichtet wird das im Tab Administration → Konfigurierte Tools. Zur Einordnung siehe Konfigurierbare Werkzeuge — Überblick.

Schritt für Schritt

1. Basis-URL und Endpunkt festlegen — die feste Adresse, die das Werkzeug aufruft.
2. HTTP-Methode wählen. Die Methode bestimmt die Art des Werkzeugs: GET/HEAD gelten als Lesen, alle anderen Methoden (POST, PUT, PATCH, DELETE) als Schreiben.
3. Parameter definieren, die der Assistent füllen darf (Name, Typ, Pflicht/optional, Default).
4. Authentifizierung hinterlegen — Bearer-Token, API-Key oder Basic Auth. Die Zugangsdaten werden verschlüsselt gespeichert.
5. Limits (Timeout, Antwortgröße) setzen und mit der Test-Funktion prüfen, dann aktiv schalten und festlegen, ob das Werkzeug im Chat und/oder für Agenten verfügbar ist.

Sicherheitszusagen

• SSRF-Schutz mit Host-Pinning. Aufrufe sind auf den konfigurierten Host festgenagelt — der Assistent kann den Endpunkt nicht auf interne oder beliebige andere Adressen umbiegen.
• Verschlüsselte Zugangsdaten. Bearer/API-Key/Basic-Credentials werden verschlüsselt abgelegt.
• Fester Endpunkt. Der Assistent wählt nur Parameterwerte, nicht das Ziel.
• Admin-only.