Custom-API-Tools
Die Integration, mit der du alles anbindest, richte einen Agenten auf eine beliebige REST-API aus und verwandle ihre Endpunkte in Tools, die er aufrufen kann.
Custom-API-Tools sind AnyBots Ansatz, mit dem sich alles anbinden lässt. Wenn ein System keine eingebaute Integration auf dieser Seite hat, richte stattdessen einen Agenten auf seine REST-API aus: Gib ihm eine Basis-URL, wähle die Endpunkte, und jeder wird zu einem Tool, das der Agent mitten in der Unterhaltung aufrufen kann, um Daten abzurufen oder eine Aktion auszulösen, ohne eigenen Code.
Wann du darauf zurückgreifst
- Keine eingebaute Integration deckt das System ab, ein interner Dienst, ein Nischen-SaaS oder dein eigenes Backend.
- Du stellst bereits eine REST-API (oder eine OpenAPI/Swagger-Spezifikation) bereit und möchtest, dass der Agent sie nutzt.
- Du möchtest, dass der Agent Live-Daten liest oder eine Aktion auslöst, die hinter deinem eigenen Endpunkt liegt.
Wenn bereits eine erstklassige Integration existiert, CRM, Commerce, Notion, Websuche, greife zuerst zu dieser. Sie wird für dich gepflegt und ist bereits datenschutzbewusst, sodass du die Einrichtung von Schema und Authentifizierung überspringst.
Wie es sich verbindet (die Kurzfassung)
- Öffne Integrationen, wähle Custom API und gib ihm eine Basis-URL.
- Importiere eine OpenAPI/Swagger-Spezifikation (per URL oder Einfügen), um Endpunkte automatisch zu erkennen, oder konfiguriere die Tools von Hand.
- Lege die Authentifizierung fest, Bearer, Basic, API Key oder keine.
- Wähle, welche Endpunkte du freigibst, teste jeden im integrierten Panel und dann Verbinden.
Der entscheidende Haken: Der Agent erreicht nur das, was du freigibst. Beim Import einer Spezifikation werden alle gefundenen Endpunkte aufgelistet, aber nur die, die du auswählst, werden zu Tools, und ein erneutes Parsen der Spezifikation später übernimmt API-Änderungen, ohne dass du von Grund auf neu bauen musst.
Öffentlich vs. privat, pro Tool
Eingebaute Integrationen kommen mit einer festen Aufteilung public-safe/owner-only. Custom-Tools drehen das um: Du wählst die Sichtbarkeit pro Tool, Public (public-safe, ein Website-Besucher kann es auslösen), Private (owner-only, nur interne Kanäle) oder Both. Mache sichere, schreibgeschützte Abfragen zu Public; halte alles, was schreibt oder sensible Daten berührt, auf Private.
Da Tools pro Instanz definiert werden, gibt es keine feste Liste und keine feste Anzahl, die Oberfläche ist genau das, was du baust.
Praxisbeispiel
Deine Bestellungen liegen in einem internen Dienst ohne eingebaute Integration. Du richtest ein Custom-API-Tool auf https://api.internal.example.com aus, importierst dessen OpenAPI-Spezifikation und gibst einen einzigen schreibgeschützten Endpunkt, get_order_status, als Public-Tool frei. Ein Besucher fragt „Wo ist Bestellung 4821?“ und der Agent ruft ihn auf und antwortet mit dem Live-Status. Den Erstattungs-Endpunkt hältst du auf Private, sodass nur mitarbeiterseitige Kanäle ihn erreichen können.
Grenzen
- Nur ausgehend. Der Agent ruft deine API auf; deine API ruft den Agenten nicht auf.
- Der Agent verwendet die Anmeldedaten, die du konfigurierst; er kann niemals über das hinausgehen, was dieser API-Schlüssel darf.
- Das Entfernen der Integration löst nur die Tools ab, an deiner externen API werden keine Änderungen vorgenommen.
Fehlerbehebung
- Die Spezifikation lässt sich nicht parsen. Stelle sicher, dass sie gültiges OpenAPI/Swagger und erreichbar ist; füge den Rohinhalt ein, wenn die URL geschützt ist.
- Authentifizierung fehlgeschlagen. Prüfe erneut den Token, sein Präfix und ob der Schlüssel in einen Header oder einen Query-Parameter gehört.
- Der Agent ruft das Tool nicht auf. Stelle sicher, dass der Endpunkt ausgewählt/freigegeben ist und seine Sichtbarkeit zum Kanal passt, ein Private-Tool wird auf einem öffentlichen KI-Agenten nicht ausgelöst.
FAQ
Muss ich Code schreiben? Nein. Binde eine REST-API per Spezifikation oder von Hand an, kein Code erforderlich.
Kann es jede API aufrufen? Jeden erreichbaren HTTP-REST-Endpunkt, bei dem du dich authentifizieren kannst.
Wie viele Tools kann ich definieren? Es gibt keine feste Anzahl, baue so viele, wie du brauchst.
Nächste Schritte
Commerce (WooCommerce und Website-Crawl)
Synchronisiere deinen WooCommerce-Katalog oder crawle deine Website, sodass der Agent in einer Unterhaltung echte, vorrätige Produkte empfiehlt und Preise dazu nennt. Nur Synchronisierung, nicht transaktional. Shopify-Storefronts verbindest du im Integrations Store.
Social
Ein einziger Content-Kreislauf, plane, erstelle, veröffentliche, analysiere und interagiere über deine Social-Netzwerke hinweg, mit der Markenstimme deines Agenten.