Eigene Schnittstelle anbinden

Für viele Systeme gibt es bei operanda einen fertigen Konnektor. Für alle anderen gibt es die eigene Schnittstelle: Hat ein System eine HTTP-API mit Schlüssel, bindest du sie selbst an. Die KI liest dazu die Doku des Anbieters und schreibt eine kurze Beschreibung, welche Aufrufe es gibt und was sie tun. Du fügst die Beschreibung beim Verbinden ein, zusammen mit dem Schlüssel.

Jede angebundene API ist danach ein Konto wie jedes andere: Du entscheidest, welche Projekte sie benutzen und was der Agent dort darf. Andere sehen sie nicht.

Was du vorher brauchst

Die Adresse der API muss mit https:// beginnen und aus dem Internet erreichbar sein. Server im eigenen Firmennetz gehen nicht.

Schritt 1: Beschreibung von der KI schreiben lassen

Öffne einen Chat und schreib zum Beispiel:

Nenn nur, was du wirklich brauchst. Zehn gut beschriebene Aufrufe bringen mehr als hundert, die keiner versteht.

Die Beschreibung sieht so aus:

json { "name": "Warenwirtschaft Müller", "basis": "https://api.example.de/v2", "anmeldung": { "kopf": "Authorization", "vorlage": "Bearer {schluessel}" }, "pruefung": { "pfad": "/me" }, "hinweise": "Kundennummern beginnen mit K-. Datumsangaben als 2026-10-13.", "operationen": [ { "name": "kunden_suchen", "art": "lesen", "methode": "GET", "pfad": "/kunden", "beschreibung": "Sucht Kunden nach Name oder Nummer. Liefert id, Name und Ort.", "query": { "suche": { "type": "string", "description": "Name oder Nummer, etwa Weber", "pflicht": true } } }, { "name": "auftraege_lesen", "art": "lesen", "methode": "GET", "pfad": "/kunden/{id}/auftraege", "beschreibung": "Listet die Aufträge eines Kunden.", "parameter": { "id": "Die Kundennummer aus kunden_suchen, etwa K-1001." } }, { "name": "auftrag_anlegen", "art": "aendern", "methode": "POST", "pfad": "/auftraege", "beschreibung": "Legt einen Auftrag an.", "koerper": { "type": "object", "properties": { "kunde": { "type": "string", "description": "Kundennummer" }, "text": { "type": "string", "description": "Was zu tun ist" } }, "required": ["kunde", "text"] }, "fest": { "koerper": { "status": "neu" } } } ] }

Was die Felder bedeuten:

Je Operation:

Die Art ist der wichtigste Teil. Sie muss stimmen:

• lesen: holt nur Daten. Immer ein GET.
• entwurf: legt etwas an, das noch nicht wirkt, etwa einen Rechnungsentwurf.
• aendern: legt an oder ändert, und das wirkt sofort.
• senden: geht nach draußen oder ist endgültig, etwa eine Mail verschicken oder eine Rechnung festschreiben.
• loeschen: löscht. Ein DELETE ist immer loeschen.

Ein Aufruf, der etwas Endgültiges tut, gehört zu senden, auch wenn er technisch nur ein POST ist. Schau dir diese Stellen an, bevor du verbindest.

Schritt 2: Konto verbinden

1. Konten, dann Konto verbinden, dann Eigene Schnittstelle.
2. Wem gehört das Konto?
   • Mir: Nur du entscheidest, welche Projekte es benutzen.
   • Der Firma: Die Leitung entscheidet, und das Konto bleibt, wenn du gehst. Diese Wahl sehen nur Inhaber und Verwaltung.
3. Die Beschreibung in das große Feld einfügen.
4. Den Schlüssel eintragen. Bei "art": "basic" dazu den Benutzer.
5. Verbinden. operanda prüft die Beschreibung und macht einen Probeaufruf mit dem Schlüssel. Erst wenn beides klappt, wird das Konto gespeichert, der Schlüssel verschlüsselt. Passt etwas nicht, nennt die Meldung die Stelle, etwa „operationen[2] (auftrag_anlegen): koerper beschreibt ein Objekt“. Diese Meldung kannst du der KI zurückgeben.
6. Bei „Wer soll es benutzen?“ die Projekte einschalten.

Ändern geht so: die geänderte Beschreibung mit gleichem name und gleicher basis neu verbinden. Das Konto wird ersetzt, Projekte und Rechte bleiben.

Schritt 3: Recht im Projekt einstellen

Im Chat sieht der Agent zuerst die Liste der Operationen und ruft sie dann über ein Werkzeug je Art auf. Das Werkzeug für Lesen erreicht keine schreibende Operation, egal wie sie heißt.

Prüfen, ob alles stimmt

Am Konto unter Mehr auf Verbindung prüfen tippen. operanda macht dann den Probeaufruf aus pruefung und ändert nichts. Danach im Chat des Projekts fragen „Was kann unsere Warenwirtschaft?“: Der Agent sollte die Operationen aufzählen.

Trennen unter Konten, die Schnittstelle öffnen, Trennen. Schlüssel und Beschreibung werden bei operanda gelöscht. Den Schlüssel selbst löschst du beim Anbieter.