Задача
Клиент присылает финальную спецификацию в PDF. Менеджер уже внёс товары в сделку, но в последней версии клиент поменял количество и добавил одну позицию. Когда сделка переходит на этап Проверка перед отгрузкой, MoreKIT сверяет документ с карточкой. Если есть расхождения, ответственный получает задачу со списком конкретных правок и меняет этап сделки на сверку
Подключение Битрикс24
Перед добавлением сервиса Битрикс24 в MoreKit необходимо установить приложение наше приложение в маркетплейсе. Для установки приложения требуется подписка на маркетплейс Битрикс24
После установки приложения MoreKit в маркетплейс Битрикс24 можно приступать к добавлению сервиса в Morekit. Для этого в проекте нажмите Добавить сервис, найдите в списке Битрикс24. При подключении сервиса будет запрошена ссылка на ваш битрикс
Введите ссылку в формате https://мой-домен.bitrix24.ru. После этого произойдет редирект на страницу с вашим битриксом, подтвердите авторизацию
Если все правильно — сервис появится в списке сервисов и у него будет статус Готово
Пополнение ИИ баланса
Для использования ИИ блоков внутри MoreKIT необходимо пополнить ИИ баланс
Заходим в раздел О проекте —> оплата, пополняем ИИ баланс на любую сумму
В данном кейсе будет использован блок Запрос на ответ модели. Данный блок будет отправлять в ИИ файл с КП для сравнения его со списком товаром в сделке
Создание процесса
Далее — создадим процесс с типом Другое. Данный процесс будет запускаться при переходе сделки на этап сверки
Далее — копируем ссылку на процесс из первого блока. Это необходимо для передачи данных с робота Битрикс24 на процесс MoreKIT, чтобы произошел запуск процесса
Установка триггера
На нужном этапе в Битрикс24 устанавливаем робота, который будет запускать процесс
Вставляем ссылку на процесс в раздел Хэндлер. В запросе отправим ID сделки, этого будет достаточно. После ссылки поставьте знак вопроса и пропишите: ?ID={{ID}}
Итоговый вариант ссылки должен быть: https://ep.morekit.io/xxxxxxxxxxx?ID={{ID}}
Настройка схемы
Схема в MoreKIT будет выглядеть следующим образом:
Данная схема:
- Получает полные данные о сделке по ID от робота
- Проверяет, лежит ли в поле сделки файл с КП. Если файла нет — ставит задачу на менеджера
- Отправляет файл и товары сделки в ИИ
- Проверяет ответ ИИ на наличие расхождений
- Если расхождений нет — комментарий в сделку об успешной сверке. Если расхождения есть — постановка задачи на ответственного за сделку и смена на этап сверки
Описание блоков схемы
#1 Найти сделки — получаем полные данные о сделке по ID, который полчили от робота
#2 Проверка — проверяем наличие КП, загруженного в поле сделки
#3 Создать задачу — если поле с кп пустое, ставим задачу на менеджера сделки
#5 Получить товарные позиции — получаем список позиций из сделки
#4 Запрос на ответ модели — формируем запрос к ИИ
Сообщение от разработчика
дельное внимание здесь стоит уделить промпту. Описывайте в промпте, что именно должен проверять AI-агент
Пример промпта по данному кейсу:
Сравни товары из приложенного КП с товарами сделки в Битрикс24.
Сопоставь товары по названию из поля PRODUCT_NAME. Для каждой
совпавшей позиции проверь два значения:
- Количество в КП и QUANTITY в сделке.
- Цена за единицу в КП и PRICE в сделке.
Сравнивай значения как числа: «1 200,00 ₽» и 1200 — одна и та же цена.
Сумму по строке и итоговую сумму КП пропускай.
Если количество или цена отличаются, перечисли все расхождения
в next_action. Для каждого укажи товар и оба значения:
«Проверьте цену кронштейна КР-40: в КП 850 ₽, в сделке 900 ₽».
Если товар отсутствует в одном из списков, совпадение неоднозначно
или значение не читается, попроси менеджера сверить эту позицию вручную.
Если все товары сопоставлены и количество и цена совпадают, верни null
в next_action.
Товары сделки в Битрикс24 будут в сообщении пользователя
JSON SCHEMA
здесь необходимо указать формат ответа в виде JSON данных, которые будет отдавать ИИ в ответе. Пример схемы из текущего кейса:
{
"type": "object",
"properties": {
"next_action": {
"type": ["string", "null"]
}
},
"required": ["next_action"],
"additionalProperties": false
}
Ссылка на файл
В данном блоке передаем ссылку на файл с pdf. Так как файл в текущем примере скачивается из Битрикс24 — перед ссылкой указываем домен битрикса.
Итоговый формат ссылки должен быть: https://мой домен.bitrix24.ru{{ссылка}}. Требование к ссылке — публичный доступ, чтобы AI мог скачать файл
Сообщение пользователя
В сообщении пользователя передаем данные из блока получения товарных позиций Битрикс24
#7 JSON декодировать — преобразуем текст ответа ИИ в объект, чтобы получить поле next_action из промпта
#8 Проверка — Проверяем, отдал ли ИИ инструкции для менеджера. Данная проверка разделяет логику схемы. Если от ИИ мы получили next_action = null, уходим на комментарий об успешной сверке. Если в next_action пришёл текст, этот текст передаём в задачу и меняем этап сделки
#9 Добавить комментарий — если следующего шага для менеджера не будет, прикрепляем комментарий, что проверка прошла
#12 Редактировать сделку — перемещаем сделку на этап для контроля сверки
#11 Создать задачу — создаем задачу менеджеру с описанием сверки от ИИ, если есть расхождение между КП и списком товаров в сделке
Тестирование
Проверим, как работает процесс
Без КП
Для начала — оставим поле с КП пустым и переместим сделку на этап отработки триггера
В результате сработки процесса — получим задачу в сделке об отсутствии с КП
Проверить, как прошла схема можно в Событии
Отправка с КП без отличий
Теперь попробуем прикрепить КП к сделке. Позиции в КП будут совпадать с товарами сделки
Пример КП
Пример товаров в сделке
Прикрепляем КП к сделке и запускаем процесс снова, двигая сделку снова на этап, либо через повтор события
Пример с отличием КП и товаров
Теперь увеличим количество товаров в сделке, чтобы их количество отличалось от КП и отправим сделку снова
Двигаем сделку и получаем результат
Как видим — сделка сменила статус на Нужна сверка с кп и создалась задача
Посмотрим, что написано в задаче
Как видим — ИИ сверил позиции товаров сделки с КП и нашел отличия, которые описал в задачу
Подведем итоги
В данной статье рассмотрели пример подключения ИИ для контроля отгрузки. ИИ умеет считывать информацию с КП, согласно нашему промпту, в результате чего контролирует соответствие КП и товаров сделки