„Erledigt“ soll erledigt heißen: KI-Agenten sicher in weclapp

In einem unserer Agenten-Tests bekam ein KI-Agent eine einfache Aufgabe: die Kund:innen nach Umsatz ranken. Er fragte die Rechnungen mit dem Feld totalPrice ab. In weclapp heißt das Feld aber grossAmount. Die falsche Angabe fiel still unter den Tisch, der Agent bekam keine Beträge, bemerkte es nicht und holte jede Rechnung einzeln ab. Nach 14 Abrufen war sein Budget erschöpft, ein Ranking gab es nicht.

Ein Mensch hätte nach dem ersten leeren Ergebnis gestutzt. Ein Agent stutzt nicht.

Genau deshalb lassen wir KI-Agenten wals.pro AI 4 weclapp in echten Aufgaben durchspielen, bevor du damit arbeitest. Die weclapp API kennen wir aus unseren eigenen Produkten wie Fulfillment 4 weclapp und 4Fulfillment und aus Hunderten n8n-Workflows für weclapp-Kund:innen. Dieses Wissen steckt in den Leitplanken, mit denen KI-Assistenten wie Claude oder ChatGPT über wals.pro AI 4 weclapp in deinem weclapp arbeiten. Drei davon zeigen wir hier, und was du mitnimmst, falls du selbst einen Agenten an weclapp anbindest.

Klare Rückmeldung statt Stille

Modelle raten Feldnamen, das wird immer wieder passieren. Entscheidend ist, ob jemand widerspricht. Jemand aus dem Team schaut auf den Bildschirm und sieht, dass die Spalte leer ist. Ein Agent hat keinen Bildschirm. Er hat nur die Antwort, und eine Antwort ohne Fehler ist für ihn eine Antwort ohne Problem.

Deshalb verschwindet in wals.pro AI 4 weclapp kein Feld mehr kommentarlos. Fragt ein Agent ein Feld ab, das es nicht gibt, bekommt er das ausdrücklich gesagt, dazu den Verweis auf die vollständige Feldliste und als nächsten Schritt die Anweisung, die Abfrage mit dem richtigen Namen zu wiederholen, statt Datensätze einzeln zu holen. Bei einem Tippfehler wie grossAmout schlägt wals.pro AI den richtigen Namen gleich mit vor. Und weil der Agent verknüpfte Daten in derselben Abfrage mitladen kann, kommen Rechnungen und Kund:innen in einem Rutsch.

Eine Ausnahme ist Absicht: Zeigt ein Feld auf geschützte Daten, etwa auf hinterlegte externe Verbindungen, bekommt der Agent eine feste Erklärung und keinen Vorschlag, wie er doch noch hinkommt. Welche Fehler die weclapp API selbst laut meldet und welche still bleiben, zeigen wir in Die stillen Fehler der weclapp API.

Für dich heißt das: Ein Agent ist nur so gut wie die Rückmeldungen, die er bekommt. Alles, was still übergangen wird, muss jemand aussprechen.

Geprüft gegen das echte weclapp

Ein Agent schreibt, was er für richtig hält. Ob weclapp das genauso sieht, zeigt sich erst beim Speichern. Deshalb verlässt sich wals.pro AI 4 weclapp nicht auf Annahmen, sondern auf weclapp selbst.

Für jede Entität, in die wals.pro AI schreiben darf, gibt es einen festen Schreibvertrag: welche Felder Pflicht sind, welche erlaubt und welche Felder in Positionen stehen dürfen. Fehlt ein Pflichtfeld, etwa die Kund:in an einem Angebot, bekommt der Agent eine klare Fehlermeldung. Schickt er ein Feld, das der Vertrag nicht kennt, wird es ihm namentlich zurückgemeldet.

Damit die Verträge stimmen, läuft bei jeder Änderung ein automatischer Test: Jedes erlaubte Feld muss in der offiziellen Schnittstellenbeschreibung der weclapp API v2 wirklich existieren oder auf einer dokumentierten Ausnahmeliste stehen. Schreibwege prüfen wir zusätzlich live gegen ein weclapp-Testsystem.

Für dich heißt das: Vertrau keiner Vorschau, die weclapp nie gefragt hat. Ein echter Test gegen eine Sandbox ist mehr wert als jede Simulation.

Erst die Vorschau, dann deine Freigabe

Ein Agent handelt, sobald er glaubt, die Aufgabe verstanden zu haben. Deshalb schreibt bei wals.pro AI 4 weclapp kein Agent ungefragt.

Jede Änderung beginnt mit einer Vorschau: Das will ich ändern, an diesem Datensatz, mit diesen Werten. Die Vorschau geht an dich, zusammen mit der Anweisung an den Agenten, erst nach deiner ausdrücklichen Bestätigung auszuführen. Die Freigabe ist eine payload-gebundene Einmal-Freigabe per SHA-256. Sie gilt nur kurz, nur einmal und nur für genau diese Änderung, diesen Datensatz, deinen Mandanten und dich. Weicht beim Ausführen auch nur ein Wert von der Vorschau ab, ist sie ungültig. Jeder Schreibvorgang wird protokolliert.

Bei Belegpositionen geht wals.pro AI noch einen Schritt weiter: Nach dem Schreiben liest es die Positionen neu und prüft unter anderem, ob ihre Anzahl stimmt.

So behältst du die Kontrolle, und die KI nimmt dir trotzdem die Arbeit ab.

Für dich heißt das: Trenne, was ein Agent tun will, von dem, was er tut. Dazwischen gehört ein Mensch.

Grenzen kennen und sagen

Agenten wissen nicht, was eine API nicht kann. wals.pro AI 4 weclapp weiß es und sagt es dem Agenten.

Ein Beispiel sind Stücklisten. Legst du in weclapp einen Fertigungsauftrag für einen Artikel mit Stückliste über die API an, bleiben die Positionen leer: weclapp löst die Stückliste dabei nicht auf, und einen eigenen Endpunkt dafür gibt es weder in v2 noch in v3. Ein Agent ohne dieses Wissen würde den leeren Auftrag für fertig halten. In wals.pro AI bekommt er das Rezept mit: erst die Stückliste des Artikels lesen, dann jede Komponente mit ihrem Faktor übernehmen, und zwar 1:1, ohne selbst zu multiplizieren. Die Multiplikation macht weclapp.

Manches bieten wir auch bewusst nicht an, obwohl die API es könnte. Einen offenen Posten ohne Banktransaktion als bezahlt zu markieren wäre technisch möglich. In wals.pro AI bleibt das gesperrt, bis klar geregelt ist, wie so ein Schritt freigegeben werden muss. Deine Buchhaltung soll stimmen.

Für dich heißt das: Gib deinem Agenten mit, was nicht geht und wie es stattdessen geht. Ein ehrliches „So nicht, aber so“ ist mehr wert als ein falsches „Erledigt“.

Leitplanken gehören in die Integration, nicht in den Prompt

Alle drei Leitplanken haben denselben Kern. Einem Agenten fehlt der Blick auf die Oberfläche, und bei Unsicherheit rät er, statt zu fragen. Ein besserer Prompt ändert daran wenig. Was hilft, sind Regeln, die in der Integration sitzen: klare Rückmeldungen, Prüfungen gegen das echte weclapp, eine Freigabe vor jedem Schreiben und das Wissen um die Grenzen.

Christian Lanig von weclapp hat seinen Vortrag beim Community Day 2026 „Jeder Request zählt“ genannt. Für Agenten gilt das doppelt: Jeder Request zählt, und jede Antwort muss stimmen.

Weiter

Diese Leitplanken stecken in wals.pro AI 4 weclapp. Die KI schreibt nie ungefragt, sondern mit Vorschau, Freigabe und Protokoll. Du verbindest deinen KI-Assistenten mit deinem weclapp und arbeitest vom ersten Tag an mit genau den Regeln, von denen dieser Artikel erzählt: wals.pro AI 4 weclapp ausprobieren.

Planst du eine eigene Agenten-Integration oder willst du wissen, wie KI in deinem weclapp konkret helfen kann? Dann lass uns sprechen: wals.pro/termin. Mehr zur weclapp API selbst findest du in unserer Serie „weclapp API: Das Handbuch“, zum Beispiel in Die stillen Fehler der weclapp API.