Перейти к содержанию

Активити и роботы GPT24 в бизнес-процессах

Приложение GPT24 добавляет в конструктор бизнес-процессов и роботов Битрикс24 свои действия (активити) и роботов. В текущей версии существуют два поколения действий — новые универсальные GPT24 и сохранившиеся для совместимости коннекторы Qwen3.

Обзор действий

Действие Тип Где доступно Назначение
GPT24 активити (БП) Конструктор бизнес-процессов CRM Запрос к ИИ-модели с выбором модели портала
Робот GPT24 робот (воронки, смарт-процессы) Роботы CRM То же + запись ответа в поле сущности
Извлечение данных из json активити (БП) Конструктор бизнес-процессов CRM Разбор JSON-ответа в поля по конфигурации
Изменение сущности по json активити (БП) Конструктор бизнес-процессов CRM Заполнение полей сущности по JSON-маппингу
Qwen3 (бывшие YandexGPT, GigaChat, Perplexity, DeepSeek, OpenAI) активити и роботы БП и роботы CRM Совместимость со старыми шаблонами; выполняются на общей модели Qwen3

Все действия находятся в разделе Действия приложений конструктора бизнес-процессов (у роботов — в списке роботов с префиксом «Робот»).

Универсальная активити GPT24

Действие GPT24 («Вызов ии моделей из GPT24») — основной способ вызвать ИИ из бизнес-процесса.

Параметры:

Параметр Обязателен Описание
Инструкция нет Предварительное условие или контекст: роль, правила, ограничения
Запрос да Текст запроса к модели
Тип модели да Модель из списка доступных порталу (общие модели + собственные коннекторы портала, см. Модели и лимиты)
Температура нет От 0 до 2 (в зависимости от модели): выше — креативнее и случайнее ответы

Возвращаемые значения:

Поле Описание
Ответ Ответ модели
Сообщение об ошибке Текст ошибки; если ошибок нет — пустая строка

По этим полям строятся ветки бизнес-процесса: ответ попал в «Ответ» — успех, попал в «Сообщение об ошибке» — ветка ошибки.

Асинхронное выполнение

Активити GPT24 работают в режиме подписки (USE_SUBSCRIPTION): бизнес-процесс не блокируется — ответ возвращается, когда модель завершит генерацию.

Робот GPT24

Робот «Робот GPT24» имеет те же параметры, что и активити, плюс:

Параметр Описание
Поле для ответа Код поля сущности (UF_CRM_...), в которое будет записан ответ

Роботы доступны в воронках и смарт-процессах CRM — там, где работают штатные роботы Битрикс24, включая сделки, лиды, контакты, компании и элементы смарт-процессов.

JSON-активити для разбора ответов

Извлечение данных из json

Действие «Извлечение данных из json» разбирает JSON (например, ответ предыдущего запроса к модели) и возвращает выбранные значения отдельными полями.

Параметр Обязателен Описание
Конфигурация да Маппинг «путь в JSON → код поля». Путь записывается через точку
JSON да JSON-данные для разбора

Возвращает Ответ (JSON) и Сообщение об ошибке.

Пример: конфигурация

{
    "ФИО.full_name": "UF_CRM_FULL_NAME",
    "ФИО.gender": "UF_CRM_GENDER"
}

извлечёт из JSON {"ФИО": {"full_name": "Иванов Иван", "gender": "Мужчина"}} значения по путям и вернёт коды полей с данными.

Изменение сущности по json

Действие «Изменение сущности по json» заполняет поля CRM-сущности данными из JSON — без ручного сопоставления полей в конструкторе.

Параметр Обязателен Описание
Конфигурация да Маппинг «путь в JSON → код поля сущности»
JSON да JSON-данные
Код объекта для обработки нет Сущность, поля которой заполняются. Может не совпадать с той, для которой запущен БП

Код объекта состоит из префикса и числового идентификатора:

Префикс Сущность Пример
L_ Лид L_123, L_{{ID}}
C_ Контакт C_{{Контакт: ID}}
CO_ Компания CO_{{Компания: ID}}
D_ Сделка D_{{ID}}
DYNAMIC_<entityTypeId>_ Элемент смарт-процесса DYNAMIC_168_{=A83852_44556_90232_35877:ItemId}

Типичный конвейер: активити GPT24 возвращает JSON со структурированными данными → «Изменение сущности по json» раскладывает их по полям — или «Извлечение данных из json» передаёт дальше по процессу.

sequenceDiagram
    participant BP as Бизнес-процесс
    participant GPT as GPT24 (модель)
    participant CRM as Сущность CRM
    BP->>GPT: Запрос + Инструкция + Тип модели
    GPT-->>BP: Ответ (JSON)
    BP->>CRM: Изменение сущности по json
    CRM-->>BP: Поля заполнены

Коннекторы Qwen3 (совместимость)

Ранее приложение устанавливало отдельные коннекторы YandexGPT, GigaChat, Perplexity, DeepSeek и OpenAI. В текущей версии все они переименованы в Qwen3 и выполняются на единой общей модели приложения (Qwen3-30B-A3B).

Выбор модели в старых коннекторах не влияет на результат

В коннекторах Qwen3 поле «Тип модели» сохранено для совместимости со старыми шаблонами, но запрос в любом случае выполняется на приоритетной общей модели приложения. Для выбора конкретной модели используйте активити GPT24.

Старые шаблоны бизнес-процессов продолжают работать без изменений. При доработке процессов рекомендуем заменять коннекторы Qwen3 на универсальную активити GPT24.

Если выбранная в параметрах модель недоступна, GPT24 автоматически выполнит запрос на приоритетной общей модели и зафиксирует это в журнале.

Связанные разделы: Введение · Настройки приложения · Модели и лимиты · Примеры использования

Обращайтесь к нашим специалистам

По любым вопросам настройки и расширения имеющегося функционала приложений обращайтесь в нашу службу поддержки.

Мы всегда поможем вам решить вашу задачу.