Connect tools & data

API-Verbindungen

Machen Sie jede HTTP-API zu einer Funktion, die Ihr Agent mitten im Gespräch aufrufen kann: Fügen Sie einen cURL-Befehl ein, und der Assistent erstellt die Tool-Definition, Parameter und Authentifizierung.

API-Verbindungen sind benutzerdefinierte HTTP-Funktionen, die Ihre Agenten während eines Gesprächs aufrufen können — eine Bestellung nachschlagen, ein Ticket erstellen, den Kontostatus aus Ihrem eigenen Backend abrufen. Sie definieren den Endpunkt einmal unter Verbindungen → APIs (/dashboard/api-connections); Agenten, denen die Verbindung zugeordnet ist, können sie dann aufrufen, wenn das Gespräch es erfordert.

Es gibt zwei Möglichkeiten, eine Verbindung zu erstellen: Fügen Sie etwas ein, das der Assistent analysieren kann, oder richten Sie die Verbindung manuell ein.

Der schnelle Weg: einfügen und analysieren#

1. Klicken Sie auf Neue API-Verbindung

   Der Dialog wird im Assistenten geöffnet. Fügen Sie einen Beispielbefehl für cURL, eine OpenAPI/Swagger-Spezifikation, einen Postman-Export, eine TypeScript- Schnittstelle oder ein Zod-Schema in das Feld ein.

2. Klicken Sie auf Analysieren

   ThunderPhone leitet die gesamte Verbindung aus Ihrem eingefügten Inhalt ab — URL, Methode, Header und ein Parameterschema, das aus den gefundenen Abfrageparametern und dem Request-Body erstellt wird. Eingefügte Header (einschließlich Authentifizierungsheader) werden in die Endpunktkonfiguration übernommen.

3. Bestätigen Sie die hervorgehobenen Felder

   Die abgeleitete Konfiguration wird mit den zur Überprüfung hervorgehobenen geschätzten Feldern geöffnet. Passen Sie Namen, Beschreibungen und Parametertypen an, damit der Agent versteht, wann und wie die Funktion aufgerufen wird — die Beschreibung wird vom Modell gelesen.

4. Validieren & Speichern

   Beim Speichern wird zuerst eine Live-Testanfrage an Ihren Endpunkt ausgeführt. Wenn die Anfrage fehlschlägt, wird die Verbindung nicht gespeichert — korrigieren Sie URL, Authentifizierungsheader oder Body und versuchen Sie es erneut. Bei Erfolg wird die Verbindung mit dem Badge Validiert gespeichert.

Wenn der Assistent in Ihrem eingefügten Inhalt keine Anfrage-URL finden kann, wird dies angezeigt — fügen Sie einen vollständigen http(s)-Endpunkt ein und versuchen Sie es erneut.

Manuelle Einrichtung#

Klicken Sie im Assistenten auf Manuell einrichten → (oder auf Soll die KI dies ableiten? Assistenten ausprobieren →, um zurückzukehren). Der manuelle Editor enthält zwei Editoren:

• Visuell — Formularfelder für Anzeigename, Funktionsname, Anfrage- URL, Methode (POST, GET, PUT, PATCH, DELETE), benutzerdefinierte Header und das Parameterschema (Eigenschaft hinzufügen für jedes Argument, das der Agent bereitstellen kann).
• JSON — dieselbe Definition als reines JSON zum direkten Einfügen oder Feinabstimmen einer Tool-Spezifikation.

Über ein optionales Panel für Testanfragen können Sie die konfigurierte Anfrage vor dem Speichern ausführen und Status, Latenz sowie eine Antwortvorschau anzeigen. Validieren & Speichern führt diesen Test immer aus und speichert nur bei Erfolg.

Ihre Verbindungen verwalten#

Jede Verbindungszeile zeigt ihren Validierungsstatus — Validiert, Nicht getestet oder Fehler — ihren Funktionsnamen und die Agenten, die sie verwenden. Über das Aktionsmenü der Zeile können Sie:

• Bearbeiten — die Konfiguration erneut öffnen.
• Klonen — sie als Ausgangspunkt duplizieren (die Kopie ist zunächst nicht getestet).
• Versionsverlauf — frühere Versionen anzeigen und eine davon im Editor wiederherstellen.
• Übertragen — die Verbindung in eine andere Organisation kopieren oder verschieben, der Sie angehören. Beim Verschieben wird sie hier entfernt; Agenten, die sie verwendet haben, müssen möglicherweise neu konfiguriert werden.
• Löschen — dauerhaft; Agenten, die die Verbindung verwenden, müssen neu konfiguriert werden.

Mit einem Agenten verknüpfen#

Fügen Sie die Verbindung im Abschnitt für API-Verbindungen des Builders zu einem Agenten hinzu (Agenten erstellen). Die Liste zeigt, welche Agenten jede Verbindung verwenden, sodass Sie auf einen Blick erkennen können, welche Auswirkungen eine Änderung hat.

Nächste Schritte#