Wenn ein Tool nicht im Katalog vorhanden ist, erstellen Sie Ihres. Eine eigene Integration ist ein benutzerdefinierter HTTP-Konnektor: Sie legen eine Basis-URL und eine Authentifizierungsmethode fest und beschreiben eine oder mehrere Aktionen, die die KI und Ihre Workflows aufrufen können – jede mit eigenem Methode, Pfad, Body-Template und Response-Mapping.
Öffnen Sie Integrationen in der Navigationsleiste und wechseln Sie zum Tab Eigene Aktionen. Admins verwalten dort eigene Integrationen mit einem vollständigen Aktionsvertrags-Editor; einmal gespeichert verhalten sie sich wie jedes andere verbundene Tool.
Jede eigene Integration beginnt mit einer Basis-URL (z. B. https://api.acme.com/v1) und einer Verbindungsmethode. Geheimnisse werden verschlüsselt gespeichert, auf Ihre Organisation beschränkt und nach dem Speichern nie im Klartext zurückgegeben.
| Authentifizierungsmethode | Übertragungsart |
|---|---|
Bearer-Tokenbearer | Sendet einen Authorization: Bearer <token> Header. |
API-Keyapi_key | Sendet den Key in einem von Ihnen benannten Header (z. B. X-Api-Key). |
Basic Authbasic | Base64-kodiert Benutzername und Passwort / Geheimnis. |
Service-Accountservice_account | Service-Account-Credential für Server-zu-Server-Zugriff. |
Keinenone | Keine Authentifizierung – für öffentliche oder vorautorisierte Endpunkte. |
Jede Aktion ist ein deklarativ beschriebener HTTP-Aufruf. Der Aktionsvertrags-Editor erfasst alles, was der Executor benötigt, um die API aufzurufen und die Antwort zu strukturieren:
| Teil einer Aktion | Zweck |
|---|---|
| Methode | GET, POST, PUT, PATCH oder DELETE. |
| Pfad | Wird an die Basis-URL angehängt. Unterstützt {{placeholders}} aus den Aktionseingaben. |
| Body-Template | Ein Request-Body mit {{placeholders}}, die aus den Aktionseingaben befüllt werden (für Schreibmethoden). |
| Response-Mapping | Extrahiert Felder aus der JSON-Antwort in eine saubere, vorhersehbare Ausgabeform. |
| Lesen / Schreiben | Markiert die Aktion als schreibgeschützt oder als Schreibaktion (erstellen/aktualisieren/löschen). |
| Bestätigung erforderlich | Wenn aktiviert, wartet die KI auf Ihre Genehmigung, bevor die Aktion im Chat ausgeführt wird. |
Geben Sie einen klaren Namen und eine Beschreibung an, damit die KI weiß, wann sie die Aktion verwendet.
Wählen Sie GET / POST / PUT / PATCH / DELETE und den Pfad, und verwenden Sie {{placeholders}} für Eingaben.
Schreiben Sie für Schreibmethoden ein Body-Template mit {{placeholders}}, die der Executor aus den Eingaben befüllt.
Extrahieren Sie die relevanten Felder aus der JSON-Antwort in eine saubere Ausgabeform.
Markieren Sie Erstell-/Aktualisierungs-/Löschaktionen als Schreibaktionen und entscheiden Sie, ob sie im Chat eine Bestätigung benötigen.
Zum Schutz Ihrer APIs und der Plattform sind eigene Aktionen auf 10 Aufrufe pro Minute und Aktion begrenzt (gleitendes Einminutenfenster). Weitere Aufrufe werden mit einem Rate-Limit-Fehler abgelehnt, bis das Fenster sich zurücksetzt.
Markieren Sie eine Aktion, die Daten erstellt, aktualisiert oder löscht, als Schreiben und aktivieren Sie Bestätigung erforderlich, damit die KI vor der Ausführung im Chat auf Ihre Genehmigung wartet – dieselbe Sicherheitsschranke, die Standard-Schreibaktionen verwenden.
Einmal definiert, ist eine eigene Integration überall erreichbar, wo ein Werkzeug verwendet werden kann:
# anhängen oder als Werkzeug aufrufen.Eigene Integrationen sind der Weg, einen internen Service, eine Nischen-SaaS oder eine Partner-API zu verbinden. Definieren Sie die Aktion und ihren Vertrag einmalig und nutzen Sie sie in Chat und Workflows wieder. Für Ein-Klick-Anbieter siehe Standard-Integrationen.