Интеграция с ИИ-провайдером

Интеграция с ИИ-провайдеромСервис, который предоставляет доступ к ИИ-моделям позволяет:

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

Примечание

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

Настройка интеграции и подключений с ИИ-провайдером

Чтобы настроить интеграцию с ИИ-провайдером:

1. Создайте токен доступа на сайте ИИ-провайдера.
2. Подключите интеграцию с ИИ-провайдером на уровне инстанса ТестОпс.
3. Настройте Ассистента в разделе Администрирование.
4. Добавьте настроенное подключение к ИИ-провайдеру в проект ТестОпс.
5. Настройте Ассистента в проекте.

1. Создайте токен доступа на сайте ИИ-провайдера

Примечание

Для интеграции локальной ИИ-модели, которая работает на вашем собственном сервере (например, через Ollama), токен доступа не требуется. Вы можете сразу перейти к шагу 2.

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

2. Подключите интеграцию с ИИ-провайдером на уровне инстанса ТестОпс

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

2. Перейдите в раздел Администрирование → Интеграции.

3. Нажмите Добавить интеграцию.

4. В списке доступных интеграций выберите ИИ-провайдер.

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

   • Название подключения — введите название, которое поможет вам распознать интеграцию (например, OpenRouter Assistant).

   • Endpoint — введите URL-адрес, по которому ТестОпс будет обращаться к ИИ-провайдеру.

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

     • Все (глобальные и проектные) — интеграция может работать как с глобальными, так и с проектными учетными данными;
     • Только глобальные — интеграция может работать только с глобальными учетными данными;
     • Только проектные — интеграция может работать только с проектными учетными данными.

     Примечание

     Подробнее о поддерживаемых типах учетных данных см. Интеграции с внешними системами → Учетные данные внешних систем.

   • Формат API — нажмите на выпадающий список и выберите формат API, который будет поддерживать интеграция:

     • Chat completions (/chat/completions) — интерфейс OpenAI без сохранения состояния диалога (для каждого нового запроса программа должна передавать всю предыдущую историю сообщений). Инструменты подключаются через механизм вызова функций;
     • Responses (/responses) — интерфейс OpenAI с сохранением состояния диалога, который автоматически управляет историей переписки и включает в себя готовые инструменты. Предназначен для создания агентных ИИ-приложений.

6. Если ИИ-провайдер использует самоподписанный SSL-сертификат, уберите галочку напротив Проверка SSL-сертификата.

7. Если интеграция может работать с глобальными учетными данными ИИ-провайдера, в секции Глобальные учетные данные нажмите + Заголовок и заполните поля:

   • Название HTTP-заголовка — введите заголовок HTTP-запроса;
   • Значение — введите тип авторизации и токен доступа, который вы сохранили на шаге 1.

8. В секции Модели:

   • в поле Название модели введите название ИИ-модели, которую вы планируете использовать;

   Важно

   Модель должна поддерживать OpenAI-совместимый API и протокол MCPОткрытый стандарт, который позволяет ИИ-модели подключаться к внешним системам.

   • для каждого параметра ИИ-модели, который вы планируете указать, нажмите + Параметр и заполните поля:

     • Название параметра — введите название параметра ИИ-модели;
     • Тип — нажмите на выпадающий список и выберите тип значения параметра;
     • Значение — введите значение параметра.

   Примечание

   Чтобы добавить несколько моделей в интеграцию, нажмите + напротив секции Модели и заполните поля для каждой модели.

   Совет

   В рамках внутреннего тестирования требований к работе Ассистента мы оценивали производительность модели Qwen3-Coder-Plus. Она поддерживает интеграцию с OpenRouter и Ollama. DeepSeek Coder также демонстрирует стабильную работу. Модель можно развернуть через интеграцию с OpenRouter и напрямую через API провайдера.

   Мы получили обратную связь о проблемах с YandexGPT — из-за особенностей архитектуры этой модели возникают ошибки при потоковой передаче с большим количеством инструментов ТестОпс.

9. Нажмите Добавить подключение.

Пример заполнения полей в интеграции с ИИ-провайдером

Основные настройки:

Название подключения: Deepseek Assistant

Endpoint: https://api.deepseek.com/v1

Тип учетных данных: Все (глобальные и проектные)

Глобальные учетные данные:

Название HTTP-заголовка: Authorization

Значение: Bearer sk-proj-1234567890abcdef

Модель и параметры:

Название модели: deepseek-chat

Параметр temperature:

• Тип: число
• Значение: 1

В разделе Администрирование → Интеграции появится интеграция с ИИ-провайдером с одним автоматически созданным подключением.

3. Настройте Ассистента в разделе «Администрирование»

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

Чтобы настроить Ассистента на уровне инстанса:

1. Перейдите в раздел Администрирование → Ассистент.

2. В правом верхнем углу нажмите Настроить.

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

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

   Примечание

   Приветственное сообщение и контекст необязательны для работы Ассистента — вы можете заполнить их позже при необходимости.

4. Нажмите Сохранить.

4. Добавьте настроенное подключение к ИИ-провайдеру в проект ТестОпс

Чтобы добавить настроенное подключение к ИИ-провайдеру в нужный проект ТестОпс, воспользуйтесь одним из способов:

1. В ТестОпс перейдите в раздел Администрирование → Интеграции.

2. В списке настроенных интеграций найдите и откройте интеграцию с ИИ-провайдером.

3. В списке настроенных подключений найдите и откройте ваше подключение к ИИ-провайдеру.

4. Нажмите Добавить в проект.

5. В списке доступных проектов выберите нужный проект ТестОпс.

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

   • Проектные — использовать проектные учетные данные для подключения к ИИ-провайдеру;
   • Глобальные — использовать глобальные учетные данные для подключения к ИИ-провайдеру.

7. Если интеграция будет работать с проектными учетными данными ИИ-провайдера, в секции Проектные учетные данные нажмите + Добавить и заполните поля:

   • Заголовок — введите заголовок HTTP-запроса;
   • Значение — введите тип авторизации и токен доступа, который вы сохранили на шаге 1.

8. Нажмите Добавить в проект.

5. Настройте Ассистента в проекте

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

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

3. Нажмите Настроить.

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

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

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

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

     Примечание

     Контекст проекта необязателен для работы Ассистента — вы можете заполнить его позже при необходимости.

5. Нажмите Сохранить.

   После сохранения вы сможете настроить агентов Ассистента и начать работу с Ассистентом в отдельном чате.

Персональные учетные данные для взаимодействия с ИИ-провайдером

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

Примечание

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

Подробнее о типах учетных данных см. Интеграции с внешними системами → Учетные данные внешних систем.

Чтобы добавить персональные учетные данные для взаимодействия с ИИ-провайдером:

1. В ТестОпс нажмите на ваш аватар и перейдите в раздел Интеграции.

2. Нажмите Добавить интеграцию.

3. В списке настроенных интеграций найдите и откройте интеграцию с ИИ-провайдером.

4. Если в инстансе ТестОпс настроено несколько подключений к ИИ-провайдерам, в поле Подключение нажмите на выпадающий список и выберите нужное подключение.

5. В секции Персональные учетные данные нажмите + Добавить и заполните поля:

   • Название HTTP-заголовка — введите заголовок HTTP-запроса;
   • Значение — введите тип авторизации и личный токен доступа к ИИ-провайдеру (токен можно получить как описано в шаге 1).
   Пример заполнения персональных учетных данных

   Название HTTP-заголовка: Authorization

   Значение: Bearer sk-proj-1234567890abcdef

6. Нажмите Добавить подключение.

Удаление подключений и интеграции с ИИ-провайдером

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

Удаление подключения на уровне проекта

Важно

Последствия удаления всех подключений из интеграции с ИИ-провайдером на уровне проекта:

• Подключения к интеграции с ИИ-провайдером перестанут отображаться в списке подключений проекта, но продолжат работать в других проектах инстанса, в которых они были добавлены, и сохранятся в разделе Администрирование → Интеграции.
• Интеграция с ИИ-провайдером перестанет отображаться в списке интеграций проекта, но сохранится в разделе Администрирование → Интеграции.
• Ассистент перестанет работать и будет недоступен в вашем проекте, но продолжит работать в других проектах, в которых подключения остались активными.
• В разделе Настройки → Ассистент перестанут отображаться созданные агенты, но они останутся доступны для других проектов.
• В разделе Администрирование → Ассистент сохранятся все настройки (приветственное сообщение, контекст компании и контекст агентов).

Чтобы удалить подключение на уровне проекта:

1. Перейдите в ваш проект ТестОпс.
2. Перейдите в раздел Настройки → Интеграции.
3. В списке настроенных интеграций найдите и откройте интеграцию с ИИ-провайдером.
4. Напротив нужного подключения к ИИ-провайдеру нажмите ⋯ → Удалить → Да, удалить.

Подключение перестанет работать в вашем проекте.

Удаление подключения на уровне инстанса

Важно

Последствия удаления всех подключений из интеграции с ИИ-провайдером на уровне инстанса:

• Подключения и интеграция с ИИ-провайдером будут полностью удалены.
• Ассистент перестанет работать и будет недоступен во всех проектах, но его настройки (приветственное сообщение, контекст компании и контекст агентов) сохранятся в разделе Администрирование → Ассистент.
• Во всех проектах в разделе Настройки → Ассистент сохранятся созданные агенты.

Чтобы удалить подключение на уровне инстанса:

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

Подключение перестанет работать во всех проектах инстанса.