Endpoint Response Model Generator : de la réponse d’une API à un modèle
Connecter un système externe commence généralement par une réponse JSON et une page vierge. Quels champs deviennent des colonnes ? Que faire des listes imbriquées ? Endpoint Response Model Generator lit la réponse d’un test d’endpoint et propose les deux parties de la solution : un modèle de données pour les enregistrements, et les correspondances de champs pour un workflow de synchronisation. Il apparaît là où vous configurez et testez les endpoints d’API, dans les paramètres d’intégration.
Worknano est personnalisable avec l’IA et centré sur les fonctionnalités essentielles. Les données synchronisées arrivent dans un modèle normal, avec la même UI, la même UX et la même base de données que le reste, et non dans un espace de stockage spécial.
Ce qu’il fait
- Lit le corps de la réponse d’un endpoint testé, ainsi que son nom, son chemin, sa méthode et son slug lorsque vous les fournissez.
- Propose un modèle plat. Les valeurs simples utiles deviennent de vraies colonnes, surtout celles sur lesquelles vous voudrez faire des rapports ou des filtres.
- Recommande la manière de synchroniser. Une réponse contenant un seul objet suggère de mettre à jour un enregistrement existant. Une liste, ou une enveloppe courante autour d’une liste, suggère de créer des enregistrements.
- Ne stocke les listes ou objets imbriqués sous forme de texte JSON que lorsqu’il n’existe pas de meilleure option.
- Ajoute au modèle un identifiant en tête et une date de synchronisation en fin, et ne fait correspondre que les champs qu’il a générés.
- Gère les champs personnalisés que le fournisseur envoie sous forme d’entrées nom, type et valeur, lorsque le modèle cible prévoit un emplacement pour eux. L’import ajoute alors les définitions à l’enregistrement parent et les valeurs à chaque ligne.
Quand il est utile
- Un import CRM. Vous testez l’endpoint qui liste les opportunités d’un autre outil. L’agent propose un modèle d’opportunité avec le montant, l’étape et la date de clôture sous forme de vraies colonnes.
- Un objet de paramètres unique. Un endpoint renvoie un seul objet contenant les détails de votre offre. L’agent suggère un modèle et une règle de mise à jour, et non une nouvelle ligne à chaque fois.
- Un outil de projet avec des champs personnalisés. Chaque projet de la source définit ses propres champs. L’agent fait correspondre ces champs afin que les valeurs arrivent avec leurs définitions.
Comment il travaille avec vos données
Cet agent n’a aucun outil. Il n’appelle pas lui-même l’endpoint et n’écrit aucun enregistrement. Le test de l’endpoint a déjà eu lieu, et la réponse lui est transmise. L’agent renvoie un brouillon de modèle et une suggestion de correspondance, que vous relisez avant toute sauvegarde. Appliquer un modèle est une modification de la configuration, qui reste réservée aux personnes autorisées à la modifier. Les identifiants et les secrets de connexion ne font jamais partie de ce que l’agent voit.
Il utilise un modèle rapide. L’entrée est un corps de réponse et la sortie est structurée : la vitesse compte davantage que la profondeur.
Ce qu’il ne fait pas
- Il ne teste pas l’endpoint et n’appelle rien. Vous devez le faire au préalable, et une réponse sans champ utile donne une proposition maigre.
- Il ne devine pas un sens que la réponse ne montre pas. Vérifiez les noms et les types, surtout pour les dates et les montants.
- Il n’exécute pas la synchronisation. C’est le workflow qui s’en charge, une fois la correspondance acceptée.
Pour un modèle rédigé à la main à partir d’une description, utilisez Model Designer. Pour l’étape de synchronisation elle-même, consultez Workflow Creator.
Adaptez-le à vos besoins
Cet agent est un enregistrement du module Agents. Vous pouvez modifier ses instructions pour respecter vos règles de nommage, changer le modèle ou la température, le dupliquer pour un fournisseur précis, ou partir d’un agent vierge.
Commencez par Créer votre propre agent, consultez Comment modifier un assistant de page et un agent réutilisable pour les étapes de l’éditeur, ou découvrez le tableau d’ensemble avec Agents IA et Assistants IA.