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

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

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

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

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

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

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

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

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

---

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

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

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

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

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

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

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

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

---

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

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

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

• 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 VibeCode.

---

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

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

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

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

---

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

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

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

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

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