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

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

После настройки интеграции вы сможете:

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

Примечание

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

Требования к ИИ-провайдеру и модели

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

Совместимый формат API и поддержка MCP

ИИ-провайдер должен предоставлять доступ к модели через OpenAI-совместимый API в одном из форматов:

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

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

Нативная поддержка вызова инструментов

Модель должна поддерживать нативный вызов инструментов (tool calling или function calling) — вызывать инструменты через API, а не описывать словами намерение их вызвать.

Если модель не поддерживает нативный вызов инструментов или делает это нестабильно — например, ломает структуру вызовов или пропускает обязательные параметры — Ассистент не сможет корректно работать с инструментами ТестОпс и инструментами внешних MCP-серверов.

Контекстное окно модели

Минимальный размер контекстного окнаМаксимальный объем информации в токенах, который модель может учесть в рамках одного запроса модели — от 64000 токенов.

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

     Примечание

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

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

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

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

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

     Важно

     Модель должна соответствовать требованиям к модели.

   • в поле Размер контекстного окна (токены) введите размер контекстного окна указанной модели в токенах;

     Важно

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

     Если поле не заполнено, используется размер по умолчанию из настроек инстанса ТестОпс. Подробнее см. Контекстное окно в чате Ассистента.

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

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

   Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Размер контекстного окна (токены): 64000

Параметр temperature:

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

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

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

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

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

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

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

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

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

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

   Важно

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

   Чтобы запретить использование персональных учетных данных, уберите галочку напротив этой настройки.

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

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

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

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

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

1. Перейдите в ваш проект ТестОпс → раздел Настройки → Ассистент.

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

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

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

   Примечание

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

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

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

5. Укажите персональные учетные данные для взаимодействия с ИИ-провайдером

Если при настройке интеграции на шаге 2 и шаге 3 было разрешено использовать персональные учетные данные, каждый участник проекта может добавить их самостоятельно.

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Важно

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

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

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

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

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

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

Важно

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

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

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

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

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