Проблемы удобно смотреть глазами, но чинить их — работа программиста. Чтобы не пересказывать ему список вручную, у продукта есть отдельный вход для программ: по ключу доступа агент-программист забирает проблемы, читает доказательства, правит код и отмечает, что исправлено. Ниже — что доступно и как не выстрелить себе в ногу с ключом.
Зачем это нужно
Агент тестирования находит проблемы, но не правит сайт — это работа того, кто пишет код. Замкнутый цикл получается, когда чинить тоже умеет программа: тогда проверка сама сообщает о поломке, исправление приходит, а следующий запуск подтверждает результат. Так работают связки с агентами-программистами, например с Pastukhov Agent.
Что доступно по ключу
- Список проблем — с отбором по проекту и статусу.
- Карточка проблемы — всё то же, что видите вы: снимок, элемент, сообщение, история, число повторов. Снимок доступен и отдельной ссылкой.
- Смена статуса — закрыть или открыть заново.
- Отчёт по экрану — целиком вся история страницы: замечания, проверки, типы экранов. Удобно, когда разбираться надо не в отдельной ошибке, а в целой странице.
- Всё остальное, что умеет интерфейс — проекты, экраны, правила, действия, тесты, запуски, расписания и разбор сборок. Отдельным семейством идёт визуальная часть: сборки, снимки, сравнения, эталоны, список «что ждёт решения», общие ссылки и чтение визуальных настроек.
Пример запроса — просто чтобы показать, что это обычный текстовый вызов, а не какое-то особое устройство:
curl -H "X-API-Key: КЛЮЧ" https://ваш-сервер/api/ext/issues?project=shop&status=openДолгоживущие ключи
Кроме ключа из настроек сервера есть долгоживущие ключи. Такой ключ выпускают в интерфейсе, показывают один раз и подставляют в заголовок Authorization: Bearer taj_… вместо X-API-Key. Он нужен там, где ключ окружения неудобен: в сборке CI, в командной строке, у внешнего клиента модели.
Права у ключа два: «только чтение» — читать и помечать, и «чтение и запись» — ещё и менять. Отзывается мгновенно: все, кто им пользовался, сразу перестают проходить проверку. Подробности — в разделе Ключи API.
Что будет без ключа
Если ключ не задан, эти адреса отвечают «не настроено» — то есть доступ просто выключен. Если ключ неверный — отказ. Вход по логину и паролю здесь не работает вообще: это разные способы доступа, и браузерная сессия для программ не годится. Так и задумано: внешний доступ существует для машин, и у него своя дверь.
Рабочий цикл
- Агент-программист забирает открытые проблемы проекта.
- По каждой смотрит доказательства: сообщение, элемент, снимок — и понимает, что сломалось.
- Правит код сайта и отмечает проблему закрытой.
- Следующий запуск проверяет то же место и подтверждает, что проблема ушла.
Если правка не помогла, проблема откроется снова сама — тут продукт и замыкает круг, и не даёт обмануть себя отчётом «исправлено».
Ключ — как пароль
Ключ доступа можно посмотреть и скопировать в разделе Настройки → Тестирование UI — он же используется дополнением Chrome. Относитесь к нему как к паролю: он даёт доступ к списку проблем и к снимкам страниц. Выдавайте его только тем, кто действительно должен видеть эти данные, и не выкладывайте в общедоступные места.
И одно честное ограничение: одобрить эталон через внешний доступ нельзя. Ни один ключ, с любыми правами, не может принять визуальное отличие — решение всегда остаётся за человеком в браузере. Так сделано нарочно: одобрение меняет то, с чем сравниваются все будущие сборки.
По тому же ключу работают и MCP-инструменты: их девять, и они закрывают визуальный цикл — запустить сборку, получить список «что ждёт решения», посмотреть отличие, сравнить заново, предложить решение по группе, запустить починку теста, опубликовать доказательства, получить справку. Одобрить эталон инструменты тоже не могут. Как это устроено — в разделе Живая страница и MCP.
А для сборки CI есть готовый инструмент командной строки viz: он запускает сборку и ждёт результат, отвечая кодом выхода 0 — успех, 7 — требуется решение человека, 8 — провал. Он ничего не одобряет: команды «одобрить» в нём просто нет. Подробности — в разделе CI и уведомления.
Дальше: как агент чинит сломавшиеся проверки сам — в разделе Автоисправление.