Агенты Ассистента

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

Агентов можно копировать из других проектов ТестОпс. Создавая коллекцию агентов, вы формируете собственную базу знаний, которая помогает:

• систематизировать лучшие практики работы с ИИ;
• эффективно управлять накопленным опытом и методиками команды;
• масштабировать экспертизу команды на новые проекты и задачи.

Примечание

Чтобы создать, изменить или удалить агента, необходима проектная роль «Владелец проекта» или глобальная роль «Администратор».

Добавление агентов Ассистента в проект

Создание агента Ассистента

Чтобы создать агента Ассистента:

1. Перейдите в ваш проект ТестОпс.

2. Перейдите в раздел Настройки → Ассистент.

3. Нажмите + Агент → Создать агента.

4. Заполните поля:

   • Название — введите название, по которому можно легко определить назначение агента (например, Генерация тест-кейсов, Создание веб-тестов).

   • Описание — введите информацию, которая сохранит контекст и упростит выбор из похожих агентов. Опишите, зачем нужен агент, какую задачу он решает и какие данные ожидает на входе.

   • Среднее время выполнения агента вручную (в минутах) — введите среднее количество времени в минутах, за которое человек справляется с задачей, которую решает агент (например, создание тест-кейса вручную занимает около 30–40 минут).

     Важно

     Для корректной работы виджетов по агентам Ассистента поле Среднее время выполнения агента вручную должно быть обязательно заполнено. На основе этого значения рассчитываются показатели эффективности агента.

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

   • Инструменты ТестОпс — нажмите на выпадающий список и поставьте галочки напротив инструментов ТестОпс, которые могут потребоваться агенту.

     Примечание

     Инструмент ТестОпс — это функциональная возможность ТестОпс, которую может вызывать агент. Благодаря инструментам ТестОпс ИИ-модель может не только анализировать и генерировать текст, а создавать или обновлять сущности внутри вашего проекта. Например, чтобы создать тест-кейс, ИИ-модель использует инструмент ТестОпс Создать тест-кейс.

     Доступные инструменты ТестОпс

     Тест-кейсы:

     • Найти тест-кейс — поиск тест-кейса по основным и дополнительным метаданным, в том числе с возможностью запроса сгенерированного кода автотеста;
     • Создать тест-кейс — создание тест-кейса;
     • Обновить тест-кейс — обновление существующего тест-кейса;
     • Поместить в карантин — перенос тест-кейса в карантин;
     • Убрать из карантина — перенос тест-кейса из карантина;
     • Переместить тест-кейс в корзину — перемещение тест-кейса в корзину;
     • Восстановить тест-кейс — восстановление тест-кейса из корзины;
     • Запустить тест-кейсы — запуск автоматизированных тест-кейсов через настроенные джобы;
     • Получить детали задачи — получение подробной информации о задаче, связанной с тест-кейсом;
     • Получить детали требований — получение подробной информации о требовании, связанном с тест-кейсом.

     Запуски:

     • Найти запуски — поиск запусков с помощью AQL-запросов.

     Результаты тестов:

     • Найти результат теста — поиск результата теста по статусу, времени создания, метаданным и информации о связанном тест-кейсе, в том числе с возможностью запроса текстовых вложений шагов и фикстур.

     Дефекты:

     • Найти дефект — поиск дефекта по основным и дополнительным метаданным;
     • Создать дефект — создание дефекта с правилом автоматизации и привязка к существующим задачам и результатам тестов;
     • Привязать дефект — привязка дефекта к новым результатам тестов с использованием правила автоматизации;
     • Обновить дефект — обновление статуса и других метаданных дефекта.

     Общие шаги:

     • Найти общий шаг — поиск общего шага по названию;
     • Создать общий шаг — создание общего шага;
     • Обновить общий шаг — обновление существующего общего шага.

     Проекты:

     • Получить проект — получение подробной информации о проекте по его ID.

5. Нажмите Создать.

   Агент появится в списке всех агентов и станет доступен в чатах Ассистента.

Чтобы изменить, дублировать или удалить агента, нажмите ⋯ справа от названия агента и выберите нужное действие.

Копирование агента Ассистента из библиотеки агентов

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

Чтобы скопировать агента Ассистента из другого проекта ТестОпс:

1. Перейдите в ваш проект ТестОпс.
2. Перейдите в раздел Настройки → Ассистент.
3. Нажмите + Агент.
4. В секции Агенты из других проектов найдите и откройте нужного агента.
5. Проверьте, что поля настройки агента заполнены правильно.
6. Нажмите Добавить.

Созданный агент появится в списке агентов и станет доступен в чатах Ассистента.

Сортировка агентов Ассистента

Чтобы отсортировать список агентов Ассистента:

1. В разделе Настройки → Ассистент нажмите Опции.
2. В меню Сортировать по выберите тип метаданных, по которому нужно отсортировать агентов.
3. В меню Направление выберите направление сортировки.

Примеры агентов Ассистента

Важно

Приведенные ниже примеры носят ознакомительный характер. Их поведение зависит от конкретной ИИ-модели.

Создание тест-кейса

Агент создает тест-кейс в ТестОпс на основе краткого описания от пользователя.

Для этого агента выберите инструмент ТестОпс Создать тест-кейс и используйте промпт из примера ниже.

Пример промпта

# Цель
Создать структурированный тест-кейс в ТестОпс на основе неструктурированного описания от пользователя.

# Вход
Краткое описание от пользователя. Варианты: описание теста, требование, задача из таск-трекера.

# Шаги (выполнять строго по порядку)
1. Запроси у пользователя данные для теста. Не проси расписывать шаги: формулировать их — твоя задача.

2. Проанализируй данные и предложи черновик теста по шаблону ниже.
3. Задай уточняющие вопросы, если информации недостаточно.
4. Согласуй черновик с пользователем.
5. Создай тест-кейс в ТестОпс и выведи краткую информацию о нем со ссылкой.

# Шаблон тест-кейса
- Название — емкое, точно отражающее суть проверки.
- Описание — не дублирует шаги; емкое, понятное; описывает цель тестирования без слова «цель».
- Шаги — каждый шаг атомарный, один конкретный шаг.
- Кастомные поля — одно–три слова, емкие. Обязательно: Feature, Story. Остальные — по необходимости.

# Правила
- Первый шаг всегда: «Открываем главную страницу».
- Сценарий последовательный: нельзя сразу вводить логин/пароль — сначала вызови форму (например, кнопкой «Войти»).
- Каждый шаг детерминирован для браузера: «Нажимаем на кнопку **X**», «Вводим в поле **Y** значение _Z_».

# Важно
- Если пользователь подтвердил создание теста — сразу создавай, не переспрашивай.
- Обязательно уточни ожидаемый результат. Если пользователь не указал — предложи свой вариант.

Стилистическое улучшение тест-кейса

Агент дорабатывает существующий тест-кейс: делает шаги детерминированными, добавляет недостающие элементы и приводит к единому стилю. ИИ-модель читает сценарий, предлагает улучшенный вариант и обновляет тест-кейс в ТестОпс.

Для этого агента выберите инструмент Обновить тест-кейс и используйте промпт из примера ниже.

Пример промпта

# Цель
Улучшить существующий тест-кейс в ТестОпс: сделать его подробным, детерминированным и понятным для любого тестировщика.

# Вход
Тест-кейс с общим направлением проверки. ID тест-кейса — из контекста или от пользователя.

# Шаги (выполнять строго по порядку)
1. Получи сценарий тест-кейса. Если ID неизвестен — уточни у пользователя.
2. Проанализируй данные и предложи черновик по шаблону ниже.
3. Задай уточняющие вопросы, если информации недостаточно.
4. Согласуй черновик с пользователем.
5. Обнови тест-кейс в ТестОпс и выведи краткую информацию о нем со ссылкой.

# Шаблон (строгие правила)
- Детерминированность: каждый шаг — конкретное действие в браузере. Формат: [Глагол] [Объект] «[Значение]».
  Правильно: «Нажимаем кнопку **Войти**. Вводим в поле **Email** значение _test@example.com_».
  Неправильно: «Авторизоваться в системе. Заполнить форму».
- Последовательность: не пропускай шаги навигации.
- Первый шаг всегда: «Открываем главную страницу [URL]». Если URL не указан — используй [URL_приложения].
- Теги: обязательно добавь тег «AI».
- Название — емкое, точно отражающее суть (например, «Проверка успешной авторизации с валидными данными»).
- Описание — человекочитаемое, без слова «цель», не дублирует шаги.
- Кастомные поля: Feature и Story — обязательно, кратко (до 3 слов).
- Ссылки: если поле пустое — добавь ссылку на статью по теме на Википедии.

# Важно
Если пользователь подтвердил изменения — сразу обновляй, не переспрашивай.

Параметризация тест-кейса

Агент выявляет в сценарии повторяющиеся значения, предлагает параметры и обновляет тест-кейс с использованием параметризации. ИИ-модель анализирует шаги, согласует изменения с пользователем и применяет их в ТестОпс.

Для этого агента выберите инструмент Обновить тест-кейс и используйте промпт из примера ниже.

Пример промпта

# Цель
Выявить в сценарии тест-кейса значения для параметризации, создать параметры и обновить тест-кейс в ТестОпс.

# Вход
ID тест-кейса — из контекста или запроси у пользователя.

# Шаги (выполнять строго по порядку)
1. Получи сценарий тест-кейса по ID.
2. Найди в сценарии значения, указанные в явном виде и подходящие для параметризации.
3. Если параметров нет — сообщи об этом пользователю.
4. Если параметры найдены: создай таблицу имя/значение, покажи пользователю таблицу и шаги с заменой значений на {{название_параметра}}. Проверь общие шаги — если там есть те же параметры, используй их названия.
5. Спроси, согласен ли пользователь обновить тест-кейс.
6. Если согласен — установи параметры и обнови тест-кейс в ТестОпс.

# Параметры
Параметры передаются массивом: название параметра и его значения.

# Важно
Если пользователь подтвердил обновление — сразу обновляй, не переспрашивай.

Добавление общих шагов в тест-кейс

Агент заменяет повторяющиеся последовательности шагов в тест-кейсе на общие шаги. ИИ-модель сравнивает сценарий с библиотекой общих шагов, предлагает замены и обновляет тест в ТестОпс.

Для этого агента выберите инструменты Найти общий шаг, Создать общий шаг, Обновить тест-кейс и используйте промпт из примера ниже.

Пример промпта

# Цель
Заменить повторяющиеся последовательности шагов в тест-кейсе на общие шаги ТестОпс.

# Вход
ID тест-кейса — из контекста или от пользователя.

# Шаги (выполнять строго по порядку)
1. Получи сценарий тест-кейса по ID.
2. Получи список общих шагов проекта (без фильтра).
3. Найди в сценарии последовательности, которые можно заменить на общие шаги.
4. Покажи пользователю, какие шаги можно заменить.
5. Согласуй изменения с пользователем.
6. Обнови тест-кейс в ТестОпс.

# Правила
- Выполняй шаги строго по порядку, не пропускай этапы.
- Указывай тип шага (обычный или общий) при обновлении — пользователю об этом не сообщай.

# Важно
Если пользователь подтвердил изменения — сразу обновляй, не переспрашивай.

Создание дефекта для результата тест-кейса

Агент создает дефект или связывает существующий дефект с неуспешным результатом теста. ИИ-модель анализирует логи теста, предлагает причину сбоя, при необходимости создает дефект с правилом автоматизации и привязывает его к результату в ТестОпс.

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

Пример промпта

# Цель
Создать новый дефект или связать существующий дефект с результатом теста в ТестОпс.

# Вход
ID результата теста — из контекста или от пользователя.

# Шаги (выполнять строго по порядку)
1. Получи лог выполнения теста по ID.
2. Предложи пользователю возможную причину падения с контекстом.
3. Согласуй причину с пользователем.
4. Получи список существующих дефектов (без фильтра).
5. Проверь, подходит ли один из дефектов для этого сбоя.
6. Если подходящего дефекта нет: предложи черновик, согласуй с пользователем, создай дефект в ТестОпс.
7. Если подходящий дефект есть: согласуй с пользователем и используй его.
8. Создай или проверь матчер и привяжи дефект к результату теста:
   - если в дефекте уже есть матчер — проверь, подходит ли он к сообщению об ошибке;
   - если не подходит — предложи новый матчер, согласуй с пользователем;
   - привяжи дефект к результату теста с матчером.

# Дефект
- Название — емкое, четко отражающее суть проблемы.
- Описание — шаги воспроизведения, ожидаемый и фактический результат в человекочитаемом виде. Техническую информацию (**class**, **method**, **xpath** и т.п.) вынеси в отдельную секцию «Техническая информация».

# Матчер
- Используй только **messageRegexp**, не используй **traceRegexp**.
- **messageRegexp** — достаточно общий, но не слишком широкий и не на все сообщение.
- При привязке всегда передавай матчер (созданный или существующий), иначе другие результаты не разметятся.

# Важно
Если пользователь подтвердил действие — сразу выполняй, не переспрашивай.

Запуск автоматизированных тест-кейсов

Агент запускает автоматизированные тест-кейсы в CI-системе, с которой настроена интеграция. ИИ-модель находит нужные тест-кейсы, уточняет параметры запуска и создает запуск с помощью настроенных джоб ТестОпс.

Для этого агента выберите инструменты Найти тест-кейс, Запустить тест-кейсы и Найти запуски и используйте промпт из примера ниже.

Пример промпта

# Цель
Запустить автоматизированные тест-кейсы в ТестОпс и сообщить пользователю ссылку на созданный запуск.

# Вход
Название, ID или описание тест-кейсов — из контекста или от пользователя.

# Шаги (выполнять строго по порядку)
1. Найди автоматизированные тест-кейсы по запросу пользователя.
2. Если тест-кейсы не найдены или среди них есть ручные — сообщи об этом и уточни запрос.
3. Уточни у пользователя параметры запуска: название запуска, теги, задачи, релиз, переменные окружения и параметры джоб (если нужны).
4. Покажи пользователю список тест-кейсов и параметры запуска для подтверждения.
5. После подтверждения запусти тест-кейсы и выведи ссылку на созданный запуск.

# Правила
- Запускай только автоматизированные тест-кейсы.
- Не запускай тесты без явного подтверждения пользователя.

Анализ неуспешного результата автоматизированного теста

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

Для этого агента выберите инструменты Найти результат теста, Найти тест-кейс и используйте промпт из примера ниже.

Пример промпта

# Цель
Проанализировать причины неуспешного результата автоматизированного теста и предложить пользователю возможную причину сбоя.

# Вход
ID результата теста — из контекста или от пользователя.

# Шаги (выполнять строго по порядку)
1. Найди результат теста по ID и запроси вложения из шагов сценария и фикстур.
2. Изучи статус, шаги сценария, сообщения об ошибках и содержимое вложений (например, логи, HTML, Markdown).
3. Если нужно — найди связанный тест-кейс и запроси сгенерированный шаблон кода автоматизированного теста для контекста.
4. Предложи пользователю краткий анализ: на каком шаге упал тест, что отображается в логах и какая может быть причина.

# Правила
- Анализируй только текстовые вложения.
- Не придумывай детали, которых нет в данных результата теста.