Endpoint Response Model Generator: von einer API-Antwort zum Modell
Eine Anbindung an ein externes System beginnt meist mit einer JSON-Antwort und einer leeren Seite. Welche Felder werden zu Spalten? Was machst du mit verschachtelten Listen? Endpoint Response Model Generator liest die Antwort aus einem Endpunkt-Test und schlägt beide Teile der Lösung vor: ein Datenmodell für die Datensätze und die Feldzuordnungen für einen Sync-Workflow. Er erscheint dort, wo du API-Endpunkte in den Integrationseinstellungen einrichtest und testest.
Worknano ist mit KI anpassbar und auf die Kernfunktionen konzentriert. Synchronisierte Daten landen in einem normalen Modell, mit derselben UI, UX und Datenbank wie alles andere, nicht in einem Sonderspeicher.
Was er macht
- Liest den Antworttext eines getesteten Endpunkts sowie Name, Pfad, Methode und Slug, wenn du sie angibst.
- Schlägt ein flaches Modell vor. Nützliche Einzelwerte werden echte Spalten, besonders diejenigen, nach denen du auswerten oder filtern willst.
- Empfiehlt, wie synchronisiert werden soll. Eine Antwort mit einem Objekt legt nahe, einen bestehenden Datensatz zu aktualisieren. Eine Liste oder eine übliche Hülle um eine Liste legt nahe, Datensätze anzulegen.
- Speichert verschachtelte Listen oder Objekte nur dann als JSON-Text, wenn es keine bessere Option gibt.
- Beginnt das Modell mit einer ID und endet mit einem Zeitstempel für die letzte Synchronisation. Zugeordnet werden nur die Felder, die er erzeugt hat.
- Verarbeitet Zusatzfelder, die der Anbieter als Einträge mit Name, Typ und Wert schickt, sofern das Zielmodell dafür Platz hat. Der Import legt die Definitionen dann am übergeordneten Datensatz an und die Werte an jeder Zeile.
Wann er hilft
- Ein CRM-Import. Du testest den Endpunkt, der Deals in einem anderen Tool auflistet. Der Agent schlägt ein Deal-Modell vor, mit Betrag, Phase und Abschlussdatum als echten Spalten.
- Ein einzelnes Einstellungsobjekt. Ein Endpunkt liefert ein Objekt mit deinen Tarifdaten. Der Agent schlägt ein Modell und eine Aktualisierungsregel vor, keinen neuen Datensatz bei jedem Abruf.
- Ein Projekttool mit Zusatzfeldern. Jedes Projekt in der Quelle definiert eigene Felder. Der Agent ordnet sie so zu, dass die Werte zusammen mit ihren Definitionen ankommen.
Wie er mit deinen Daten arbeitet
Dieser Agent hat keine Tools. Er ruft den Endpunkt nicht selbst auf und schreibt keine Datensätze. Der Endpunkt-Test ist bereits gelaufen, und die Antwort wird übergeben. Der Agent gibt einen Modellentwurf und einen Zuordnungsvorschlag zurück, und du prüfst beides, bevor etwas gespeichert wird. Ein Modell zu übernehmen ist eine Konfigurationsänderung und bleibt deshalb bei den Personen, die Konfiguration bearbeiten dürfen. Zugangsdaten und Verbindungsgeheimnisse sieht der Agent nie.
Er nutzt ein schnelles Modell. Die Eingabe ist ein Antworttext, die Ausgabe ist strukturiert, daher zählt Tempo mehr als Tiefe.
Was er nicht macht
- Er testet oder ruft den Endpunkt nicht auf. Das machst du vorher. Eine Antwort ohne brauchbare Felder ergibt einen dünnen Vorschlag.
- Er rät keine Bedeutung, die die Antwort nicht zeigt. Prüfe Namen und Typen, besonders bei Datums- und Geldwerten.
- Er führt die Synchronisation nicht aus. Das übernimmt der Workflow, sobald du die Zuordnung angenommen hast.
Für ein Modell aus einer Beschreibung nutze den Model Designer. Für den Synchronisationsschritt selbst siehe den Workflow Creator.
Passe ihn an
Dieser Agent ist ein Datensatz im Agents-Modul. Du kannst seine Anweisungen an deine Namensregeln anpassen, Modell oder Temperatur ändern, ihn für einen bestimmten Anbieter duplizieren oder mit einem leeren Agenten beginnen.
Starte mit Eigenen Agenten bauen, lies So bearbeitest du einen Seitenassistenten und einen wiederverwendbaren Agenten für die Schritte im Editor, oder schau dir das große Ganze in KI-Agents und KI-Assistenten an.