Endpoint Response Model Generator: van een API-antwoord naar een model
Een extern systeem aansluiten begint meestal met een JSON-antwoord en een lege pagina. Welke velden worden kolommen? Wat doe je met geneste lijsten? Endpoint Response Model Generator leest het antwoord van een endpointtest en stelt beide delen van het antwoord voor: een datamodel voor de records, en de veldkoppelingen voor een sync-workflow. Hij verschijnt waar je API-endpoints instelt en test in de integratie-instellingen.
Worknano is aanpasbaar met AI en gericht op kernfunctionaliteit. Gesynchroniseerde gegevens landen in een normaal model, met dezelfde UI, UX en database als al het andere, niet in een speciale gegevensopslag.
Wat hij doet
- Leest de antwoordbody van een getest endpoint, plus de naam, het pad, de methode en de slug wanneer je die meegeeft.
- Stelt een plat model voor. Nuttige losse waarden worden echte kolommen, vooral die waarop je gaat rapporteren of filteren.
- Beveelt aan hoe je synchroniseert. Een antwoord met één object suggereert het bijwerken van één bestaand record. Een lijst, of een veelvoorkomende wrapper rond een lijst, suggereert het aanmaken van records.
- Slaat geneste lijsten of objecten alleen als JSON-tekst op wanneer er geen betere optie is.
- Begint het model met een id en eindigt met een synchronisatietijd, en koppelt alleen de velden die hij heeft gegenereerd.
- Behandelt custom velden die de aanbieder stuurt als naam-, type- en waarde-items, wanneer het doelmodel daar een plek voor heeft. De import voegt dan de definities toe aan het bovenliggende record en de waarden aan elke rij.
Wanneer hij helpt
- Een CRM-import. Je test het endpoint dat deals in een ander hulpmiddel opsomt. De agent stelt een dealmodel voor met bedrag, fase en sluitdatum als echte kolommen.
- Eén instellingenobject. Een endpoint geeft één object terug met je plandetails. De agent suggereert een model en een updateregel, niet elke keer een nieuwe rij.
- Een projecttool met custom velden. Elk project in de bron definieert zijn eigen velden. De agent koppelt die zodat de waarden aankomen met hun definities.
Hoe hij met je gegevens werkt
Deze agent heeft geen tools. Hij roept het endpoint niet zelf aan en hij schrijft geen records. De endpointtest is al gedraaid, en het antwoord wordt meegegeven. De agent geeft een modelconcept en een koppelvoorstel terug, en jij beoordeelt beide voordat er iets wordt opgeslagen. Een model toepassen is een configuratiewijziging, dus het blijft bij de mensen die configuratie mogen bewerken. Inloggegevens en verbindingsgeheimen maken nooit deel uit van wat de agent ziet.
Hij gebruikt een snel model. De invoer is een antwoordbody en de uitvoer is gestructureerd, dus snelheid telt meer dan diepte.
Wat hij niet doet
- Hij test of roept het endpoint niet aan. Dat doe jij eerst, en een antwoord zonder bruikbare velden geeft een dun voorstel.
- Hij raadt geen betekenis die het antwoord niet toont. Controleer namen en types, vooral bij datums en geld.
- Hij draait de sync niet. Dat doet de workflow, zodra je de koppeling hebt geaccepteerd.
Voor een met de hand geschreven model vanuit een beschrijving gebruik je Model Designer. Voor de sync-stap zelf, zie Workflow Creator.
Maak het van jou
Deze agent is een record in de module Agents. Je kunt zijn instructies bewerken zodat ze bij je naamgevingsregels passen, het model of de temperatuur wijzigen, hem dupliceren voor één bepaalde aanbieder, of beginnen vanaf een lege agent.
Begin met Bouw je eigen agent, lees Een pagina-assistent en een herbruikbare agent bewerken voor de stappen in de editor, of bekijk het grotere geheel in AI-agents en AI-assistenten.