---
title: "Экраны и замечания"
id: "1997"
type: "page"
slug: "screens"
published_at: "2026-09-20T16:13:21+00:00"
modified_at: "2026-09-21T00:00:47+00:00"
url: "https://pastukhov.com/agents/ui/docs/screens"
markdown_url: "https://pastukhov.com/agents/ui/docs/screens.md"
excerpt: "Экран — это то, на что смотрит продукт: страница в том виде, в каком вы…"
---

# Экраны и замечания

[https://pastukhov.com/agents/ui/docs/screens.md](https://pastukhov.com/agents/ui/docs/screens.md)

Экран — это то, на что смотрит продукт: страница в том виде, в каком вы её увидели. Замечание — то, что вы про неё думаете, обычными словами. Вместе они образуют начало всей работы: из замечания агент делает проверку, которая дальше работает сама. Ниже — как снимать экраны, писать замечания и запускать разбор.

## Что такое экран

Снимок видимой области страницы плюс её описание: адрес, заголовок, размер окна и структура — заголовки, кнопки, поля и их количество. Всё это снимается одной кнопкой из панели и сохраняется сразу же: промежуточного шага «проверить и сохранить» нет, потому что потерять несохранённый снимок гораздо неприятнее, чем убрать лишний.

Картинка хранится в базе продукта, а не отдельным файлом в папке проекта. Поэтому снимков можно наделать сколько угодно, и они не забьют историю правок ваших файлов.

## Галерея экранов

Все снимки проекта лежат на вкладке «Экраны». Там есть поиск, отбор по типу экрана и кнопка «Показать ещё» — список длинный, и листать его целиком обычно не нужно. В карточке экрана видно сам снимок, откуда он пришёл, его тип и замечания.

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

## Замечания

Замечание — обычный текст: «кнопка не видна на тёмном фоне», «после отправки формы непонятно, что произошло». Писать можно из панели сразу после съёмки или позже из карточки экрана в приложении. Замечания лежат файлами в папке проекта — то есть попадают в историю правок вместе с правилами и тестами.

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

## Кнопка «Вызвать агента»

Когда разбор нужен, нажмите «Вызвать агента». В поле чата подставится готовый отчёт по экрану: ваши замечания дословно, ссылка на снимок, накопленные знания о проекте, список правил и типов экранов. Отправляется только то, что вы допишете ниже, — то есть само нажатие ничего не тратит.

Допишите просьбу и отправьте. В ответ модель вернёт три вещи: **правило** — проверку, которая ищет эту проблему дальше без модели; **прирост знаний** — что она поняла про ваш интерфейс, эти записи пригодятся в следующих разборах; и **тип экрана** — к какой группе страниц относится снятая.

- **В очереди** — разбор ждёт своей очереди: одновременно идёт только один, чтобы работа агента не смешивалась.
- **Разбирается** — агент читает отчёт и готовит ответ.
- **Готово** — правило, знания и тип экрана записаны в проект.
- **Ошибка** — разобрать не получилось: агент недоступен или ответ пришёл в неверном виде. Ответ сохраняется целиком, и рядом есть кнопка повтора. Если сервер перезапустился посреди разбора, замечание вернётся в очередь само.

Один разбор — один ответ. Сообщения, которые вы печатаете в чате после этого, продукт заново не разбирает: чтобы получить новое правило, отправьте отчёт ещё раз.

## Типы экранов

Тип экрана — это название группы страниц с образцом адреса. Например, тип «вход» с образцом `/login` соберёт все страницы входа, а проверка, привязанная к этому типу, будет работать только на них. Типы назначает агент во время разбора, но можно задать их и руками — в проекте им соответствует файл `screen-types.yml`.

## Удаление и чистота

Экран удаляется вместе со снимком и замечаниями — лишние тренировочные страницы разумно убирать, чтобы список оставался обозримым. На уже выпущенные правила удаление не влияет.

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

Дальше: из чего состоит правило и как его подтвердить — в разделе [Правила](/agents/ui/docs/rules)
.

[← Оглавление документации](/agents/ui/docs)