Как мы собрали 26 страниц сайта агентами

Задача

Собрать 26 коммерческих страниц на Тильде. Весь контент на своей вёрстке в блоках HTML-кода, без готовых блоков конструктора: так страницы остаются в одной системе токенов и адаптируются под любой контент.

Объём: 230 блоков, каждый от 8 до 40 килобайт кода. Тексты, структура, микроразметка и метатеги писались с нуля.

Разделение труда

Мы развели работу между двумя агентами по принципу «кто что умеет дешевле».

Главное решение: код едет через буфер обмена

Первая версия схемы выглядела так: браузерный агент открывает файл с кодом, читает его и вставляет в Тильду. Мы посчитали, во что это обойдётся, и переделали.

230 блоков это несколько миллионов токенов только на чтение. При этом чтение бесполезно: код уже готов и проверен, агенту не нужно его понимать, ему нужно его перенести.

Решение: собрали одну HTML-страницу, где каждый блок лежит в скрытом поле, а рядом кнопка «Копировать». Агент жмёт кнопку и делает вставку в Тильде. Код не попадает в его переписку ни разу. Стоимость вставки блока перестала зависеть от размера блока.

Это общий принцип, а не частный трюк: если данные нужно перенести, а не понять, они не должны проходить через контекст модели. Буфер обмена, файл, API, что угодно, только не пересказ.

На чём мы потеряли

19 публикаций из 26

Агент собирал страницу и публиковал её, потом переходил к следующей. В конце выяснилось, что 19 страниц из 26 остались неопубликованными.

Причина: публикация в Тильде асинхронная, а таймеры в неактивной вкладке браузер притормаживает. Агент нажимал кнопку, переключался дальше, и публикация не доходила до конца.

Что сделали: перестали публиковать поштучно. Теперь все страницы собираются, и в конце один раз нажимается «Опубликовать все страницы». Правило записано в инструкцию, по которой работает агент.

Ошибка в генераторе, которая едва не ушла на 26 страниц

В генераторе блока вопрос-ответ разошлись имена классов и потерялся заголовок третьего уровня. Визуально блок выглядел бы почти так же, но заголовки вопросов исчезли бы со всех 26 страниц, а вместе с ними часть смысла для поиска.

Нашли на проверке: сверили сгенерированный блок с исходным донором построчно. Что сделали: добавили автоматическую проверку сгенерированных блоков перед выкладкой: сверка классов с донором, валидность микроразметки, поиск запрещённых слов.

Демонстрационный код в новых блоках

Тильда кладёт в новый блок HTML-кода свой пример. Если вставить свой код, не выделив содержимое поля, пример остаётся сверху. Лечится сочетанием клавиш, но найти это на живой странице неприятно.

Что забрали в процесс

1. Данные для переноса не проходят через контекст модели.
2. Механические шаги описываются инструкцией с точными названиями кнопок и порядком действий. Импровизация в интерфейсе стоит денег.
3. Всё, что сломалось один раз, записывается как правило с признаком: как понять, что вы уже в этой ситуации.
4. Генерируемый код проверяется автоматически до выкладки, а не глазами после.
5. Публикация и другие асинхронные операции делаются один раз в конце, а не по ходу.

Эти правила теперь лежат в панели проекта: один файл, который открывает любой агент перед началом работы. Там же журнал: что делали, чем проверяли, что сломалось, что осталось.

Что это даёт клиентам

Та же схема работает на клиентских проектах: агент делает механику, человек принимает решения, правила накапливаются в одном месте. За счёт этого мы собираем и правим сайты быстрее, чем при ручной работе, и не теряем детали между исполнителями.

Если нужно то же самое у себя, это внедрение под задачу. Если хотите, чтобы так работала ваша команда, это обучение.