Как сделать ИИ-приложение для бизнеса: вайбкодинг на примере отдела продаж в Битрикс24
Вайбкодинг – это когда приложение пишет нейросеть, а человек объясняет ей задачу обычным текстом. На вебинаре руководитель проектов Глеб Демидов за 21 минуту 53 секунды собрал в прямом эфире приложение для Битрикс24, которое делает коммерческое предложение из данных сделки.
Статья для тех, кто хочет повторить это у себя: что такое вайбкодинг, какие инструменты нужны, как написать промт, сколько это стоит и как собрать своё приложение по шагам.
Содержание
Как работать с ИИ: промт, системный промт и инструменты для сборки
Умные документы: по сути это ИИ-агент. Как определить задачу и написать промт
1. Что такое вайбкодинг
Вайбкодинг – это разработка приложения текстом. Человек описывает ИИ-ассистенту результат: откуда брать данные, что показывать, что отдавать на выходе. Ассистент пишет код, выкладывает приложение на сервер и правит ошибки.
Для бизнеса это своё приложение под конкретный процесс без подключения отдела разработки. Для отдела продаж, например, свой генератор КП, счетов, актов, любого документа из данных сделки. Этот пример и разбираем дальше.
2. Какие документы собираются из данных CRM
Автоматически готовится любой документ, для которого данные уже есть в системе. В сделке Битрикс24 лежит почти всё:
клиент и и его данные
компания и реквизиты
товары и сумма
ответственный менеджер
комментарии и договорённости
Из этого набора собираются КП, счёт, акт, договор, бриф, техническое задание, отчёт по поддержке и другие документы.
Два способа формирования документов в Битрикс24
Печатные формы. Штатный инструмент: шаблон с метками полей, в которые система подставляет данные сделки, контакта и компании. Для типового счёта или акта хватает. Как настроить печатные формы самостоятельно, мы рассказывали на прошлом вебинаре: {ссылка на запись}.
Но форма работает по жёсткому регламенту: что в поле лежит, то и попадёт в документ. Что менеджер написал в комментарии или не в то поле, в форму не попадёт или попадёт с ошибкой. Отсюда постоянные доработки:
под новое поле нужно открыть настройки или переписать шаблон
договорённости со звонка дописываются вручную
в реквизитах всплывает чужой ИНН из прошлого КП
В итоге менеджер открывает прошлое КП, копирует его, меняет реквизиты и переписывает текст. И так для каждой сделки.
Вайбкодинг или Умные документы. Своё приложение во вкладке сделки. Забирает все поля сделки, включая пользовательские, ИИ формулирует текст под клиента, сервер собирает файл Word и кладёт на общий Диск.
Структура документа описана в системном промте, мелкие доработки достаточно описать текстом тому же AI-ассистенту. Например, изменить тон или добавить описание. Раньше такое заказывали у разработчиков по ТЗ, теперь собирается за один сеанс.
Умные документы закрывают около 90% задачи. Менеджеру остаются 10%, только проверить документ и отправить клиенту.
3. Как работать с ИИ: промт, системный промт и инструменты для сборки
Для того чтобы собрать своё приложение, надо немного разобраться с терминологией. В вайбкодинге есть два важных термина:
Промт. Это текстовый запрос, которым ставится задача нейросети. Всё, что пишется в чат ИИ-ассистенту, он воспринимает как задачу.
Системный промт. Тот же самый текстовый запрос, но немного больше и сложнее. Это должностная инструкция для ИИ, зашитая внутрь приложения. Пользователь её не видит, но при каждой генерации документа она применяется по умолчанию: роль ИИ, формат документа, что можно и что нельзя. В «Умных документах», например, есть два важных правила:
ИИ не выдумывает цены, сроки, скидки, реквизиты. Если нет данных в сделке, не упоминает их.
ИИ отдаёт только текст. Файл собирает сервер по заданной фиксированной структуре. Так шаблон документа не будет ломаться.
Как писать промт
Главная ошибка – написать «сделай приложение для КП» и ждать чуда. С ассистентом общаются как с разработчиком. В промте должно быть заранее расписано:
зачем приложение
как выглядит интерфейс
откуда оно берёт данные
что ему запрещено делать
какой результат ожидается на выходе
заложить проверку на работоспособность
Такой промт удобно использовать в файле .md: обычный текст с простой разметкой, нейросеть читает его без лишнего форматирования и не тратит лимиты на то, чтобы понять, что от неё хотят. Готовый .md для приложения «Умные документы» лежит в материалах вебинара, его можно брать как шаблон под любой документ. Полный разбор файла по разделам ниже.
Доработки после первой сборки идут короткими отдельными промтами, ассистент помнит контекст.
Что нужно для сборки
Три вещи: нейросеть, которая напишет приложение, место, где оно будет работать, и модель, которая будет писать текст документов. Вот подборка инструментов для сборки приложений для бизнеса. Часть зарубежных сервисов не всегда доступна в России, способы оплатить и получить доступ есть.
ИИ-конструкторы – вариант без кода: агент собирается из готовых блоков в визуальном интерфейсе, порог входа ниже.
Помимо AI-ассистента нужна инфраструктура. В Битрикс24 есть сервисы, которые нужны для создания приложения. Все они входят в стоимость коммерческого тарифа Битрикс24:
Ещё три слова, которые встретятся дальше:
Промтить – писать приложение текстом.
Деплоить – выкладывать готовое приложение на сервер, без этого им нельзя пользоваться из портала.
Вайбы – внутренняя валюта платформы Битрикс24, списывается за сервер и работу модели.
4. Сколько стоит вайбкодинг: как прикинуть под свои задачи
Точных сумм нет, они зависят от тарифа портала, вашей задачи, нагрузки на сервер и количества генераций. Но посчитать можно, стоимость складывается из пяти статей.
На что ориентироваться:
Вход бесплатный. У любого коммерческого портала есть грант на тестирование, минимальный сервер на старте бесплатный.
После десятка сгенерированных КП система показала меньше 0,1% бесплатной квоты. За месяц обычной работы отдела продаж за лимит выйти сложно.
Через пару недель работы стоит зайти в «AI-модели» и посмотреть реальный расход. Если не хватает, квота расширяется.
Акция: при первой покупке годовой лицензии через партнёра Битрикс24 клиент получает 5000 вайбов вместо 1000.
5. Умные документы: по сути это ИИ-агент. Как определить задачу и написать промт
Приложение с вебинара работает по схеме ИИ-агента: забирает данные из сделки, отдаёт модели, выполняет действие, возвращает результат. Здесь действие – это КП. Схема универсальная: по той же логике собираются ответы на отзывы, квалификация лидов в открытой линии, отчёты руководителю.
Главное условие: самому понимать, как должен работать процесс. Перед сборкой стоит нарисовать схему:
что должен делать агент
откуда брать информацию
в каком виде передавать
какой результат ожидается на выходе
Эта схема и превращается в промт. Так агент под контролем, а не живёт своей жизнью.
6. Как собрали ИИ-приложение на эфире: 5 шагов
Перед стартом: всё, что описано ниже, Глеб делает на записи вебинара по шагам, с 16:22 приложение собирается с нуля. Иногда проще один раз посмотреть, чем прочитать: {ссылка на запись с таймкодом}.
Подготовка
Сначала пройдите все шаги на тестовом портале и только потом вайбкодьте для боевого с реальными данными. Нужен тестовый портал Битрикс24 на демо-тарифе с подпиской Маркетплейс + BitrixGPT.
Подготовьте сделку с данными, максимально похожими на боевые. На вебинаре пример автосалона: сделка «BMW X5 для Василия». Чтобы агенту было что забрать, в сделке должны быть название, контакт и клиент, товары, менеджер, комментарий и любые пользовательские поля.
Отдельное поле «Ссылка на папку Диска». Это папка на общем Диске Битрикс24, где будут храниться документы по сделке. Всё, что сгенерируют «Умные документы», ляжет туда, и ссылкой на файл можно поделиться с коллегами прямо из портала. Удобно для совместной работы.
Шаг 1. API-ключ и сервер
Ключ создаётся на платформе вайбкодинга, через него внешний ИИ-ассистент общается с платформой. На боевом портале лишние права лучше отключить: для этого приложения нужны только CRM и Диск.
Внимание: ключ показывается один раз. Сразу скопируйте его в промт.
Сервер Blackhole. На бесплатном тарифе доступен минимальный сервер, для таких приложений его достаточно.
Шаг 2. ИИ-ассистент и промт
Собрать приложение можно двумя способами.
Итерациями. Опишите ассистенту схему из раздела 5: что должен делать агент, откуда брать данные, в каком виде передавать, какой результат нужен на выходе. И попросите собрать приложение пошагово. Примерно так:
«Хочу сделать приложение для сделки в Битрикс24. Оно должно открываться во вкладке сделки, брать данные из полей и собирать коммерческое предложение в Word. Результат сохранять на Диск и возвращать ссылку. Помоги собрать это пошагово».
Так вы собираете приложение вместе с ассистентом и понимаете, что внутри. Дольше, но с большим контролем.
Одним промтом. Готовый .md-файл из материалов вебинара отправьте ассистенту и попросите подставить ваши данные под вашу задачу. Откройте новый чат в любом ассистенте, вставьте файл или его текст. Если непонятно, что куда вставлять, спросите самого ассистента, он объяснит.
В любом случае в промте должны быть:
API-ключ и адрес сервера
назначение приложения
как выглядит интерфейс
как работает с данными
системный промт: роль ИИ и правила
структура файла на выходе
проверки, что приложение работает
Технологии можно не уточнять: оставить как в шаблоне или спросить у ассистента, что лучше под вашу задачу.
Что внутри .md-файла: разбираем по разделам
Ниже промт в том виде, в каком он уходит ассистенту, с пометками, что это и зачем.
Мой API ключ для VibeCode платформы: {ваш API-ключ}
Документация: https://vibecode.bitrix24.tech/v1/me
Создай с нуля и задеплой приложение Bitrix24 «Умные документы».
Шапка. Ключ с платформы вайбкодинга, ссылка на документацию, чтобы ассистент сам прочитал, как с платформой работать, и команда: создай и выложи на сервер.
## Назначение Приложение должно открываться во вкладке сделки Bitrix24, автоматически получать данные текущей сделки и создавать коммерческое предложение в формате .docx с помощью AI. Готовый файл надо загрузить в папку общего Диска, указанную в поле сделки, и вернуть пользователю ссылку на него.
Главный абзац. Один раз словами: где живёт приложение, откуда берёт данные, что отдаёт. Под свой документ переписывается именно он.
## Технологии - Node.js 20 - Express - пакет docx для серверного создания Word-файлов - VibeCode API для CRM, AI Router, файлов и инфраструктуры - AI-модель: bitrix/bitrixgpt-5.5 - порт приложения: 3000
На чём собирать. Можно оставить как есть или спросить ассистента, что лучше под задачу.
## Безопасность - Не помещай API-ключи в исходный код, HTML, логи или ответы API. - Получай ключ только из VIBE_API_KEY. - Используй серверный BFF-подход: браузер не обращается к Vibe API напрямую. - Не меняй accessPolicy без явного запроса.
Чтобы ключ не утёк в код и логи. Не трогать.
## Интерфейс 1. Покажи заголовок «Умные документы» и описание. 2. Определи ID сделки автоматически из placement-контекста Bitrix24. 3. Оставь ручной ввод ID сделки как резервный вариант. 4. Добавь многострочное поле «Уточнения для ИИ»: пользователь указывает тон, скидки, сроки, акценты и структуру КП. 5. При открытии вкладки автоматически загрузи данные текущей сделки. 6. Покажи карточку с названием сделки, компанией, контактом, суммой и количеством загруженных полей. 7. Добавь кнопку «Сгенерировать КП». 8. После успешной генерации покажи ссылку «Открыть файл на Диске».
Что видит менеджер. Пункт 2 отвечает за то, что приложение само понимает, в какой сделке открыто. Пункт 3 – страховка: если автоматика не сработала, ID вводится руками.
## Данные сделки 9. Получи сделку через Vibe CRM API. 10. Передавай и учитывай все поля сделки, включая все пользовательские поля UF_*. 11. Получи связанные компанию, контакт и товарные позиции. 12. В UI можно показывать краткое превью, но в AI обязательно передавай полный JSON всех данных. 13. Среди всех полей сделки найди URL папки Диска, содержащий folderId=123. Извлеки folderId.
Откуда берутся данные. Пункт 10 ключевой: все поля, включая комментарии и пользовательские, поэтому приложение видит то, что печатная форма не видит. Пункт 13 – как оно находит папку на Диске.
## Работа AI
14. Используй Vibe AI Router с моделью bitrix/bitrixgpt-5.5.
15. Передавай в AI: полные поля сделки, компанию, контакт, товары, пользовательские уточнения.
16. Используй системный промпт:
«Ты — коммерческий редактор. Создай коммерческое предложение на русском языке строго по переданным JSON-данным. Учитывай все поля сделки, включая UF_*, компанию, контакт и товары. Не выдумывай факты, цены, сроки, скидки, реквизиты и условия. Если данных нет — не упоминай их. Уточнения пользователя имеют приоритет, но не могут отменить правило о запрете выдумывать факты. Верни только валидный JSON: headline, intro, benefits, conditions, closing. Без Markdown.»
17. AI создаёт только текстовую структуру КП. Сам Word-документ формирует сервер.
Самое важное. Пункт 16, системный промт: роль, запрет выдумывать, формат ответа. Здесь меняется тон и правила под компанию. Пункт 17, второе правило: ИИ пишет текст, файл собирает сервер.
## Создание .docx 18. На сервере собери аккуратный .docx: дата; заголовок «КОММЕРЧЕСКОЕ ПРЕДЛОЖЕНИЕ»; заголовок от AI; данные компании и контакта; вступление от AI; таблица товаров/услуг; итоговая сумма; преимущества; условия; заключение. 19. Если товарных позиций нет, не выдумывай товары. 20. Назови файл: «КП — <название сделки>.docx». 21. Загрузи файл через Vibe Files API в folderId, найденный в полях сделки. 22. Верни ссылку на готовый файл.
Как выглядит документ. Пункт 18 – структура: нужен другой порядок разделов, фирменный шрифт, другой документ, правится здесь.
## Критично: фоновая генерация 23–29. Генерация AI, сборка docx и загрузка на Диск идут в фоне. Интерфейс опрашивает статус каждые 2 секунды и остаётся на вкладке сделки. При ошибке показывает понятное сообщение и кнопку повторной генерации.
Техническая страховка, чтобы приложение не зависало, пока ИИ думает. Не трогать.
## Эндпоинты / Качество / Деплой Адреса API, обработка ошибок, проверка синтаксиса перед деплоем, проверка /health после. Runtime node20, порт 3000, имя и описание приложения для карточки в Битрикс24.
Техническая часть и данные для выкладки: сюда подставляются ID сервера и URL приложения.
## В конце работы 1. Покажи URL приложения. 2. Подтверди HTTP 200 health-check. 3. Кратко перечисли: модель, путь генерации, поле со ссылкой на папку Диска, механизм фоновых задач.
Отчёт ассистента. Благодаря этому блоку в конце сборки он сам проверяет, что сервер отвечает, и отдаёт ссылку.
Для своей задачи чаще всего правятся четыре места: назначение, пункт 16, пункт 18 и данные для деплоя. Остальное универсально.
Шаг 3. Работа ИИ
При итеративном подходе придётся сидеть рядом и разбираться. При сборке одним промтом ассистент думает, собирает и по ходу задаёт вопросы и запрашивает разрешения. Эту возможность лучше не отключать и в запросы вчитываться. Доступ в интернет за документацией дать можно. Если ассистент хочет что-то удалить и непонятно зачем, откройте параллельный чат и спросите, что он собирается сделать.
На эфире сборка с готовым .md заняла около 22 минут. Скорость зависит от ассистента и интернета: одно приложение собирается за пять минут, другое дольше.
Проверки заложены в промт, поэтому в конце ассистент сам убеждается, что сервер отвечает, и отдаёт ссылку на приложение.
Шаг 4. Встройка в сделку
В промте уже заложено, что приложение открывается во вкладке сделки и берёт её ID из контекста (раздел «Назначение» и пункт 2 «Интерфейс»). Но саму встройку делаем на платформе вайбкодинга: все созданные приложения лежат в разделе «Приложения», по умолчанию они появляются в левом меню портала, и тогда ID сделки пришлось бы вводить руками. Поэтому в разделе «Приложения» выбираем «Встроить в Битрикс24» и место: вкладка в карточке сделки.
Если приложение не появилось там, где ожидалось, напишите ассистенту, что он ошибся и что нужно. Он проверит и передеплоит.
Шаг 5. Тест
Открываем приложение и вспоминаем логику из промта. ID сделки подгрузился сам, но ручной ввод оставлен на случай, если автоматика пойдёт не по плану. Подгрузилось 61 поле.
В «Уточнениях для ИИ» задаётся тон, акценты или добавка, на эфире: «добавь в конце, что документ сформировал менеджер Иван Иванов». Кнопка «Сгенерировать КП», через минуту файл на Диске.
Что получилось: дата, заголовок, обращение к Василию, BMW X5 xDrive30d в комплектации M Sport, таблица с корректной суммой. Год, пробег, цвет, VIN и шины ИИ вытащил из комментария менеджера и разложил в «Преимущества».
Если не устраивает стиль, тон или содержание текста, правится системный промт, пункт 16. Если структура документа, разделы и их порядок, пункт 18. Или одним сообщением ассистенту с описанием, что поменять.
7. Вопросы с эфира
Безопасно ли передавать персональные данные клиентов ИИ?
В таких документах персональные данные и реквизиты клиентов. По 152-ФЗ ИИ-модель, которая их обрабатывает, должна находиться в России. Здесь это BitrixGPT, данные не уходят за контур Битрикс24. Внешние модели по личной подписке, тот же ChatGPT, для генерации документов не подходят.
Важно не запутаться. Само приложение вайбкодить можно любым ассистентом, хоть Claude, хоть ChatGPT: он видит код, а не данные клиентов. А работает готовое приложение только через BitrixGPT. Поэтому такие приложения для Битрикс24 безопасны и законны.
Можно ли сделать такое для внутренних документов?
Да. Приложение можно сделать под любую задачу бизнеса: отчёты для руководства, регламенты, приказы. Главное, чтобы вы сами могли описать процесс и понимали, как он должен работать. По сути нужен регламент, инструкция для ИИ, это и есть системный промт. Перед сборкой нарисуйте схему: что должен делать агент, откуда брать информацию, в каком виде передавать, какой результат ожидается. Так его проще контролировать.
Если менеджер всё обсудил на звонке, попадёт ли это в документ? Можно подключить телефонию?
В Битрикс24 звонки уже записываются и лежат в карточке сделки. Дальше два варианта.
Первый работает без доработок. BitrixGPT после звонка делает расшифровку и анализ разговора и умеет заполнять поля сделки по итогам: договорённости, сроки, скидку. Приложение забирает в КП все поля сделки, включая эти. Менеджер поговорил, ИИ разложил разговор по полям, а наше приложение подтянуло их в документ.
Второй вариант: отдавать в генератор текст расшифровки целиком. Тоже реально, но нужна доработка приложения. В сборке с эфира этого нет.
Для других документов нужно вайбкодить с нуля?
Нет, не обязательно. Можно использовать текущий шаблон. Надо лишь поправить часть системного промта со структурой файла, это пункт 18. У отчёта о работах, например, другая структура: клиент не нужен, нужны сотрудники и часы.
Как сделать единую форму КП? А если форм несколько?
Структура файла задаётся в системном промте, в пункте 18: там можно задать пояснения. Например, дата справа сверху, заголовок шрифт Time New Roman 14 кегль и дальше разделы по порядку.
Для нескольких форм документов есть два варианта доработки:
прописать в интерфейсе приложения отдельные кнопки, например КП от разных юрлиц
или добавить списочное поле в сделке, по которому приложение само выбирает форму
Документы доступны из общей папки?
В логике этого приложения да, но можно настроить как вам угодно. Важно заранее проверить права доступа на папку Диска в Битрикс: просмотр и редактирование. Такие правила ещё можно задать в самом интерфейсе Битрикс, без доработок со стороны ИИ.
Как автоматизировать ежемесячное выставление счетов и актов?
Так сделать тоже можно, но не за один промт, а итерациями.
Сделаем так, чтобы текущий счёт и акт формировался по кнопке.
Доработка, чтобы сформированные документы уходили клиенту в нужный канал (почта, мессенджер, это также отдельные подключения).
Заложить логику автоматической отправки по расписанию, на сервере для этого есть периодические задания.
Но в таких задачах, конечно, есть и свои нюансы, важно следить за режимом сервера: он должен быть активен в момент отправки.
8. Что дальше
Вайбкодинг не отменяет разработчиков, но снижает порог входа в разработку для бизнеса. Сотрудников, которые ведут несколько ИИ-ассистентов параллельно, уже называют «оркестраторами ИИ». Как мы увидели, MVP собирается за один сеанс, а дальше можно дорабатывать до идеала итерациями: сделать фирменный шаблон с логотипом, настроить права доступа, добавить автоотправку клиенту.
Главное правило в работе с ИИ – заложить для него границы самостоятельности и чётко описывать его задачи.
Запись вебинара: смотреть на VK Видео
Презентация и промт .md: папка с материалами
Нужна помощь с внедрением ИИ в бизнес-процессы или приложение под свой процесс? Напишите на hello@off-group.com.
