АС Проект АС ПроектПлатиновый партнёр Битрикс24
+7 (495) 414-48-49
Искусственный интеллект

Приёмы вайбкодинга в Битрикс24: задачи ИИ-агенту и отладка

Опубликовано: · Обновлено: ·12 мин чтения

Рабочее приложение в Битрикс24 Вайбкод получается не потому, что ИИ «умный», а потому что ему правильно поставили задачу, включили нужный скилл и объясняют ошибки как пользователь - скриншотом и фактом, а не правкой кода вручную.

Почему вайбкод - это про постановку задачи, а не про код

Битрикс24 Вайбкод - не просто «ещё один ИИ-агент». Это инфраструктура вокруг агента: автоматический деплой, API портала, ИИ-модели, серверы и боты - всё в одном месте с готовыми инструкциями. Агент сам заводит сервер, заливает файлы, проверяет запуск и читает логи - бизнес-заказчик в это не погружается.

Именно поэтому автоматизации здесь создают не программисты, а эксперты-предметники: маркетологи, аналитики, партнёры-интеграторы. Роль смещается с «технаря» на постановщика задачи и контролёра результата.

По нашему опыту сборки приложений на платформе Вайбкод каждое такое приложение собирается от идеи до рабочего результата примерно за 15-20 минут. Пара характерных примеров из нашей практики:

  • Пример 1 (агент Codex): чат-бот подготовки к звонку - собирает данные о клиенте из CRM и делает краткое резюме.
  • Пример 2 (Claude + BitrixGPT 5.5): приложение для создания краткого изложения документов, встроенное в левое меню портала - загружаешь PDF или DOC, получаешь выжимку; правки вносятся простым текстом в чате с агентом.

Подробнее о том, что такое Битрикс24 Вайбкод и как платформа работает, читайте в отдельной статье.

Поток данных приложения на Вайбкоде: запрос пользователя идёт через платформу Вайбкода, конвертируется в REST-вызов на портале Битрикс24 и возвращается обратно в приложение.

flowchart TD
    USER[Пользователь] --> APP[Приложение на Вайбкоде]
    APP --> PLATFORM[Платформа Вайбкода]
    PLATFORM -->|конвертация в REST| B24[Портал Битрикс24]
    B24 -->|ответ| PLATFORM
    PLATFORM --> APP
    APP --> USER

Приём 1: ставь задачу как Team Lead

Самая частая причина, по которой агент «уходит в сторону» или выдаёт нерабочий результат, - плохое техническое задание. Агент не угадывает намерения. Он следует тому, что написано.

Хорошая задача для агента - это мини-ТЗ. Если вы когда-либо ставили задачу разработчику, структура будет знакома. Если нет - смотрите на пример ниже.

Что писать в задаче агенту

Элемент Зачем Пример
Контекст Агент понимает область «Приложение встраивается в левое меню портала Битрикс24»
Цель Что должно получиться «Менеджер загружает PDF договора и получает краткое изложение на русском»
Границы Что делать НЕ нужно «Не трогай авторизацию, не меняй структуру БД»
Пример результата Снижает разброс трактовок «Итог - блок текста до 5 абзацев, без Markdown, в BB-кодах Битрикс24»
Критерий приёмки Когда задача считается выполненной «Кнопка активна, файл загружается, выжимка появляется за 10 секунд»

Плохое ТЗ → галлюцинации. Агент заполняет пробелы в условии собственными предположениями - и уходит в сторону от вашего замысла.

Полезно сначала проговорить задачу «в свободной форме», а затем попросить агента переформулировать её в ТЗ и согласовать с вами. Это сокращает количество итераций.

Сначала план во вкладке «Коворк», потом код

В приложении Коворк/Код разработчики показывают этот приём так (митап 13.10.2026). Напишите описание приложения сами и отдайте его агенту во вкладке «Коворк» со словами «вот цель и ценность решения, вот мой план, покритикуй и скажи, что не учтено, но не раздувай его в приложение, которое делает всё». Агент хорошо подсказывает то, что новичок пропускает: административную часть, авторизацию, фильтры. Его замечания отбирайте сами, иначе приложение разрастётся. Только после этого отдавайте задачу во вкладку «Код».

Большое приложение делите на этапы

Один огромный промпт с проверкой в самом конце опасен: ошибка на раннем этапе тянется через всё приложение, и иногда дешевле написать его заново, чем исправлять. Порядок, который работает:

  1. Общий промпт: какое это приложение и какую бизнес-задачу решает.
  2. «А теперь сделаем этап 1» и описание того, что в него входит.
  3. Проверка и правки.
  4. «Теперь этап 2», и так далее.

Агент собирает всё в одно приложение под одним ключом и с единой авторизацией. Работа по этапам помещается в контекст, расход вайбов виден заранее, а проверять приходится небольшие куски. Делайте это в одной папке проекта: одна папка - одно приложение, второе приложение в ту же папку не кладите.

30 минут работы агента над приложением - нормально, а серьёзные приложения дорабатываются днями и неделями. Если что-то работает медленно, попросите агента разобраться, почему, и ускорить: на митапе так починили медленную загрузку воронок на большом портале.

Если вы раньше писали технические задания на доработку Битрикс24, тот же навык работает здесь - только адресат не человек-разработчик, а ИИ-агент.


Приём 2: включи скилл Superpowers

Superpowers - скилл, который рекомендуется устанавливать в каждый проект Вайбкод по умолчанию. Он заметно повышает шанс получить рабочий результат с первого-второго захода.

Внутри скилла два ключевых модуля:

  • Test-driven development - агент сначала пишет тесты, потом реализацию. Меньше «работающего на словах, но битого на деле» кода.
  • Системный дебаг - набор инструкций по диагностике ошибок: агент знает, где смотреть логи, как воспроизвести проблему, прежде чем менять код.

Наш опыт это подтверждает: без Superpowers агент чаще делает «красивые», но нерабочие вещи. С ним - разбирается в ошибке системно.

Как устроены скиллы

Скилл - это устанавливаемый набор дополнительных инструкций для агента. По сути, готовые алгоритмы под повторяющиеся действия, которые экономят токены - агенту не нужно каждый раз «изобретать» подход.

  • Скиллы ставятся по ссылке прямо в чате: «установи скилл, вот ссылка».
  • Скиллы можно писать свои - для специфики вашей отрасли или стека.
  • Скилл Superpowers рекомендован командой Битрикс24 как базовый - ставьте его в каждый новый проект.

Для добавления ИИ-моделей в проект достаточно нажать кнопку «Добавить в проект» в разделе AI-моделей - она вставляет в диалог готовый промпт с ключом и документацией модели.


Приём 3: отлаживай как пользователь, а не как программист

Самая распространённая ошибка начинающих вайбкодеров - лезть в код руками, когда что-то не работает. Этого делать не нужно и даже вредно: агент теряет контекст, а вы теряете время.

Правильный алгоритм отладки:

  1. Открываете приложение как обычный пользователь.
  2. Видите проблему - делаете скриншот.
  3. Описываете агенту факт: «вот что вижу на экране» + «вот что должно быть».
  4. Агент сам находит причину, читает логи, правит код.

Именно так мы отлаживаем на практике: агент сам читает логи сервера Blackhole, находит ошибку и исправляет её - без участия человека в коде.

Реальные косяки из демо - и как их чинили

Все три проблемы ниже мы решали прямо в чате с агентом - только текстом, без правки кода вручную:

Проблема Что произошло Как исправили
Бот переименовал сам себя Агент решил «улучшить» имя бота по своему усмотрению Явно указали в ТЗ: «имя бота не менять»
Галлюцинация «клиент не найден» Агент возвращал ошибку, хотя клиент в CRM был Дали скриншот + описание факта; агент исправил логику запроса к CRM
Markdown вместо BB-кодов Агент выдавал форматирование в стиле **жирный**, которое Битрикс24 не рендерит В задаче явно прописали: «вывод в BB-кодах Битрикс24, без Markdown»

Ключевой принцип: агент ошибается - это нормально. Ненормально - пытаться починить это вручную. Ваша задача: описать проблему точно и дать агенту инструмент для диагностики.


Ключи, модели и серверы: минимум для старта

Для тех, кто только начинает, - краткий ориентир по компонентам. Подробный разбор - в отдельных статьях.

Два типа ключей:

  • API-ключ (технически - вебхук): для однопортальных решений «для себя» - боты, дашборды, анализ звонков. Быстрый старт.
  • Ключ авторизации (OAuth): для встроек в интерфейс Битрикс24 (левое меню, слайдеры) и многопользовательских приложений.

Права доступа ключа - выбирайте только необходимые. Агент с избыточными правами может «настучать лишнего» в портал.

Модели:

  • BitrixGPT 5.5 - универсальная встроенная модель, мультимодальная: распознаёт файлы и изображения, работает с длинным контекстом. При платном тарифе Битрикс24 и подписке - бесплатно в пределах технических лимитов.
  • Агентов вайбкодят также через Claude и Codex. Рекомендация из практики: не менять модель в процессе работы над проектом, новые задачи стартовать отдельными сессиями.

Серверы Blackhole:

  • Агент сам заводит сервер, заливает файлы, проверяет запуск, читает логи.
  • Авто-сон примерно через час без обращений - в простое не платите.
  • Снаружи открыт только порт 3000.
  • На одном сервере можно разместить несколько приложений одного портала.
  • Стоимость конфигураций: ~300-4000 ₽/мес.

Подробнее о серверах - в статье про Black Hole-серверы и Галактики Битрикс24.

Экономика в двух словах: токены агента (~2000 ₽/мес у маркетолога, 10-20 тыс. ₽ у активного разработчика) + Blackhole (~300-4000 ₽/мес). Встроенные модели и API при платном тарифе Битрикс24 + Подписке - в основном бесплатны. По нашему опыту, это дешевле, чем нанимать разработчика на те же задачи. Полный разбор тарифов - в статье сколько стоит Битрикс24 Вайбкод.


Честные ограничения платформы

Вайбкод - молодая и быстро развивающаяся платформа. Несколько вещей, о которых важно знать заранее:

  • API Вайбкода - обёртка над REST. Покрыты ключевые методы Битрикс24, но не все. Для нестандартных сценариев иногда быстрее использовать прямой REST: в одном из кейсов прямой вызов дал ускорение в ~10 раз по сравнению с работой через промежуточный слой платформы.
  • UIKit и Tailwind в инструкции платформы пока не встроены - если нужны, объясняйте агенту самостоятельно в ТЗ.
  • Деплой на свой сервер возможен, но тогда нужно объяснять агенту всё: SSH-доступ, публичный домен, SSL, фронтенд-веб-сервер. Blackhole придуман именно чтобы этого избегать.
  • Галлюцинации не исчезают, а меняют форму. Скилл Superpowers и чёткое ТЗ снижают их частоту, но не до нуля.

Отдельная тема - безопасность: что агент может сделать с вашим порталом и как это контролировать. Разбор - в статье безопасность вайбкодинга в Битрикс24.


Что дальше: планы Битрикс24 и мягкий CTA

Платформа активно развивается. На подходе:

  • Упрощённый мастер создания приложений.
  • Каталог вайбкод-приложений внутри Битрикс24.
  • Обёртки UIKit/Tailwind в инструкции платформы.
  • Отдельные вебинары по Коворк и маркетингу.

Если вы хотите посмотреть, что реально можно собрать с помощью Вайбкод уже сейчас, - загляните в статью что можно собрать на Битрикс24 Вайбкод.

АС Проект - платиновый партнёр Битрикс24 - помогает партнёрам и компаниям освоить вайбкодинг: от первого приложения до тиражных решений. Если нужна помощь с постановкой задачи, выбором архитектуры или разбором конкретного кейса - обращайтесь.


Диагностика деплоя: приёмы из практики (июль 2026)

Из разбора типовых проблем периода:

  • Большие приложения деплойте через source.url, а не source.content. Из-за регрессии лимита тела запроса (Gateway 413) фактический потолок inline-архива - ~780 КБ; передача по ссылке обходит проблемный участок, размер не важен.
  • Не перезапускайте зависший деплой. После обрыва туннеля исходный build продолжает идти на VM; повторный запуск даёт EXEC_BUSY (одна операция на сервер за раз).
  • Тяжёлые отчёты в ботах - в фон. Долгий CRM-запрос внутри обработчика /v1/bots/{id}/events (long-polling) блокирует очередь → 504 Portal queue saturated. Правильно: быстро принять сообщение, поставить задачу в фон, ответить «отчёт готовится», кэшировать неизменяемые периоды.

Нужна помощь по вайбкод-приложению? АС Проект - платиновый партнёр Битрикс24: собираем приложения на Вайбкоде, проверяем чужие перед боевым запуском и берём на сопровождение. Состав работ и цены - на странице приложения на вайбкодинге.

Что изменилось к концу августа 2026

  • BitrixGPT 5.6 Agent 1M. Контекст вырос до 1 млн токенов (порядка тысячи страниц за один запрос), новые агенты создаются на этой модели по умолчанию, а долгие ответы почти исчезли.
  • Тарифы Коворк/Кода. Подписка персональная, на сотрудника: Free (5% от объёма Pro), Pro - 2 000 Ꝟ в месяц, Max - 10 000 Ꝟ (впятеро больше Pro), Ultra - 20 000 Ꝟ (вдесятеро больше Pro). AI-квота портала при этом даётся на компанию и зависит от тарифа Битрикс24.
  • Ключ подписки в сторонних клиентах. Модели платформы стали доступны из внешних агентных клиентов (OpenCode, Crush, Cline, Aider) по ключу подписки Коворк/Кода. Ключ по умолчанию несёт все права портала, лишнее снимается кнопкой «Снять все».
  • Выгодные часы. Квота расходуется вдвое медленнее в будни с 23:00 до 04:00 и в выходные с 17:00 до 07:00 по Москве; полная цена остаётся только в будни с 09:00 до 17:00. Текущий множитель и время ближайшего дешёвого окна отдаёт метод /v1/off-peak.

Что изменилось к октябрю 2026

  • Ключ и деплой автоматически. В приложении Коворк/Код ключ и выкладка на сервер больше не требуют захода на платформу Вайбкод: приложение получает ключ само, ссылка появляется в блоке деплоя. Кнопку «Деплой» нажимают вручную только после долгой доработки, когда система сама предлагает передеплоить, или если автоматический деплой не прошёл.
  • Одна папка - одно приложение. Всё, что будет дорабатываться, делают в папке проекта: внутри неё сколько угодно сеансов под одним ключом, зависший сеанс просто заменяют новым. Сеанс без папки годится только для пробы, после обрыва связи его не продолжить.
  • Проверка безопасности по умолчанию. Последний пункт плана разработки - скилл проверки безопасности. Полную проверку с исправлениями можно запустить отдельно: «/» и первые буквы «security» в поле ввода.
  • Приложения в мессенджере. Опубликованные приложения сотрудники находят в папке «Вайбкод» мессенджера Битрикс24 (обновление выдают постепенно с 12.10.2026) или через иконку каталога. Поделиться можно через «три точки» с сотрудником или отделом, у каждого приложения есть свой чат для новостей и обратной связи.

Данные на 13 октября 2026 - платформа Вайбкод в активной бете, цифры (квоты, цены, версии) меняются. Сверяйтесь с документацией Вайбкода.

Частые вопросы

Нет. Вайбкод рассчитан на экспертов-предметников: маркетологов, аналитиков, партнёров-интеграторов. Роль создателя приложения - правильно поставить задачу и оценить результат, а не писать код.

Superpowers - must-have скилл для разработки в Вайбкоде. Внутри - test-driven development и модуль системного дебага, которые заметно повышают шанс получить рабочий результат. Ставится командой в чате агента по ссылке; запускается через /brainstorm.

Сделайте скриншот того, что видите на экране, и опишите факт: «вижу X, должно быть Y». Не правьте код вручную - агент сам диагностирует проблему по логам и исправляет её.

API-ключ (вебхук) подходит для однопортальных решений «для себя»: боты, дашборды, анализ звонков. Ключ авторизации (OAuth) нужен для встроек в интерфейс Битрикс24 и многопользовательских приложений.

Нет. Серверы Blackhole засыпают примерно через час без обращений, и в режиме простоя вы за них не платите. Это удобно для внутренних автоматизаций, которые нужны «по запросу».

Да. API Вайбкод - обёртка над REST, покрыты не все методы Битрикс24. UIKit и Tailwind пока не встроены в инструкцию платформы. В нестандартных сценариях прямой REST может работать быстрее.

У вас остались вопросы?

Оставьте заявку - мы свяжемся с вами и проконсультируем.

Читайте также

Искусственный интеллект
RAG-ассистент по звонкам на Битрикс24 Вайбкод
Искусственный интеллект
RAG простыми словами: как ИИ отвечает по вашим документам
Искусственный интеллект
RAG и векторный поиск на Битрикс24 Вайбкод: embeddings
Искусственный интеллект
Разбор звонков на Битрикс24 Вайбкод: как собрать своё приложение
×

Оставьте заявку

Эксперт АС Проект свяжется в течение 60 минут.