Endpoint Response Model Generator: od odpowiedzi API do modelu
Podłączenie zewnętrznego systemu zwykle zaczyna się od odpowiedzi JSON i pustej strony. Które pola stają się kolumnami? Co zrobić z zagnieżdżonymi listami? Endpoint Response Model Generator czyta odpowiedź z testu endpointu i proponuje obie części odpowiedzi: model danych dla rekordów oraz mapowania pól dla workflow synchronizacji. Pojawia się tam, gdzie ustawiasz i testujesz endpointy API w ustawieniach integracji.
Worknano da się dostosować z AI i skupia się na głównej funkcjonalności. Zsynchronizowane dane lądują w zwykłym modelu, z tym samym UI, UX i bazą danych co wszystko inne, a nie w specjalnym magazynie danych.
Co robi
- Czyta ciało odpowiedzi przetestowanego endpointu oraz nazwę, ścieżkę, metodę i slug, gdy je podasz.
- Proponuje płaski model. Przydatne pojedyncze wartości stają się prawdziwymi kolumnami, zwłaszcza te, po których będziesz raportować albo filtrować.
- Rekomenduje, jak synchronizować. Odpowiedź z jednym obiektem sugeruje aktualizację jednego istniejącego rekordu. Lista albo częsty wrapper wokół listy sugeruje tworzenie rekordów.
- Zapisuje zagnieżdżone listy albo obiekty jako tekst JSON tylko wtedy, gdy nie ma lepszej opcji.
- Zaczyna model od id i kończy czasem synchronizacji, i mapuje tylko pola, które wygenerował.
- Obsługuje pola custom, które dostawca wysyła jako wpisy nazwy, typu i wartości, gdy model docelowy ma na nie miejsce. Import dodaje wtedy definicje do rekordu nadrzędnego, a wartości do każdego wiersza.
Kiedy pomaga
- Import CRM. Testujesz endpoint, który listuje transakcje w innym narzędziu. Agent proponuje model transakcji z kwotą, etapem i datą zamknięcia jako prawdziwymi kolumnami.
- Pojedynczy obiekt ustawień. Endpoint zwraca jeden obiekt ze szczegółami twojego planu. Agent sugeruje model i regułę aktualizacji, a nie nowy wiersz za każdym razem.
- Narzędzie projektowe z polami custom. Każdy projekt w źródle definiuje własne pola. Agent mapuje je tak, żeby wartości przychodziły razem z definicjami.
Jak działa z twoimi danymi
Ten agent nie ma narzędzi. Sam nie wywołuje endpointu i nie zapisuje rekordów. Test endpointu już się odbył, a odpowiedź jest przekazywana. Agent zwraca szkic modelu i propozycję mapowania, a ty przeglądasz oba, zanim cokolwiek zostanie zapisane. Zastosowanie modelu to zmiana konfiguracji, więc zostaje przy osobach, które mogą edytować konfigurację. Poświadczenia i sekrety połączenia nigdy nie są częścią tego, co agent widzi.
Używa szybkiego modelu. Wejście to ciało odpowiedzi, a wyjście jest strukturalne, więc szybkość liczy się bardziej niż głębokość.
Czego nie robi
- Nie testuje ani nie wywołuje endpointu. Robisz to najpierw ty, a odpowiedź bez przydatnych pól daje cienką propozycję.
- Nie zgaduje znaczenia, którego odpowiedź nie pokazuje. Sprawdź nazwy i typy, zwłaszcza przy datach i pieniądzach.
- Nie uruchamia synchronizacji. Robi to workflow, gdy zaakceptujesz mapowanie.
Do modelu napisanego ręcznie z opisu użyj Model Designer. Sam krok synchronizacji opisuje Workflow Creator.
Dostosuj go do siebie
Ten agent jest rekordem w module Agents. Możesz edytować jego instrukcje, żeby pasowały do twoich reguł nazewnictwa, zmienić model albo temperaturę, zduplikować go dla jednego konkretnego dostawcy albo zacząć od pustego agenta.
Zacznij od Zbuduj własnego agenta, przeczytaj Jak edytować asystenta strony i agenta wielokrotnego użytku, żeby poznać kroki w edytorze, albo zobacz szerszy obraz w Agentach AI i Asystentach AI.