«Арете — сервер мессенджеров, Max edition»
Руководство по вайб-кодингу
Пошаговая инструкция по разработке ботов для Max на языке 1С (BSL) с помощью нейросетей и ИИ-агентов: от установки бесплатного клиента Cherry Studio и подключения моделей без VPN до автоматической выгрузки контекста подсистемы из базы 1С.
О подходе: один из множества рабочих вариантов
Конечно же, способов разработки через ИИ много — здесь отражён лишь один из множества практических подходов. Можно писать код в специализированных редакторах со встроенными агентами (например, Cursor, Windsurf или VS Code с плагинами), работать через плагины для EDT или обращаться напрямую к консольным утилитам вроде Claude Code.
Схема, описанная ниже (Cherry Studio + RouterAI + выгрузка контекста из 1С), выбрана потому, что она не требует сложной настройки окружения, обходится без зарубежных карт и VPN, оплачивается строго по факту использования и отлично ложится на архитектуру «Арете — сервер мессенджеров», где вся логика бота сосредоточена в отдельном модуле обработчика.
Шаг 1. Установите Cherry Studio
Cherry Studio — это бесплатное настольное приложение для работы с нейросетями и ИИ-агентами под Windows, macOS и Linux. Оно выступает единым рабочим местом, к которому подключаются любые модели по API-ключам.
Короткая инструкция по установке
- Перейдите на официальный сайт cherryai.com и нажмите кнопку скачивания для вашей операционной системы.
- Запустите скачанный установщик и пройдите стандартные шаги установки.
- Откройте приложение — интерфейс на русском языке подхватится автоматически (или его можно переключить в настройках: иконка шестерёнки внизу слева → «Общие» → «Язык»).
Чем хороша Cherry Studio для разработчика 1С
-
Прямая работа с локальной папкой проекта. В режиме агента («Работа» /
Work) приложение умеет само читать файлы выгруженной подсистемы, изучать справку по методам и сразу записывать готовый код в файл.bsl. - Независимость от одного поставщика. Можно подключить десятки провайдеров и сотни моделей, переключаясь между ними в один клик прямо внутри задачи: например, спроектировать архитектуру дорогой рассуждающей моделью, а мелкие правки доделать быстрой и дешёвой.
- Никакой привязки к абонентской плате. В отличие от сред с фиксированной ежемесячной подпиской в долларах, сама программа бесплатна — вы платите только провайдеру API за реально потраченные токены.
- Локальное хранение истории и промптов. Все переписки, заготовки системных инструкций и базы знаний лежат на вашем компьютере.
Шаг 2. Зарегистрируйтесь на RouterAI
Чтобы Cherry Studio могла обращаться к нейросетям, нужен поставщик API. Зарегистрируйтесь на routerai.ru (RouterAI).
Поставщиков ИИ-моделей на рынке множество (OpenRouter, прямые кабинеты OpenAI, Anthropic, DeepSeek и десятки других шлюзов), но RouterAI удобен тем, что стабильно работает из России без VPN и принимает оплату в рублях российскими картами и по СБП.
Как получить ключ доступа (API Key)
- Создайте аккаунт на routerai.ru и войдите в личный кабинет.
- Пополните баланс на небольшую стартовую сумму (для первых экспериментов и пары небольших ботов обычно хватает нескольких сотен рублей).
-
Перейдите в раздел API-ключи, нажмите кнопку создания нового ключа и
задайте понятное имя (например,
CherryStudio). - Скопируйте сгенерированную строку ключа и временно сохраните её — целиком ключ показывается только в момент создания.
Шаг 3. Выберите модель по способностям и стоимости
Единого фаворита «на все времена» не существует: новые версии выходят почти каждый месяц, а цены на токены отличаются в десятки раз. Перед выбором сверьтесь с независимыми рейтингами на портале artificialanalysis.ai — в частности, со сводной таблицей моделей LLM Leaderboard и специализированным рейтингом агентной разработки Coding Agents Leaderboard.
На какие показатели смотреть в рейтингах
- Индекс интеллекта и кодинга (Intelligence / Coding Index) — способность модели удерживать в голове сложную логику, не терять детали технического задания и работать с несколькими файлами сразу.
- Стоимость (Price / Cost per Task) — сколько обходится решение типовой задачи или миллион входных и выходных токенов. При выгрузке контекста подсистемы входной объём текста заметный, поэтому цена входных токенов и поддержка кэширования промптов напрямую влияют на расход баланса.
-
Размер контекстного окна (Context Window) — для комфортной работы с
выгруженными файлами подсистемы выбирайте модели с окном не менее
128k–200kтокенов (лучше —1M).
Нюанс языка 1С: почему рейтинг — не приговор
Мировые бенчмарки замеряют качество кода в основном на Python, TypeScript, C++ и Go. Далеко не все модели одинаково хорошо справляются с кодом на языке 1С (BSL): одни блестяще знают русскоязычный синтаксис платформы, а другие начинают выдумывать несуществующие методы глобального контекста или путать клиентские и серверные вызовы.
Поэтому подходящую модель лучше подбирать двумя путями:
- Поискать свежий опыт сообщества — задайте запрос «какая ИИ лучше кодит в 1С» в поисковике, профильных Telegram-сообществах 1С или спросите об этом напрямую у самой нейросети с включённым поиском по интернету.
- Проверить опытным путём на своей задаче — дайте двум-трём кандидатам одно и то же небольшое задание по вашему обработчику и посмотрите, чей код запустится в 1С без синтаксических ошибок с первой попытки. Традиционно сильные результаты на 1С показывают старшие модели линейки Claude (Sonnet / Opus), свежие флагманы GPT и топовые версии Gemini и DeepSeek.
Шаг 4. Пропишите провайдера и модель в Cherry Studio
Теперь свяжем Cherry Studio с вашим аккаунтом RouterAI и добавим выбранные модели.
Главная тонкость: к идентификатору модели стоит дописывать суффикс
:online — у RouterAI это включает встроенный плагин веб-поиска,
благодаря чему нейросеть сможет при необходимости сама заглядывать в интернет за свежей
документацией платформы 1С, Max API или примерами кода.
Пошаговая настройка подключения
- В Cherry Studio нажмите на иконку шестерёнки (Настройки) в левом нижнем углу и перейдите в раздел Поставщики моделей (Model Providers).
-
Нажмите кнопку Добавить внизу списка поставщиков: укажите имя
RouterAIи выберите тип API OpenAI (RouterAI полностью совместим со стандартом OpenAI). - В поле API-ключ вставьте ключ, полученный в кабинете RouterAI.
-
В поле Адрес API (API Host / Base URL) укажите базовый адрес провайдера
(проверьте точный URL в разделе «Быстрый старт» личного кабинета RouterAI — обычно
https://routerai.ru/api/v1; если клиент сам дописывает/v1, скорректируйте адрес по подсказке предпросмотра строки запроса под полем). - Ниже нажмите Управление или Добавить, чтобы внести идентификатор нужной модели с каталога RouterAI.
Как правильно добавить модель с суффиксом :online
Скопируйте идентификатор модели со страницы моделей RouterAI и припишите к нему вплотную
:online без пробелов:
anthropic/claude-sonnet-4-5:online openai/gpt-5:online deepseek/deepseek-chat:online
Удобный приём: добавьте одну и ту же модель в список дважды — в обычном виде и с суффиксом
:online. Когда модели нужно найти ответ в интернете или свериться с внешней
справкой, выбирайте вариант :online; когда вся информация уже лежит в вашей
папке разработки и лишние поисковые запросы не нужны, переключайтесь на базовый вариант.
После добавления нажмите кнопку Проверить рядом с полем ключа — зелёная отметка подтвердит, что связь с RouterAI работает.
Шаг 5. Выгрузите АСМ и сопутствующие файлы из 1С
ИИ-агент не видит конфигурацию внутри базы 1С напрямую, зато отлично читает текстовые файлы
выгрузки (.xml, .bsl, .json, .md). Чтобы
вам не приходилось собирать этот контекст вручную, в подсистему встроена пошаговая обработка
подготовки рабочего каталога.
-
Создайте на компьютере пустую папку под разработку вашего бота — например,
C:\Dev\MaxBot. - Откройте 1С:Предприятие в пользовательском режиме, перейдите в раздел подсистемы «Сервер мессенджеров» и откройте пункт меню «Разработка через ИИ» (обработка «Выгрузка для разработки через ИИ-агента»).
- Пройдите шаги помощника слева направо, выгружая данные в выбранную папку.
Что именно выгружает помощник по шагам
- Выбор каталога — укажите созданную локальную папку разработки. Все последующие файлы лягут прямо в неё.
-
Выгрузка расширения — выгружает исходники расширения
АретеСерверМессенджеровв XML-файлы, чтобы нейросеть видела экспортные методы общих модулей (АСМ_Роутинг,АСМ_Шаблонизатори др.) и их точные параметры.
Важно: у вашего пользователя 1С должны быть права на конфигуратор и выгрузку расширения, а сам Конфигуратор в момент нажатия кнопки должен быть закрыт. -
Выгрузка методов — формирует файл
Методы.jsonс полным описанием доступных в базе методов API мессенджера Max и их параметров. -
Выгрузка роутинга — создаёт файл
Роутинг.jsonсо списком всех зарезервированных слов и операторов сравнения, чтобы агент писал маршруты без ошибок в синтаксисе условий. -
Выгрузка шаблонов и состояний (при необходимости) — сохраняет
Шаблоны.jsonиСостояния.json, если вы дорабатываете бота, у которого в базе уже заведены шаблоны сообщений или состояния диалога, либо хотите сразу задать перечень новых. -
Создание обработчика — записывает заготовку модуля вашего бота
(например,
МойБот.bsl) со всеми обязательными экспортными процедурами. -
Оформление комментариев и сводные требования — создаёт файлы
Требования к оформлению комментариев.txtиТребования.md. ВТребования.mdуже собрана готовая системная инструкция для ИИ-агента: какие файлы изучить, куда класть код, как инициализировать шаблоны и как оформлять процедуры-заглушки для объектов вашей основной конфигурации (например, создания документа «Заказ клиента»).
Шаг 6. Укажите каталог разработки в Cherry Studio и поставьте задачу
Осталось направить агента в подготовленную папку, чтобы он работал не как обычный чат «скопируй-вставь», а сам читал контекст подсистемы и правил файл обработчика на диске.
Как подключить рабочую папку
-
В левой боковой панели Cherry Studio откройте раздел Работа
(
Work/ Агенты) — именно этот режим даёт модели инструменты чтения и записи локальных файлов (в отличие от обычного раздела «Чат»). - В верхней панели рабочей области выберите агента (подойдёт встроенный ассистент или созданный вами агент для кода) и укажите подключённую ранее модель из RouterAI.
-
Нажмите на выбор Рабочего каталога (Working Directory / иконка папки) и
укажите каталог, в который вы только что сделали выгрузку из 1С (например,
C:\Dev\MaxBot). В правой панели на вкладке файлов сразу отобразится содержимое папки.
Первый запрос к агенту и перенос кода обратно в 1С
В первом сообщении попросите нейросеть изучить правила проекта и опишите сценарий вашего бота простыми словами:
Внимательно изучи файл Требования.md, справочные файлы Методы.json и Роутинг.json, а также общие модули выгруженной подсистемы АСМ. Реализуй в файле обработчика следующий сценарий бота: 1. По команде /start приветствовать пользователя и выводить клавиатуру с кнопками «Статус заказа» и «Связаться с менеджером». 2. При нажатии «Статус заказа» запрашивать номер заказа, сохраняя ожидание ответа через механизм состояний АСМ, и вызывать процедуру-заглушку ПолучитьСтатусЗаказаВБазе(НомерЗаказа). 3. Все тексты ответов вынести в шаблоны и прописать их в процедуру инициализации обработчика.
-
Дождитесь, пока агент прочитает файлы подсистемы и запишет готовый код в ваш файл
.bsl. -
Скопируйте содержимое обновлённого файла
.bslв модуль объекта вашей внешней обработки в Конфигураторе (или соберите.epf), сохраните обработку и сразу проверьте поведение бота в 1С. - Если при проверке в «Журнале» АСМ появилась ошибка или захотелось поменять логику — просто скопируйте текст ошибки из журнала обратно в диалог Cherry Studio, и агент сам исправит нужный участок кода.
Напоминание на время отладки: пока вы активно правите
маршруты вместе с нейросетью, используйте в процедуре ОбработатьСобытие прямой
вызов Роутер = СобратьРоутер(Бот); вместо кэширующего
АСМ_НастройкиПовтИсп.СобратьРоутер(Бот);, чтобы изменения роутинга подхватывались
мгновенно (перед переводом в продуктив верните вызов через АСМ_НастройкиПовтИсп).