К содержанию
Trialix
Интеграции

Подключим вашу систему

Если системы нет в каталоге, её можно подключить по REST, GraphQL, MCP, к базе данных только на чтение, к файлам или через вебхуки. Правила те же, что у готовых коннекторов: чтение в чате и агентах, запись после подтверждения сотрудника, обезличивание перед внешней моделью.

Типы подключения

Как подключается своя система

Выберите тип под то, что у системы уже есть. Администратор отмечает, какие методы доступны модели, а изменяющие данные выполняются только после подтверждения сотрудника.

REST API по OpenAPI

Своя система

Доступен, по документации

Если у вашей системы есть REST API с описанием OpenAPI, подключение занимает минуты. Загружаете файл спецификации или даёте ссылку, Trialix строит из неё инструменты, вы отмечаете разрешённые методы. Чтение работает сразу, изменяющие методы выполняются только после подтверждения сотрудника. Система во внутренней сети подключается через Trialix Connector без входящих портов.

Примеры запросов

  • Покажи статус заявки 1024 в нашей системе

GraphQL API

Своя система

Доступен, по документации

Для систем с GraphQL Trialix читает схему интроспекцией и даёт модели запрос к данным в пределах разрешённых корневых полей. Мутации по умолчанию выключены, а если вы их разрешите, каждая выполняется после подтверждения сотрудника.

Примеры запросов

  • Выведи последние десять заказов клиента из нашей системы

MCP-сервер

Своя система

Доступен, по документации

Model Context Protocol - открытый стандарт подключения инструментов к моделям. Если у вашей системы или у поставщика уже есть MCP-сервер, укажите адрес и способ входа: Trialix получит список инструментов, вы отметите разрешённые. Шаблоны MCP-сервера на Python и Node.js помогут обернуть свою систему за день.

Примеры запросов

  • Найди в документации Битрикс24 метод для списка сделок

База данных (только чтение)

СУБД

Доступен, по документации

Модель получает описание разрешённых таблиц и сама пишет SELECT-запросы, чтобы ответить на вопрос сотрудника: выручка по регионам, просроченные счета, остатки на складе. Подключение только на чтение на трёх уровнях: учётка без прав записи, транзакция только для чтения и проверка каждого запроса. Базы во внутренней сети подключаются через Trialix Connector, строка подключения при этом не покидает вашу сеть.

Примеры запросов

  • Сколько заказов было в сентябре по регионам

WebDAV

Файлы

Доступен, по документации

WebDAV поддерживают Яндекс Диск, Nextcloud, ownCloud, Р7-Офис и многие файловые серверы. Укажите адрес и папку, и Trialix будет забирать документы по расписанию, индексировать их и отвечать по ним со ссылкой на источник.

Примеры запросов

  • Найди в папке регламентов порядок согласования командировок

S3-хранилище

Файлы

Доступен, по документации

Документы в объектном хранилище становятся базой знаний для агентов: Yandex Object Storage, VK Cloud Object Storage, Selectel или свой MinIO. Trialix читает только указанный бакет и префикс, ключ доступа хранится в зашифрованном виде.

Примеры запросов

  • Что сказано в договорах из архива 2025 года про неустойку

Файловая шара (SMB)

Файлы

Доступен, по документации

Большая часть документов компании лежит на файловых шарах. Trialix Connector во внутренней сети читает указанную папку и передаёт документы на индексацию, без входящих портов и без выдачи доступа к серверу наружу.

Примеры запросов

  • Найди в папке «Договоры» все дополнительные соглашения с «Альфой»

Вебхуки

События

Доступен, по документации

Входящий вебхук даёт вашей системе адрес, куда отправлять события: новая заявка, оплата, сбой. Агенты видят последние события и могут отвечать по ним. Исходящие вебхуки сообщают вашим системам о событиях Trialix: пороги бюджета, итоги синхронизации каталога, ошибки коннекторов. Каждое исходящее событие подписано ключом компании.

Примеры запросов

  • Какие события пришли из CRM за последний час

SDK и API Trialix

Разработчикам

Доступен, по документации

Если вашей системе нужен не коннектор, а собственная логика, используйте публичный API Trialix, совместимый с OpenAI и Anthropic, или оберните систему в MCP-сервер по нашему шаблону на Python или Node.js и подключите как «MCP-сервер».

Примеры запросов

  • Как вызвать модель Trialix из нашей CRM

Подготовка

Что подготовить

  • Адрес и тестовая среда

    Адрес API и отдельный стенд с данными, на которых можно спокойно проверить чтение и запись.

  • Авторизация

    Ключ API, OAuth2 client credentials, токен или mTLS. Для Trialix лучше завести отдельную учётную запись с минимальными правами, для чтения - только на чтение.

  • Белый список IP

    Если система закрыта файрволом, добавьте адреса серверов Trialix: пришлём их в ответ на заявку. Система без внешнего адреса подключается через Trialix Connector.

  • Лимиты

    Сколько запросов в минуту выдерживает система. Trialix ставит свой лимит на компанию с запасом, чтобы модель не нагружала её в цикле.

  • Документация

    Описание OpenAPI, схема GraphQL, список методов или таблиц, которые можно давать модели, и что из этого только читает, а что меняет данные.

  • Ответственный

    Человек со стороны компании, который знает систему, выдаёт доступ и отвечает на вопросы во время настройки.

  • HTTPS и TLS 1.2+

    Подключаемся только по HTTPS с TLS версии 1.2 или новее и действующим сертификатом.

Свой код

Система на Python, Java, Go, PHP или .NET

Если у системы нет готового API или он неудобен для модели, есть два пути.

01

Обернуть в MCP-сервер

Возьмите шаблон MCP-сервера Trialix на Python или Node.js, опишите в нём инструменты и вызывайте из них код своей системы. Сервер подключается как «MCP-сервер» по Streamable HTTP с токеном или OAuth. Этот путь удобен, когда ответ собирается из нескольких запросов или расчёта.

Шаблоны в разделе «Разработчикам»

02

Выставить REST с OpenAPI

Добавьте в систему REST-методы и опишите их в OpenAPI 3: многие фреймворки строят такое описание из кода сами. Trialix прочитает спецификацию и сделает из неё инструменты, а вы отметите, какие методы разрешены модели.

Подходит и для систем внутри сети: через Trialix Connector.

Процесс

Как проходит подключение

  1. 01

    Заявка

    Форма ниже или письмо на sales@trialix.ru: какая система, что модели нужно читать и что менять, кто со стороны компании отвечает за подключение.

  2. 02

    Доступ

    Вы выдаёте тестовую среду, учётную запись с нужными правами и документацию, мы согласуем способ подключения: напрямую или через Trialix Connector.

  3. 03

    Настройка

    Подключение добавляется в личном кабинете компании. Trialix строит инструменты из описания API, администратор отмечает разрешённые методы и отделы.

  4. 04

    Проверка

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

  5. 05

    Запуск

    Подключение включается для нужных отделов политикой доступа. Вызовы видны в журнале, а администратор может отключить систему сам.

Данные

Что храним и где

Доступы
Ключи, токены и пароли хранятся в зашифрованном виде под ключом компании.
Данные систем
Отдельно не храним: ответ системы попадает к модели в момент вопроса и остаётся только в истории чата сотрудника. Перед внешней моделью персональные данные обезличиваются.
Исключения
Индекс источников знаний (папки, диски, вики) для поиска по документам и журнал вызовов: кто, когда и какой инструмент вызвал, без содержимого запросов и ответов.

Закрытая сеть

В контуре компании

Системы во внутренней сети подключаются через Trialix Connector. Он ставится на сервер компании, ходит к Trialix только исходящими запросами и выполняет вызовы внутри сети, поэтому входящие порты открывать не нужно, а строка подключения к базе данных остаётся в вашей сети.

Если вся платформа нужна внутри вашего контура без интернета, посмотрите TRX Appliance.

Заявка

Расскажите о своей системе

Что это за система, где она работает, что модели нужно читать и что менять. Ответим в течение рабочего дня.