---
title: "Начало работы"
id: "1994"
type: "page"
slug: "getting-started"
published_at: "2026-09-20T16:13:19+00:00"
modified_at: "2026-10-19T18:55:42+00:00"
url: "https://pastukhov.com/agents/test/docs/getting-started/"
markdown_url: "https://pastukhov.com/agents/test/docs/getting-started.md"
excerpt: "Агент тестирования — это программа для проверки вашего сайта, приложения или внутренней системы. Вы открываете…"
---

# Начало работы

[https://pastukhov.com/agents/test/docs/getting-started/.md](https://pastukhov.com/agents/test/docs/getting-started/.md)

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

## Главная мысль

ИИ нужен только на этапе обучения. Вы показываете страницу и объясняете проблему словами — модель пишет **правило**: маленькую проверку, которая ищет эту проблему в браузере. Дальше правило работает без модели: быстро, бесплатно и на всех похожих страницах сразу. Чем больше правил накопилось, тем меньше в продукте ИИ — и тем дешевле обходится каждая проверка.

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

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

## Кому подходит

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

## Из чего состоит продукт

Девять слов, которые дальше встречаются постоянно. Все они — названия разделов в самом интерфейсе.

- **Проект** — один проверяемый сайт или приложение. У каждого проекта свои правила, действия и тесты.
- **Экран** — снимок страницы и её описание: адрес, заголовок, структура. Плюс замечания словами, что на этой странице не так.
- **Правило** — проверка, которая ищет конкретную проблему. Пишется один раз, работает всегда.
- **Действие** — записанный сценарий работы с интерфейсом: войти, открыть оплату, заполнить форму.
- **Тест** — последовательность шагов: открыть адрес, выполнить действие, проверить правила.
- **Запуск** — одно выполнение теста. Каждый шаг оставляет снимок и результат проверок — это доказательства, а не просто «зелёная галочка».
- **Сборка** — запуск с визуальными проверками: продукт снимает шаги теста и сравнивает их с эталоном. У сборки есть ветка, состояние проверки и причина падения.
- **Эталон** — одобренный человеком образец страницы, с которым сравнивают снимки. Хранится с историей версий, поэтому видно, кто и когда его одобрил.
- **Ревью** — проверка отличий человеком: одобрить, запросить правки или отклонить. Одобрить изменение может только человек — ни модель, ни внешняя программа этого не делают.

Вокруг этого набора работают ещё несколько вещей: **расписание** (когда тесты запускаются сами), **проблемы** (одинаковые ошибки, склеенные в одну строку), **автоисправление** (агент чинит сломавшуюся проверку) и **сводка** на главном экране, которая отвечает на вопрос «что требует меня сейчас».

Продукт закрывает типовые проверки интерфейса из коробки, а нестандартные можно дописать самому. **Скрипт** — это файл с кодом на Python, который лежит в папке проекта и подключается к работе продукта: так проверяют адрес API, базу данных или файл, которых на странице не видно. Ветка необязательная — без скриптов всё работает как раньше, а подробности собраны в разделе [Скрипты и расширение](/agents/test/docs/scripts)
.

У визуальной части свои разделы: вкладка **«Проверка»** со списком сборок, **«Эталоны»** с их версиями, **«Доска проверки»** с отличиями, ждущими решения, **«Разбор сборок»** с причинами падений и **«Покрытие»** с инвентарём того, что защищено проверками.

## Первый вход

После запуска откройте адрес сервера в браузере: если пользователей ещё нет, приложение предложит зарегистрироваться. **Первый зарегистрировавшийся становится администратором** — остальные пользователи добавляются позже. Вход держится 90 дней, пароль повторно вводить не придётся.

Дальше администратор заводит остальных пользователей и выдаёт им роли: «Наблюдатель», «Рецензент», «Участник», «Администратор» и «Владелец». Отдельно отмечается дизайн-ревьюер — только он утверждает отличия в оформлении. Там же выпускаются ключи API: они нужны, чтобы проверки запускались из вашей системы непрерывной сборки.

Первое, что стоит настроить, — подключение к ИИ-агенту Pastukhov Agent (адрес `AGENT_API_URL` и ключ `AGENT_API_KEY`). Без него прогоны, проверки и сравнения работают, но разбор замечаний, создание правил и действий и автоисправление недоступны, а экран чатов остаётся пустым. Что это даёт вам и как подключить — в разделе [Чат с ИИ-агентом](/agents/test/docs/agent)
.

## Как выглядит окно

- **Слева** — список разделов: «Проекты», а у администратора ещё «Операции» (исполнители, очередь, бюджеты). Внизу — «Промпты» и «Чаты». Экран «Диагностика» открывается из полосы предупреждений о работоспособности проверок.
- **В центре** — «Проекты»: карточки ваших проектов и цифры сверху о том, что требует внимания.
- **Внутри проекта** — вкладки: «Экраны», «Правила», «Действия», «Скрипты», «Тесты», «Покрытие», «Агенты», «Проверка», «Проблемы», «Настройки». Вкладка «Скрипты» нужна тем, кто расширяет продукт своими проверками; остальные вкладки при этом открывать не обязательно.
- **Из проекта** — «Эталоны», «Доска проверки», «Журнал аудита», «ИИ-журнал» и «Чек-лист» настройки визуальных проверок.

Над списком разделов — поле поиска. Оно ищет сразу по всему приложению: начните печатать, и результаты появятся тут же, сгруппированные по видам — проекты, экраны, правила и действия, тесты, скрипты, проблемы, визуальные проверки, база знаний и документация. Нажатие на строку открывает не список, а настоящее место: нужный экран, проблему или тот самый шаг упавшего прогона. Секреты в поиск не попадают. Подробнее — в разделе [Поиск по приложению](/agents/test/docs/search)
.

## Первые шаги

1. **Создайте проект** — укажите название и адрес вашего сайта. Продукт сразу заведёт папку проекта со всеми настройками.
2. **Решите, кто выполняет прогоны** — настраивать ничего не нужно: встроенный исполнитель уже умеет открывать страницы и проходить шаги. Дополнение Chrome ставьте, если хотите снимать экраны вручную и смотреть на прогон в живом окне — разница описана в разделах [Встроенный исполнитель](/agents/test/docs/runner) и [Дополнение Chrome](/agents/test/docs/addon) .
3. **Снимите экран и напишите замечание** — откройте нужную страницу, включите панель и объясните своими словами, что не так.
4. **Нажмите «Вызвать агента»** — в чат подставится готовый отчёт по экрану. Допишите просьбу и отправьте: модель вернёт правило, новые знания о вашем интерфейсе и подскажет тип экрана.
5. **Подтвердите правило** — прогоните его на странице и нажмите «Подтвердить». Подтверждение значит «проверка работает без ошибок», а не «страница в порядке»: сама оценка страницы появится позже, при запусках.
6. **Соберите тест** — последовательность шагов из действий и правил, которые нужно проверять вместе.
7. **Объявите съёмку у шага** — отметьте в тесте, какие шаги нужно снимать. Снимок сделает тот исполнитель, который заберёт прогон: встроенный или Chrome с дополнением.
8. **Запустите первую сборку** — она сама создаст эталоны для всех снимков: сравнивать пока не с чем.
9. **Утвердите эталоны** — посмотрите первые снимки на доске проверки и одобрите их. С этого момента отличие от этих снимков считается изменением.
10. **Запустите вторую сборку и посмотрите вердикт** — если страница не менялась, сравнение выйдет «без изменений»; если менялась, вы увидите отличия и решите, обновлять эталон или чинить.
11. **Поставьте расписание** — например, каждое утро в 9:00. Тест будет запускаться сам, а вы увидите результат в сводке.

Пошаговый чек-лист — восемь шагов — открывается у нового проекта сам, а позже к нему всегда можно вернуться: [Чек-лист настройки](/agents/test/docs/checklist)
.

## Что понадобится

Сервер, на котором работает продукт. Всё живёт на вашей стороне: ни снимки, ни правила, ни тесты никуда не отправляются — кроме обращений к ИИ-агенту, когда вы сами их запускаете. Проверки и снимки для визуальных сборок выполняет **исполнитель**, и способа два. Первый — встроенный: безоконный браузер прямо на сервере, который работает сразу; для расписаний и повседневных прогонов его достаточно, и отдельный компьютер держать не нужно. Второй — Chrome с нашим дополнением: это живой браузер под вашими глазами, он нужен, когда хочется снять экран вручную, записать действие или посмотреть, как идёт тест. Выбирать одно из двух не обязательно: они работают вместе, а прогон забирает тот, кто первый успел. Подробнее — в разделе [Встроенный исполнитель](/agents/test/docs/runner)
.

Честно об ограничениях с самого начала. Встроенный исполнитель работает без окна: посмотреть прогон глазами нельзя — для этого оставляют Chrome с дополнением. А само дополнение приватное: его нет в каталоге Chrome, ставится вручную из папки, которую готовит продукт.

Дальше: как устроены проекты и что лежит в их папках — в разделе [Проекты и настройки](/agents/test/docs/projects)
.

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