maesn
Use Case

KI-Agenten mit Datenzugriff auf das Hauptbuch, über das sie urteilen

Agentenbasierte Produkte entscheiden zur Laufzeit, was sie fragen, und genau das macht sie nützlich und ihre Eingaben tragend. Maesn gibt Ihrem Agenten eine Form für Kunden, Rechnungen, Eingangsrechnungen, Konten und Buchungen, aus welchem Buchhaltungssystem jeder Ihrer Kunden sie auch führt.

Was Ihr Agent entscheidet

Welche Kosten das sind, zu welcher Periode sie gehören, was die Zahl bedeutet, wie die Antwort zu formulieren ist.

liest es, rät es nicht
Was er nie erfinden darf
  • Welche Konten es gibt
  • Welche Steuersätze gelten
  • Welche Dimensionen es gibt
Diese Software-Teams vertrauen uns
HubSpotTipaltiPaywiseRallyQredNordhealthFindityFintoClockinHEROHolviLanes & PlanesAgicapHubSpotTipaltiPaywiseRallyQredNordhealthFindityFintoClockinHEROHolviLanes & PlanesAgicap
Das Problem

Ihr Agent fragt zur Laufzeit, der Endpunkt stand lange vorher fest

Der Vorteil eines Agenten ist, dass niemand vorab entschieden hat, welche Frage er stellt. Die Systeme, die er fragt, sind auf der gegenteiligen Annahme gebaut.

Jeder Listen-Endpunkt der API, danach geordnet, was man ihn fragen darf
11
Nichts zum Eingrenzen
Positionen, Belege, Projekte, Einheiten
12
Nur eine Frage
Was sich seit der letzten Frage geändert hat
13
Mehr als das
Rechnungen, Eingangsrechnungen, offene Posten, Kunden
Und eine Sortierung ist noch seltener: von den sechsunddreißig Endpunkten nehmen drei eine an. Gezählt aus den veröffentlichten Parameterblöcken der API-Referenz, ohne die Paginierung, ohne die zwei, die auswählen, wessen Bücher gelesen werden, und ohne den Rohdaten-Schalter, weil keiner davon entscheidet, welche Datensätze zurückkommen.

Das ist die Zahl hinter einem Satz, zu dem die Plattform immer gestanden hat. Filtern, Sortieren und Paginieren werden unterstützt, wo das System darunter sie unterstützt, und was jeder Endpunkt annimmt, ist veröffentlicht statt angedeutet. Zusammengezählt hatte es niemand, und zusammengezählt sagt es etwas Bestimmtes über agentenbasierte Produkte: für die meisten Objekte ist die einzige Frage, die Sie auf die Leitung geben können, was sich seit Ihrer letzten Abfrage geändert hat. Gesagt zu bekommen statt zu fragen ist noch seltener, denn ein Ereignis gibt es nur dort, wo das System darunter eines sendet, und solche Systeme sind in diesem Markt in der Minderheit.

Für eine klassische Integration ist das ein Ärgernis, um das Sie einmal herumprogrammieren. Für einen Agenten ist es Architektur, denn genau die Flexibilität, die Ihr Produkt verkauft, ist das, was die Leitung nicht tragen kann. Der Ausweg ist keine reichere Abfragesprache, sondern eine andere Aufteilung: breit über ein Modell lesen, das Gelesene halten und den Agenten darauf flexibel sein lassen. Das einheitliche Modell macht den breiten Lesezugriff bezahlbar, denn derselbe Aufruf und dieselben Feldnamen funktionieren auf jedem System, das Ihre Kunden einsetzen, statt auf je einem Dialekt.

Die zweite Hälfte des Problems ist leiser und teurer. Ein Modell, das buchen soll, liefert eine Kontonummer, einen Steuersatz und eine Kostenstelle, ob man ihm nun gesagt hat, welche es gibt, oder nicht, denn eine plausible Antwort zu erzeugen ist seine Aufgabe. In einem Chatfenster ist eine plausible Antwort eine schlechte Antwort. In einem Buchhaltungssystem ist sie eine Buchung.

Wie Maesn das löst

Jedes Schreibrezept liest zuerst das Vokabular des Kunden selbst

Keine Regel, die wir erfunden hätten. Vier der sechzehn dokumentierten Rezepte beginnen mit denselben drei Lesezugriffen, bevor sie überhaupt einen Schreibvorgang beschreiben, und zwei weitere beginnen mit zweien davon.

zuerst gelesenBei allen vier Rezepten unten
Welche Konten es gibt

Der eigene Kontenrahmen dieses Kunden, kein Standardrahmen

Welche Steuersätze gelten

Die Steuersätze, die in genau dieser Installation eingerichtet sind

Welche Dimensionen es gibt

Kostenstellen und worauf ihre Buchungen sonst zeigen

Dann
Eine Ausgabe buchen

Ein Schreibvorgang, der das Konto, den Satz und die Dimension trägt, die die Lesezugriffe zurückgaben.

Dann
Eine Buchung schreiben

Beginnt mit einem vierten Lesezugriff, den die anderen nicht haben: in welche Journale eine Buchung darf.

Dann
Eine Verbindlichkeit ausgleichen

Zwei Schreibvorgänge statt einem: einmal die Eingangsrechnung selbst, und einmal die Zahlung darauf.

Dann
Eine Forderung ausgleichen

Die Rechnung oder ein Vorschlag zur Prüfung, dann die Zahlung, die sie ausgleicht.

Als Anforderung gelesen ist das unauffällig, denn es ist, was korrekte Buchführung schon immer gebraucht hat: Sie buchen auf ein Konto, das es gibt, zu einem Satz, den diese Installation verwendet, gegen eine Dimension, die dieser Kunde wirklich führt. Als Anweisung an einen Agenten gelesen ist es das ganze Design. Der Erdungs-Lesezugriff ist der Schritt, der aus dem Vorschlag eines Modells etwas Prüfbares macht, und er ist der Schritt, den ein Produkt unter Zeitdruck weglässt, denn eine fest verdrahtete Kontonummer funktioniert beim ersten Kunden.

Was eine vereinheitlichte Schicht hier ändert, ist nicht, dass es den Schritt gibt, sondern dass es überall derselbe Schritt ist. Ein Aufruf gibt den Kontenrahmen zurück, ob Ihr Kunde in DATEV Rechnungswesen bucht oder in etwas ganz anderem, und die Feldnamen kommen aus einem Datenmodell statt aus dem Vokabular des jeweiligen Herstellers. Ihr Produkt setzt also “die Bücher dieses Kunden lernen” einmal um, und einen Kunden auf einem System anzubinden, das Sie nie gesehen haben, ist eine Verbindung und kein Projekt.

Zu welchem Ihrer Kunden ein Aufruf gehört, ist darunter geklärt, durch die Verbindung, die jeder von ihnen freigegeben hat, und deshalb fasst ein Agent nie die Zugangsdaten von jemandem an und reicht nie weiter, als die Person reichen könnte, die den Zugriff erteilt hat.

Was Sie bekommen

Ein anspruchsvoller Client, und eine Anbindung, die ihm standhält

Agentenbasierte Produkte lesen mehr als formularbasierte, und sie lesen stoßweise, weil aus einer Nutzerfrage ein Dutzend Abfragen werden können, bevor eine Antwort dasteht.

Was ein Agent tut
Fragt viel auf einmal

Eine einzelne Frage kann sich in viele Lesezugriffe auffächern, und die verlassen Ihr Backend gemeinsam und nicht höflich verteilt.

eines nach dem anderen, je Mandant
Was das System erreicht
Eine einzige Reihe

Anfragen eines Mandanten erreichen das Zielsystem nacheinander, und eine Token-Auffrischung darunter kann deshalb nicht überholt werden.

Das Verhalten rechts ist aus einem bestimmten Grund dokumentiert und nicht als allgemeines Versprechen. Mehrere Zielsysteme brechen die Authentifizierung ab, wenn parallele Anfragen eintreffen, während ein Token erneuert wird, und eine erneute Freigabe ist kein Wiederholungsversuch, sie ist die Bitte an Ihren Kunden, sich noch einmal zu verbinden. Die Reihung je Mandant ist das, was aus einem Stoß keinen solchen Anruf werden lässt. Mehr tut sie nicht: die eigenen Ratenbegrenzungen des Zielsystems gelten weiterhin, und eine Ablehnung erreicht Sie als eigene Kategorie und nicht als allgemeiner Fehlschlag.

Der Rest des Ergebnisses ist das, was Sie nicht mehr bauen. Eine Form für eine Rechnung über jedes System im Verzeichnis, ein Freigabeablauf, eine Stelle, an der die jährliche brechende Änderung eines Herstellers aufgefangen wird. Für ein agentenbasiertes Produkt ist das keine Bequemlichkeit, sondern die Frage, wohin das Team geht: jede Woche, die für fremde Paginierung draufgeht, ist eine Woche, die nicht in das Modell fließt, wegen dem die Kunden das Produkt gekauft haben. Wo ein Schreibvorgang nicht sofort verarbeitet werden kann, wird daraus eine Aufgabe, die Sie zur Bestätigung abfragen, “ist es angekommen” bleibt also eine beantwortbare Frage.

Referenzen

Produkte mit einem Modell im Kern laufen bereits darauf

Veröffentlichter Kunde

Finto hat eine produktionsreife DATEV-Integration in Tagen ausgeliefert.

“Maesn hat uns ermöglicht, eine produktionsreife DATEV-Integration innerhalb von Tagen zu starten, und gibt unserer KI damit strukturierte Finanzdaten und unseren Kunden ein reibungsloses Onboarding.”
Linus Boehm
CTO, Finto

Rally ist die zweite, und die eigene Seite beschreibt die Form gut genug, dass wir es nicht tun müssen: Belege kommen aus dem Feld, Rally AI zieht die Felder heraus, ordnet Zahlungen zu und korrigiert Fehler, und was das Hauptbuch des Kunden erreicht, ist bereits strukturiert. Wie ihr CTO dorthin gekommen ist, steht in der Rally Case Study, und zu übernehmen ist daraus die Reihenfolge und nicht das Adjektiv: das Modell fällt das Urteil, die Anbindung liefert, und keines von beiden soll die Aufgabe des anderen erledigen.

Beide sind das, was die Branchensicht eine Weiterentwicklung von SaaS nennt und keine Kategorie daneben, und für den Markt vertikaler Software als Ganzes steht dieses Argument auf der Seite für SaaS-Plattformen. Keines von beiden veröffentlicht eine Zahl zu dieser Anbindung, und hier wird keine erfunden.

Die Eckdaten

Was ein Agent erreicht, je Objekt gezählt

Die Zeilen sind die Objekte, die die dokumentierten Rezepte nennen, keine Auswahl. Die Reichweite gilt je Objekt und nicht je System, also entscheidet die schmalste Zeile, auf die Ihr Workflow angewiesen ist, über Ihre Roadmap.

Über die 30+ angebundenen Systeme
Was Sie brauchenHeuteAuf AnfrageSystem kann es nicht
Welche Konten dieser Kunde hat1982
Welche Steuersätze diese Installation nutzt12143
Kostenstellen und andere Dimensionen3179
In welche Journale eine Buchung darf5159
Rechnungen, zum Nachdenken13142
Eingangsrechnungen, zum Nachdenken8174
Eine Buchung schreiben10118
Eine Ausgabe buchen7193
Einen Vorschlag zur Prüfung übergeben10172
Zur Bauzeit aus der Dokumentation je System abgeleitet, nie von Hand geschrieben. Die drei Spalten bleiben mit Absicht getrennt: was die Dokumentation als auf Anfrage verfügbar markiert, ist eine Markierung und keine Zusage, dass es sich einschalten lässt, und es als eine darzustellen wäre eine Aussage, die niemand gemacht hat.

Die Form dieser Tabelle ist das Argument. Die Lesezugriffe, die ein Agent braucht, um geerdet zu sein, sind nicht die breitesten Zeilen, sie gehören zu den schmalsten, und das ist das Gegenteil dessen, was eine Roadmap annimmt, wenn sie die Erdung als Einrichtung behandelt und den Schreibvorgang als den schweren Teil. Zu wissen, welches der Systeme Ihrer Kunden welche dieser Zeilen beantwortet, ist eine Frage der ersten Woche, und sie lässt sich vor dem Bauen beantworten, und das ist der einzig nützliche Zeitpunkt, sie zu stellen. Wo die Installation eines einzelnen Kunden ein Feld trägt, das das Modell nicht hat, ist für dieses eine Feld am Modell vorbeizugreifen ein dokumentierter Weg und keine Abzweigung Ihrer Integration.

Dieselbe Disziplin gilt für das, was Ihr Agent einem Nutzer zurückmeldet. Ein Schreibvorgang kann gelingen und trotzdem nicht alles tun, worum Sie gebeten haben, wenn ein Zielsystem ein Feld still übergeht, das es nicht führt, und die Antwort sagt das über eine Warnung neben dem Ergebnis. Das dorthin zu bringen, wo ein Mensch es sieht, ist der Unterschied zwischen einem Agenten, dem vertraut wird, und einem, der bloß zuversichtlich ist.

Wo unsere Aufgabe endet

Wir machen die Daten lesbar, das Urteil bleibt Ihr Produkt

In diesem Use Case lässt sich die Grenze ungewöhnlich leicht benennen, denn was auf Ihrer Seite liegt, ist der ganze Grund, aus dem Ihre Kunden sich für Sie entschieden haben.

Was Maesn aufnimmt
  • Anmeldung und Token je Kunde
  • Ein Wortschatz für jedes Objekt
  • Die Schreibform jedes Systems
  • Ihre jährlichen Bruchstellen
Was Ihr Produkt bleibt
  • Was das Modell schließt
  • Auf welches Konto eine Zeile gehört
  • Wann ein Mensch freigeben muss
  • Der Nachweis dessen, was Ihr Agent tat

Die letzte Zeile rechts überrascht die Leute, und sie folgt aus der Architektur und nicht aus einer Lücke darin. Weil auf dem Weg nichts gespeichert wird, liegt hier keine Kopie der Bücher Ihrer Kunden und ebenso wenig ein Protokoll dessen, was Ihr Agent vorgeschlagen hat. Was Maesn hält, ist, dass ein Aufruf stattfand, zu welchem System, unter der Anbindung welches Kunden und wann. Die Begründung, der Prompt, die Version des Modells und die Person, die zugestimmt hat, bleiben bei Ihnen, und bei einem Agenten, der auf Finanzdaten handelt, sind sie die Hälfte, nach der ein Prüfer tatsächlich fragt. Die andere Hälfte, wie die Übertragung selbst geschützt und zertifiziert ist, ist dieselbe Haltung, auf der die übrige Plattform läuft, und nichts, was diese Anbindung schwächt.

Die Zeile darüber ist dasselbe Prinzip eine Ebene tiefer. Die Dokumentation legt die Kategorisierungslogik in Ihre Anwendung, und dort muss sie sitzen: nichts Gemeinsames könnte wissen, dass einer Ihrer Kunden einen Tankbeleg gegen ein anderes Konto bucht als der nächste. Das einmal für alle zu entscheiden hieße, an ihrer Stelle zu wählen, wie ihre Bücher geführt werden, und das ist eine Entscheidung, die ihnen und ihrem Steuerberater gehört. Fehler teilen sich entlang derselben Linie, und von welcher Seite eine Ablehnung kam, ist das Erste, worauf die Behandlung eines Agenten verzweigen sollte.

Im Alltag zeigt sich das in der Entwicklungs-Roadmap, und deshalb holen meist Produkt- und Entwicklungsteams diese Anbindung ins Haus, und die Begründung ist jedes Mal dieselbe: die Integrationen waren nie das Produkt. Soll Ihr Agent über einen Assistenten arbeiten, den ein Kunde ohnehin nutzt, und nicht nur über Ihre eigene Oberfläche, dann ist die Protokollseite davon der MCP Server, der auf derselben API läuft.

KI-Agenten FAQ

Häufige Fragen

Worin unterscheidet sich das von Ihrem MCP Server?

Dadurch, wer die Sache in der Hand hält. Der MCP Server ist dafür da, einen Assistenten anzubinden, den jemand anderes gebaut hat, etwa Claude: Sie richten einen Client ein und stellen Fragen in einem Chatfenster. Diese Seite ist für ein Unternehmen, dessen eigenes Produkt der Agent ist, bei dem die Aufrufe aus Ihrem Backend im Auftrag jedes Ihrer Kunden kommen und niemand ein Chatfenster öffnet. Unter beidem liegt dieselbe Unified API, und deshalb lesen sich Abdeckung und Sicherheitsmodell auf beiden Seiten gleich.

Was muss ein Agent lesen, bevor er überhaupt buchen kann?

Den eigenen Wortschatz des Kunden, und die dokumentierten Rezepte sagen es ausdrücklich: welche Konten es gibt, welche Steuersätze gelten und auf welche Dimensionen gebucht wird, bevor überhaupt ein Schreibvorgang beschrieben wird. Das sind die Werte, die ein Modell sonst erfindet, und eine erfundene Kontonummer ist der Fehler, den niemand bemerkt, bis ein Abgleich ansteht. Konten und Steuersätze sind heute auf den meisten angebundenen Systemen lesbar und Dimensionen auf weniger, und der Rest ist überwiegend als auf Anfrage verfügbar markiert und nicht als nicht unterstützt. Welche davon Ihr Kunde hat, ist eine Antwort je System, und die Systemseite trägt sie Objekt für Objekt.

Können wir die Daten so abfragen, wie unser Agent danach fragt?

Nicht auf der Leitung, und es lohnt sich, die Form davon zu kennen, bevor Sie darum herum entwerfen. Manche Listen-Endpunkte veröffentlichen nichts zum Eingrenzen, manche nur einen Weg, nach dem zu fragen, was sich seit Ihrem letzten Aufruf geändert hat, und nur wenige nehmen eine Sortierung an. Der flexible Teil gehört deshalb in Ihr Produkt: breit über ein Modell lesen, das Gelesene halten und den Agenten darauf flexibel sein lassen statt auf der Abfragefläche jedes einzelnen Herstellers.

Wie bekommt ein Agent Zugriff auf das Buchhaltungssystem unseres Kunden?

Ihr Kunde gibt die Anbindung einmal frei, an das System, in dem seine Buchhaltung ohnehin liegt, und jeder spätere Aufruf läuft unter dieser Freigabe und nicht unter einem zentralen Dienstkonto von Ihnen. Zu welchem Kunden und zu welcher seiner Firmen ein Aufruf gehört, entscheidet der Account-Key an der Anfrage. Nichts wird zentral nachgebaut, eine Einschränkung, die es in seinem System gibt, gibt es also auch über diese Anbindung.

Speichern Sie die Finanzdaten unserer Kunden oder trainieren Sie etwas damit?

Weder noch, und das Zweite folgt aus dem Ersten. Nichts, was die Bücher Ihrer Kunden enthalten, kommt hier zur Ruhe: der Aufruf erreicht das System, das sie freigegeben haben, die Antwort wird auf dem Rückweg in eine Form gebracht, und damit ist es vorbei. Es gibt deshalb auch im Grundsatz keinen Korpus zum Trainieren. Für ein KI-Produkt nimmt das die Frage weg, an der eine Compliance-Prüfung sonst hängen bleibt, und es hat eine Folge, die man vom ersten Tag an einplant: was Sie später zeigen müssen, muss auf Ihrer Seite festgehalten werden.

Können wir hinterher belegen, was unser Agent getan hat?

Zum Teil. Die Spur auf unserer Seite beantwortet wo und wann, nicht was: welcher Endpunkt aufgerufen wurde, gegen welches Zielsystem, unter welcher Anbindung welches Ihrer Kunden, zu welchem Zeitpunkt. Der Antwortrumpf steht nicht darin, weil er nie aufbewahrt wird. Eine Antwort kann außerdem Warnungen tragen, etwa dass ein Feld vom Zielsystem nicht genutzt wird, und so hört ein Schreibvorgang, der gelungen ist und trotzdem nicht alles getan hat, worum Sie gebeten haben, auf, ein stiller Unterschied zu sein. Alles andere, was Ihr Agent vorgeschlagen hat und auf welcher Grundlage, gibt es nur dort, wo Sie es festhalten, und das ist die Hälfte, nach der ein Aufseher Sie fragt.

Was passiert, wenn das Modell etwas vorschlägt, das das System ablehnt?

Es kommt als eingeordneter Fehler zurück und nicht als Prosa eines einzelnen Herstellers, und die nützliche Unterscheidung für einen Agenten ist, wo es fehlschlug: eine Eingabe, die Maesn abgelehnt hat, bevor der Aufruf hinausging, oder die eigene Ablehnung des Zielsystems, unverändert zurückgereicht. Das Erste sagt, dass Ihr Agent etwas Fehlerhaftes erzeugt hat, das Zweite, dass das Hauptbuch es nicht genommen hätte. Das sind verschiedene Fehler, und sie brauchen verschiedene Behandlung, und darum geht es auf der ganzen Seite zur Fehlerbehandlung.

Welche Agenten-Abläufe deckt das tatsächlich ab?

Die, welche die dokumentierten Rezepte beschreiben, und daher kommen die Objektmengen auf dieser Seite und nicht aus einer Wunschliste. Ein Agent zur Kostenklassifizierung landet bei Ausgaben oder bei Buchungssätzen, und beides sind heute dokumentierte Schreibvorgänge. Ein Agent, der auf der offenen Position arbeitet, liest Rechnungen und Eingangsrechnungen und übergibt einen Vorschlag zur Prüfung, und das ist als Buchungsvorschlag dokumentiert. Keiner von ihnen gibt einen fertigen Abschluss zurück, weil keine Anbindung das tut: es kommen Buchungen an, und einen Abschluss summiert Ihr Produkt daraus.

Wird ein Schreibvorgang bestätigt, oder ist er abgeschickt und vergessen?

Bestätigt. Je nach Zielsystem wird ein Schreibvorgang direkt verarbeitet oder an eine asynchrone Aufgabe übergeben, die Sie abfragen, und so oder so gibt es einen Punkt, an dem Sie wissen, dass er gelandet ist. Für einen Agenten zählt das mehr als für ein Formular, denn ein Formular schickt nur ab, was ein Mensch schon freigegeben hat, während ein Agent auf eine Weise falsch liegen kann, die man besser abfängt, bevor jemand eine darauf gebaute Auswertung liest. Wo nach Zeitplan geschrieben wird und nicht auf einen Klick, setzen die meisten Teams eine Prüfschlange davor und lassen das Modell die Schlange füllen, und das hält das Tempo und lässt die Verantwortung bei einem Menschen.

Wie viele Systeme erreicht ein Bau?

Ihr Produkt wird gegen ein Modell gebaut und erreicht jedes System im Integrationsverzeichnis, und das ist die Antwort auf "unsere Kunden buchen alle woanders". Die ehrliche Hälfte ist, dass die Reichweite je Objekt gilt und nicht je System, die Zahl, die über Ihre Roadmap entscheidet, ist also die dünnste Zeile, von der Ihr Ablauf abhängt, und nicht die breiteste. Dafür ist die Tabelle darüber da, und sie ist aus der Dokumentation abgeleitet und nicht von Hand nacherzählt.

Einmal bauen, auf der Unified API.

Sehen Sie, wie Datenzugriff für KI-Agenten für Ihre Integration funktioniert, oder steigen Sie in die technische Referenz ein.