Внешний доступ для агентов

Проблемы удобно смотреть глазами, но чинить их — работа программиста. Чтобы не пересказывать ему список вручную, у продукта есть отдельный вход для программ: по ключу доступа агент-программист забирает проблемы, читает доказательства, правит код и отмечает, что исправлено. Ниже — что доступно и как не выстрелить себе в ногу с ключом.

Зачем это нужно

Агент интерфейсов находит проблемы, но не правит сайт — это работа того, кто пишет код. Замкнутый цикл получается, когда чинить тоже умеет программа: тогда проверка сама сообщает о поломке, исправление приходит, а следующий запуск подтверждает результат. Так работают связки с агентами-программистами, например с Pastukhov Agent.

Что доступно по ключу

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

Пример запроса — просто чтобы показать, что это обычный текстовый вызов, а не какое-то особое устройство:

curl -H "X-API-Key: КЛЮЧ" https://ваш-сервер/api/ext/issues?project=shop&status=open

Что будет без ключа

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

Рабочий цикл

1. Агент-программист забирает открытые проблемы проекта.
2. По каждой смотрит доказательства: сообщение, элемент, снимок — и понимает, что сломалось.
3. Правит код сайта и отмечает проблему закрытой.
4. Следующий запуск проверяет то же место и подтверждает, что проблема ушла.

Если правка не помогла, проблема откроется снова сама — тут продукт и замыкает круг, и не даёт обмануть себя отчётом «исправлено».

Ключ — как пароль

Ключ доступа можно посмотреть и скопировать в разделе Настройки → Тестирование UI — он же используется дополнением Chrome. Относитесь к нему как к паролю: он даёт доступ к списку проблем и к снимкам страниц. Выдавайте его только тем, кто действительно должен видеть эти данные, и не выкладывайте в общедоступные места.

Дальше: как агент чинит сломавшиеся проверки сам — в разделе Автоисправление.

← Оглавление документации