--- title: "Экраны и замечания" id: "1997" type: "page" slug: "screens" published_at: "2026-09-20T16:13:21+00:00" modified_at: "2026-09-28T14:59:36+00:00" url: "https://pastukhov.com/agents/test/docs/screens" markdown_url: "https://pastukhov.com/agents/test/docs/screens.md" excerpt: "Экран — это то, на что смотрит продукт: страница в том виде, в каком вы…" --- # Экраны и замечания [https://pastukhov.com/agents/test/docs/screens.md](https://pastukhov.com/agents/test/docs/screens.md) Экран — это то, на что смотрит продукт: страница в том виде, в каком вы её увидели. Замечание — то, что вы про неё думаете, обычными словами. Вместе они образуют начало всей работы: из замечания агент делает проверку, которая дальше работает сама. Ниже — как снимать экраны, писать замечания и запускать разбор. И сразу оговорка: экран — не то же самое, что снимок визуальной проверки, этому различию посвящён отдельный раздел ниже. ## Что такое экран Снимок видимой области страницы плюс её описание: адрес, заголовок, размер окна и структура — заголовки, кнопки, поля и их количество. Всё это снимается одной кнопкой из панели и сохраняется сразу же: промежуточного шага «проверить и сохранить» нет, потому что потерять несохранённый снимок гораздо неприятнее, чем убрать лишний. Картинка хранится в базе продукта, а не отдельным файлом в папке проекта. Поэтому снимков можно наделать сколько угодно, и они не забьют историю правок ваших файлов. Не путайте экран со снимком визуальной проверки — он описан ниже и в разделе [Визуальное тестирование](/agents/test/docs/visual) . ## Экран и снимок визуальной проверки — не одно и то же Они выглядят похоже — и то и другое картинка со страницы, — но живут разными задачами. **Экран** нужен для замечаний и правил: у него есть ваш текст, тип экрана и разбор агентом. Он лежит в галерее проекта и служит материалом для обучения. **Снимок визуальной проверки** — другое дело. Его вид (часть страницы, вся страница, компонент, элемент или текстовый снимок) заранее объявляет сам шаг теста, он привязан к этому шагу и сравнивается с эталоном во время сборки. Замечаний у него не бывает: его дело — показать, изменилась ли страница. Отсюда простое правило: экранов может быть сколько угодно, и в сравнении они не участвуют; снимков ровно столько, сколько объявлено шагами теста. Подробнее — в разделе [Визуальное тестирование](/agents/test/docs/visual) . ## Галерея экранов Все снимки проекта лежат на вкладке «Экраны». Там есть поиск, отбор по типу экрана и кнопка «Показать ещё» — список длинный, и листать его целиком обычно не нужно. В карточке экрана видно сам снимок, откуда он пришёл, его тип и замечания. Откуда пришёл снимок — важная пометка: **снят вручную**, **«через действие»** (получен при прогоне записанного сценария) или **«из запуска»** (оставлен шагом теста). Так вы всегда знаете, смотрите вы на свою тренировочную страницу или на доказательство из последнего запуска. ## Замечания Замечание — обычный текст: «кнопка не видна на тёмном фоне», «после отправки формы непонятно, что произошло». Писать можно из панели сразу после съёмки или позже из карточки экрана в приложении. Замечания лежат файлами в папке проекта — то есть попадают в историю правок вместе с правилами и тестами. Сами по себе замечания не разбираются: продукт ничего не отправляет агенту, пока вы не попросите. Это сделано, чтобы не тратить деньги на разборы, которые вам не нужны прямо сейчас. ## Кнопка «Вызвать агента» Когда разбор нужен, нажмите «Вызвать агента». В поле чата подставится готовый отчёт по экрану: ваши замечания дословно, ссылка на снимок, накопленные знания о проекте, список правил и типов экранов. Отправляется только то, что вы допишете ниже, — то есть само нажатие ничего не тратит. Допишите просьбу и отправьте. В ответ модель вернёт три вещи: **правило** — проверку, которая ищет эту проблему дальше без модели; **прирост знаний** — что она поняла про ваш интерфейс, эти записи пригодятся в следующих разборах; и **тип экрана** — к какой группе страниц относится снятая. - **В очереди** — разбор ждёт своей очереди: одновременно идёт только один, чтобы работа агента не смешивалась. - **Разбирается** — агент читает отчёт и готовит ответ. - **Готово** — правило, знания и тип экрана записаны в проект. - **Ошибка** — разобрать не получилось: агент недоступен или ответ пришёл в неверном виде. Ответ сохраняется целиком, и рядом есть кнопка повтора. Если сервер перезапустился посреди разбора, замечание вернётся в очередь само. Один разбор — один ответ. Сообщения, которые вы печатаете в чате после этого, продукт заново не разбирает: чтобы получить новое правило, отправьте отчёт ещё раз. ## Типы экранов Тип экрана — это название группы страниц с образцом адреса. Например, тип «вход» с образцом `/login` соберёт все страницы входа, а проверка, привязанная к этому типу, будет работать только на них. Типы назначает агент во время разбора, но можно задать их и руками — в проекте им соответствует файл `screen-types.yml`. ## Удаление и чистота Экран удаляется вместе со снимком и замечаниями — лишние тренировочные страницы разумно убирать, чтобы список оставался обозримым. На уже выпущенные правила удаление не влияет. Эталоны и снимки визуальных сборок оно тоже не трогает — это отдельные хранилища. Панель дополнения в кадр не попадает никогда — об этом позаботились отдельно, чтобы снимки были честными. И сразу оговорка про ссылки: ссылка на снимок открывается без входа в продукт, так устроены запросы к модели — она скачивает картинку по обычной ссылке. Поэтому сервер Агента тестирования лучше держать в закрытом контуре, куда нет доступа со стороны. Дальше: из чего состоит правило и как его подтвердить — в разделе [Правила](/agents/test/docs/rules) . [← Оглавление документации](/agents/test/docs)