Настройка навыков Ассистента

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

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

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

Примечание

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

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

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

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

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

3. Нажмите + Навык → Создать навык.

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

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

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

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

     Важно

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

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

   • Модель — нажмите на выпадающий список и выберите название модели, которую вы хотите использовать.

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

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

     Примечание

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

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

     Тест-кейсы:

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

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

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

     Дефекты:

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

     Общие шаги:

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

     Проекты:

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

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

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

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

Библиотека навыков Ассистента

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

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

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

Созданный навык с пометкой (Copy) появится в списке навыков и станет доступен при вызове нового чата Ассистента.

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

Важно

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

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

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

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

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

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

# Шаги (выполнять строго по порядку)
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** — достаточно общий, но не слишком широкий и не на все сообщение.
- При привязке всегда передавай матчер (созданный или существующий), иначе другие результаты не разметятся.

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