Экран — это то, на что смотрит продукт: страница в том виде, в каком вы её увидели. Замечание — то, что вы про неё думаете, обычными словами. Вместе они образуют начало всей работы: из замечания агент делает проверку, которая дальше работает сама. Ниже — как снимать экраны, писать замечания и запускать разбор.
Что такое экран
Снимок видимой области страницы плюс её описание: адрес, заголовок, размер окна и структура — заголовки, кнопки, поля и их количество. Всё это снимается одной кнопкой из панели и сохраняется сразу же: промежуточного шага «проверить и сохранить» нет, потому что потерять несохранённый снимок гораздо неприятнее, чем убрать лишний.
Картинка хранится в базе продукта, а не отдельным файлом в папке проекта. Поэтому снимков можно наделать сколько угодно, и они не забьют историю правок ваших файлов.
Галерея экранов
Все снимки проекта лежат на вкладке «Экраны». Там есть поиск, отбор по типу экрана и кнопка «Показать ещё» — список длинный, и листать его целиком обычно не нужно. В карточке экрана видно сам снимок, откуда он пришёл, его тип и замечания.
Откуда пришёл снимок — важная пометка: снят вручную, «через действие» (получен при прогоне записанного сценария) или «из запуска» (оставлен шагом теста). Так вы всегда знаете, смотрите вы на свою тренировочную страницу или на доказательство из последнего запуска.
Замечания
Замечание — обычный текст: «кнопка не видна на тёмном фоне», «после отправки формы непонятно, что произошло». Писать можно из панели сразу после съёмки или позже из карточки экрана в приложении. Замечания лежат файлами в папке проекта — то есть попадают в историю правок вместе с правилами и тестами.
Сами по себе замечания не разбираются: продукт ничего не отправляет агенту, пока вы не попросите. Это сделано, чтобы не тратить деньги на разборы, которые вам не нужны прямо сейчас.
Кнопка «Вызвать агента»
Когда разбор нужен, нажмите «Вызвать агента». В поле чата подставится готовый отчёт по экрану: ваши замечания дословно, ссылка на снимок, накопленные знания о проекте, список правил и типов экранов. Отправляется только то, что вы допишете ниже, — то есть само нажатие ничего не тратит.
Допишите просьбу и отправьте. В ответ модель вернёт три вещи: правило — проверку, которая ищет эту проблему дальше без модели; прирост знаний — что она поняла про ваш интерфейс, эти записи пригодятся в следующих разборах; и тип экрана — к какой группе страниц относится снятая.
- В очереди — разбор ждёт своей очереди: одновременно идёт только один, чтобы работа агента не смешивалась.
- Разбирается — агент читает отчёт и готовит ответ.
- Готово — правило, знания и тип экрана записаны в проект.
- Ошибка — разобрать не получилось: агент недоступен или ответ пришёл в неверном виде. Ответ сохраняется целиком, и рядом есть кнопка повтора. Если сервер перезапустился посреди разбора, замечание вернётся в очередь само.
Один разбор — один ответ. Сообщения, которые вы печатаете в чате после этого, продукт заново не разбирает: чтобы получить новое правило, отправьте отчёт ещё раз.
Типы экранов
Тип экрана — это название группы страниц с образцом адреса. Например, тип «вход» с образцом /login соберёт все страницы входа, а проверка, привязанная к этому типу, будет работать только на них. Типы назначает агент во время разбора, но можно задать их и руками — в проекте им соответствует файл screen-types.yml.
Удаление и чистота
Экран удаляется вместе со снимком и замечаниями — лишние тренировочные страницы разумно убирать, чтобы список оставался обозримым. На уже выпущенные правила удаление не влияет.
Панель дополнения в кадр не попадает никогда — об этом позаботились отдельно, чтобы снимки были честными. И сразу оговорка про ссылки: ссылка на снимок открывается без входа в продукт, так устроены запросы к модели — она скачивает картинку по обычной ссылке. Поэтому сервер Агента интерфейсов лучше держать в закрытом контуре, куда нет доступа со стороны.
Дальше: из чего состоит правило и как его подтвердить — в разделе Правила.