Endpoint Response Model Generator: от ответа API к модели
Подключение внешней системы обычно начинается с ответа JSON и пустой страницы. Какие поля становятся колонками? Что делать с вложенными списками? Endpoint Response Model Generator читает ответ теста endpoint и предлагает обе части ответа: модель данных для записей и сопоставления полей для workflow синхронизации. Он появляется там, где вы настраиваете и проверяете endpoint API в настройках интеграции.
Worknano настраивается с помощью AI и сосредоточен на основной функциональности. Синхронизированные данные попадают в обычную модель, с тем же UI, UX и базой данных, что и всё остальное, а не в особое хранилище.
Что он делает
- Читает тело ответа проверенного endpoint, а также имя, путь, метод и slug, если вы их передаёте.
- Предлагает плоскую модель. Полезные одиночные значения становятся настоящими колонками, особенно те, по которым вы будете строить отчёты или фильтровать.
- Рекомендует, как синхронизировать. Ответ с одним объектом предлагает обновлять одну существующую запись. Список или частая обёртка вокруг списка предлагает создавать записи.
- Хранит вложенные списки или объекты как текст JSON только когда нет варианта лучше.
- Начинает модель с id и заканчивает временем синхронизации и сопоставляет только те поля, которые сгенерировал.
- Обрабатывает custom-поля, которые поставщик присылает как записи имени, типа и значения, когда у целевой модели есть для них место. Импорт тогда добавляет определения к родительской записи, а значения к каждой строке.
Когда это помогает
- Импорт CRM. Вы проверяете endpoint, который перечисляет сделки в другом инструменте. Агент предлагает модель сделки с суммой, этапом и датой закрытия как настоящими колонками.
- Один объект настроек. Endpoint возвращает один объект с деталями вашего плана. Агент предлагает модель и правило обновления, а не новую строку каждый раз.
- Инструмент проектов с custom-полями. Каждый проект в источнике задаёт свои поля. Агент сопоставляет их так, чтобы значения приходили вместе с определениями.
Как это работает с вашими данными
У этого агента нет инструментов. Он сам не вызывает endpoint и не пишет записи. Тест endpoint уже выполнен, и ответ передаётся ему. Агент возвращает черновик модели и предложение сопоставления, и вы просматриваете оба, прежде чем что-либо сохранится. Применение модели это изменение конфигурации, поэтому оно остаётся у людей, которым можно её править. Учётные данные и секреты подключения никогда не входят в то, что видит агент.
Он использует быструю модель. На входе тело ответа, на выходе структура, поэтому скорость важнее глубины.
Чего он не делает
- Он не проверяет и не вызывает endpoint. Это делаете сначала вы, а ответ без полезных полей даёт тонкое предложение.
- Он не угадывает смысл, которого ответ не показывает. Проверьте имена и типы, особенно для дат и денег.
- Он не запускает синхронизацию. Это делает workflow, когда вы приняли сопоставление.
Для модели, написанной вручную по описанию, используйте Model Designer. Сам шаг синхронизации см. в Workflow Creator.
Настройте его под себя
Этот агент это запись в модуле Agents. Вы можете отредактировать его инструкции под ваши правила имён, сменить модель или температуру, продублировать его для одного поставщика или начать с пустого агента.
Начните со статьи Соберите собственного агента, прочитайте Как изменить ассистента страницы и повторно используемого агента, чтобы увидеть шаги в редакторе, или посмотрите на общую картину в AI-агентах и AI-ассистентах.