Integrationen
Beliebige API verbinden
Nutze Dienste, die nicht im Katalog unter Konnektoren stehen – von öffentlichen APIs bis zu Diensten, die einen Schlüssel brauchen. Oder lege einen eigenen Konnektor an, mit dem die KI bauen kann.
Der Katalog unter Konnektoren enthält mehr als 100 Dienste. Deine App kann aber mit fast jedem Dienst arbeiten, der eine API hat (eine Möglichkeit, wie andere Software mit ihm sprechen kann). Diese Seite zeigt dir die drei Wege dafür, vom schnellsten bis zum am besten wiederverwendbaren.
| Deine Situation | Was du tun kannst |
|---|---|
| Die API ist öffentlich und braucht keinen Schlüssel | Bitte im Chat darum |
| Die API braucht einen Schlüssel, und du brauchst ihn nur in einer App | Lass die KI nach dem Schlüssel fragen. Er wird als Secret für diese App gespeichert |
| Du nutzt den Dienst in mehreren Apps oder willst, dass die KI ihn gut versteht | Lege auf der Seite Konnektoren deinen eigenen Konnektor an |
Egal, wofür du dich entscheidest: Schlüssel werden nur im Servercode deiner App verwendet. So landen sie nicht in den Browsern deiner Besucher.
Eine öffentliche API nutzen
Viele Dienste, zum Beispiel für Wetter, Feiertage oder offene Daten, brauchen gar keinen Schlüssel. Nenne den Dienst und sag, was du von ihm möchtest.
Zeig auf der Startseite eine 5-Tage-Wettervorhersage für die Stadt des Besuchers an. Nutze dafür die Open-Meteo API.
Wenn die KI Details zu einer API braucht, die sie nicht gut kennt, kopiere den passenden Teil der Dokumentation in den Chat. Zum Beispiel eine Beispielanfrage und die Antwort darauf. Oder hänge die Dokumentation als Datei an. Mehr dazu findest du unter Bilder und Dateien hinzufügen.
Eine API nutzen, die einen Schlüssel braucht
Wenn eine Funktion einen Schlüssel für einen Dienst braucht, der nicht im Katalog steht, zeigt dir die KI im Chat eine Schlüsselkarte. Darauf steht der Name, den sie verwenden wird, zum Beispiel ACME_API_KEY. Füge den Schlüssel ein und klicke auf Speichern. Oder klicke auf Überspringen, um ohne ihn weiterzumachen.
Die Karte sagt es dir deutlich: Der Schlüssel wird sicher und verschlüsselt gespeichert. Er erscheint nie im Chat oder im Code deiner App. Du kannst ihn später unter Verwalten → Secrets ändern (Teammitgliedern wird angezeigt, dass der Projektinhaber ihn ändern kann).
Füge ein Kontaktformular hinzu, das über die API unseres CRM einen neuen Lead anlegt. Frag mich nach dem API-Schlüssel.
Du kannst Schlüssel auch selbst hinzufügen, bevor du etwas fragst: Öffne den Tab Verwalten, wähle Secrets und lege unter Neues Secret hinzufügen eines an. Deine Vorschau übernimmt Änderungen automatisch. Deine veröffentlichte App bekommt sie beim nächsten Veröffentlichen. Mehr dazu findest du unter Secrets und API-Schlüssel.
Tippe Schlüssel nicht in eine Chatnachricht. Chatnachrichten werden mit deinem Projekt gespeichert. Nutze stattdessen die Schlüsselkarte oder Verwalten → Secrets.
Einen eigenen Konnektor anlegen
Wenn du einen Dienst in mehr als einer App nutzt oder willst, dass die KI seine API richtig versteht, füge ihn als eigenen Konnektor hinzu. Du beschreibst die API einmal. Danach funktioniert sie wie jeder Konnektor aus dem Katalog: Du verbindest sie mit deinem Schlüssel und schaltest sie pro App ein oder aus. Die KI kann damit bauen und beim Bauen daraus lesen.
Scrolle auf der Seite Konnektoren zu Deine eigenen Konnektoren und klicke auf Konnektor erstellen. Halte die API-Dokumentation des Dienstes bereit. Du brauchst die API-Adresse und musst wissen, wie der Dienst einen Schlüssel annimmt. In die Beschreibung selbst kommen keine Schlüssel. Mit deinem eigenen Schlüssel verbindest du dich am Ende.
Details
Trag unter Name einen Namen ein. Wenn du möchtest, füge eine Kurzbeschreibung für die Karte hinzu und Was er macht (das hilft der KI zu erkennen, wann sie den Konnektor nutzen soll). Wähle dann eine Kategorie, füge optional einen Link zur API-Dokumentation hinzu und such dir eine Farbe aus. Der Codename bestimmt die Namen der Einstellungen, die deine Apps lesen, zum Beispiel
ACME_CRM_API_KEY. Er lässt sich später nicht mehr ändern.Wie die Anmeldung funktioniert
Gib die API-Adresse ein, mit der jede Anfrage beginnt (sie muss mit
https://anfangen). Beantworte dann Wie prüft der Dienst, wer du bist?: Bearer-Token, API-Schlüssel im Header, API-Schlüssel in der Adresse oder Benutzername und Passwort. Wenn der Dienst mehr als einen Wert braucht, etwa eine Konto-ID, füge sie unter Braucht er mehr als einen Wert? hinzu. Eine Vorschau zeigt dir, So sieht eine Anfrage aus.Testanfrage
Wähle eine Anfrage, die nur liest und den Schlüssel braucht, zum Beispiel „Wer bin ich?“ oder „Meine Einträge auflisten“. Buildliy führt sie aus, um jeden Schlüssel vor dem Speichern zu prüfen. Sie darf also nichts verändern. Unter Ausprobieren (optional) kannst du einen Schlüssel einfügen und auf Testanfrage senden klicken, um die Antwort zu sehen. Dieser Schlüssel wird nur für den Test verwendet und nicht gespeichert, außer du verbindest dich danach damit.
Wer die Daten sieht
Wähle Nur ich – es ist persönlich für private Kontodaten (dein Postfach, deine Notizen oder deine Bank). Wähle Alle, die meine App nutzen – es ist geteilt für Daten, die für alle gedacht sind, zum Beispiel eine Produktliste oder öffentliche Angebote.
Hinweise für die KI
Füge optional die Teile der API-Dokumentation ein, die die KI kennen soll: Endpunkte, Beispielanfragen und Antworten. Gib jedem Hinweis unter Dateiname einen Namen und sag, wenn du magst, Wann soll die KI das lesen? Du kannst bis zu 10 Hinweise mit je 20.000 Zeichen hinzufügen. Die KI sieht den Anfang jedes Hinweises und liest den Rest, wenn sie ihn braucht. Füge hier nie Schlüssel ein.
Klicke auf Konnektor erstellen. Als Nächstes öffnet sich das Fenster zum Verbinden. Ein Schlüssel, den du unter Ausprobieren (optional) eingegeben hast, ist dort schon eingetragen. Gib deinen Schlüssel ein, falls nötig, und klicke auf Verbinden. Buildliy führt deine Testanfrage mit dem Schlüssel aus, bevor er gespeichert wird. Danach bleibt er verschlüsselt gespeichert. Er wird nur im Servercode deiner Apps verwendet.
Nutze meinen Acme-CRM-Konnektor, um auf einer Dashboard-Seite meine 20 neuesten Kontakte anzuzeigen, mit einem Suchfeld.
Jeder deiner eigenen Konnektoren hat eine Karte mit Verbinden (Verwalten, sobald sie verbunden ist, oder Neu verbinden, wenn der Schlüssel nicht mehr funktioniert), Bearbeiten und einem Löschen-Button. Beim Löschen werden der Konnektor und dein gespeicherter Schlüssel dafür entfernt. Apps, die ihn nutzen, können den Dienst dann nicht mehr erreichen, bis du ihn wieder hinzufügst. Du kannst bis zu 25 eigene Konnektoren haben.
Wenn du Nur ich – es ist persönlich gewählt hast, schützt die KI alles von diesem Dienst hinter der Anmeldung deiner App. Sobald die Verbindung steht, verhindert die Checkliste vor dem Start das Veröffentlichen, wenn der Code deiner App sie nutzt und die App keine Anmeldung hat. Hat die App eine Anmeldung, erinnert dich die Checkliste daran, dafür zu sorgen, dass sich nur du (oder die Leute, die du auswählst) anmelden können. Eine offene Registrierung würde nämlich jedem erlauben, die Daten zu sehen.
Ereignisse von einem Dienst empfangen
Manche Dienste können deiner App eine Nachricht schicken, wenn etwas passiert, zum Beispiel bei einer neuen Bestellung oder einer abgeschlossenen Zahlung. Diese Nachrichten nennt man oft Webhooks. Bitte die KI, in deiner App eine Stelle einzubauen, die sie empfängt. Wenn der Dienst dir ein Signatur-Secret gibt, mit dem du prüfen kannst, dass die Nachrichten echt sind, fragt die KI mit einer Schlüsselkarte danach.
Füge einen Webhook-Endpunkt hinzu, der Ereignisse zu neuen Bestellungen aus unserem Lagersystem empfängt und jede Bestellung in der Datenbank speichert.
Gib dem Dienst die Adresse deiner veröffentlichten App, nicht die der Vorschau, denn die Vorschau läuft nicht immer. Mehr dazu findest du unter Deine App veröffentlichen.
Verwandte Themen
Du kommst nicht weiter? Lies die FAQ oder schreib uns.