Endpoint Response Model Generator: da una risposta API a un modello
Collegare un sistema esterno di solito parte da una risposta JSON e da una pagina bianca. Quali campi diventano colonne? Cosa fai delle liste annidate? Endpoint Response Model Generator legge la risposta di un test dell’endpoint e propone entrambe le parti della soluzione: un modello dati per i record e le mappature dei campi per un Workflow di sincronizzazione. Compare dove imposti e testi gli endpoint API, nelle impostazioni delle integrazioni.
Worknano è personalizzabile con l’IA e concentrato sulle funzioni essenziali. I dati sincronizzati finiscono in un modello normale, con la stessa UI, UX e lo stesso database di tutto il resto, non in un archivio separato.
Cosa fa
- Legge il corpo della risposta di un endpoint testato, insieme a nome, percorso, metodo e slug, quando li fornisci.
- Propone un modello piatto. I valori singoli utili diventano colonne reali, soprattutto quelli su cui farai report o filtri.
- Consiglia come sincronizzare. Una risposta con un solo oggetto suggerisce di aggiornare un record esistente. Una lista, o un contenitore comune che avvolge una lista, suggerisce di creare record.
- Salva liste o oggetti annidati come testo JSON solo quando non esiste un’opzione migliore.
- Avvia il modello con un id e lo chiude con un orario di sincronizzazione, e mappa solo i campi che ha generato.
- Gestisce i campi personalizzati che il provider invia come voci nome, tipo e valore, quando il modello di destinazione ha uno spazio per loro. L’importazione aggiunge poi le definizioni al record genitore e i valori a ogni riga.
Quando è utile
- Un import da CRM. Testi l’endpoint che elenca le trattative in un altro strumento. L’agent propone un modello trattative con importo, fase e data di chiusura come colonne reali.
- Un singolo oggetto di impostazioni. Un endpoint restituisce un solo oggetto con i dettagli del tuo piano. L’agent suggerisce un modello e una regola di aggiornamento, non una nuova riga ogni volta.
- Uno strumento di progetto con campi personalizzati. Ogni progetto nella fonte definisce i propri campi. L’agent li mappa in modo che i valori arrivino con le rispettive definizioni.
Come funziona con i tuoi dati
Questo agent non ha strumenti. Non chiama l’endpoint e non scrive record. Il test dell’endpoint è già stato eseguito, e la risposta gli viene passata. L’agent restituisce una bozza di modello e un suggerimento di mappatura, e tu li rivedi entrambi prima che venga salvato qualcosa. Applicare un modello è una modifica alla configurazione, quindi resta a chi può modificare la configurazione. Credenziali e segreti di connessione non fanno mai parte di ciò che l’agent vede.
Usa un modello veloce. L’input è un corpo di risposta e l’output è strutturato, quindi conta più la rapidità che la profondità.
Cosa non fa
- Non testa né chiama l’endpoint. Lo fai tu prima, e una risposta senza campi utili produce una proposta povera.
- Non indovina significati che la risposta non mostra. Controlla nomi e tipi, soprattutto per date e importi.
- Non esegue la sincronizzazione. La fa il Workflow, una volta che hai accettato la mappatura.
Per un modello scritto a partire da una descrizione, usa Model Designer. Per il passaggio di sincronizzazione vero e proprio, vedi Workflow Creator.
Personalizzalo
Questo agent è un record nel modulo Agents. Puoi modificarne le istruzioni per adattarle alle tue regole di denominazione, cambiarne modello o temperatura, duplicarlo per un provider specifico, oppure partire da un agent vuoto.
Inizia da Crea il tuo agent, leggi Come modificare un assistente di pagina e un agent riutilizzabile per i passaggi dell’editor, oppure guarda il quadro generale in Agent IA e Assistenti IA.