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

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

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

Примечание

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

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

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

Совместимый формат 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, который будет поддерживать интеграция:

     • Chat completions (/chat/completions);
     • Responses (/responses).

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

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

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

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

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

   Важно

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

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

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

   Примечание

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

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, и модель, которая будет использоваться по умолчанию в новых чатах Ассистента.

   • Модели — нажмите Настроить и выберите все модели, которые будут использоваться в чате Ассистента.

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

     Примечание

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

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

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. Напротив нужного подключения к ИИ-провайдеру нажмите ⋯ → Удалить → Да, удалить.

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