+7 (999) 881-15-11

«Арете — сервер мессенджеров, 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-ключам.

Короткая инструкция по установке
  1. Перейдите на официальный сайт cherryai.com и нажмите кнопку скачивания для вашей операционной системы.
  2. Запустите скачанный установщик и пройдите стандартные шаги установки.
  3. Откройте приложение — интерфейс на русском языке подхватится автоматически (или его можно переключить в настройках: иконка шестерёнки внизу слева → «Общие» → «Язык»).
Чем хороша Cherry Studio для разработчика 1С
  • Прямая работа с локальной папкой проекта. В режиме агента («Работа» / Work) приложение умеет само читать файлы выгруженной подсистемы, изучать справку по методам и сразу записывать готовый код в файл .bsl.
  • Независимость от одного поставщика. Можно подключить десятки провайдеров и сотни моделей, переключаясь между ними в один клик прямо внутри задачи: например, спроектировать архитектуру дорогой рассуждающей моделью, а мелкие правки доделать быстрой и дешёвой.
  • Никакой привязки к абонентской плате. В отличие от сред с фиксированной ежемесячной подпиской в долларах, сама программа бесплатна — вы платите только провайдеру API за реально потраченные токены.
  • Локальное хранение истории и промптов. Все переписки, заготовки системных инструкций и базы знаний лежат на вашем компьютере.

Шаг 2. Зарегистрируйтесь на RouterAI

Чтобы Cherry Studio могла обращаться к нейросетям, нужен поставщик API. Зарегистрируйтесь на routerai.ru (RouterAI).

Поставщиков ИИ-моделей на рынке множество (OpenRouter, прямые кабинеты OpenAI, Anthropic, DeepSeek и десятки других шлюзов), но RouterAI удобен тем, что стабильно работает из России без VPN и принимает оплату в рублях российскими картами и по СБП.

Как получить ключ доступа (API Key)
  1. Создайте аккаунт на routerai.ru и войдите в личный кабинет.
  2. Пополните баланс на небольшую стартовую сумму (для первых экспериментов и пары небольших ботов обычно хватает нескольких сотен рублей).
  3. Перейдите в раздел API-ключи, нажмите кнопку создания нового ключа и задайте понятное имя (например, CherryStudio).
  4. Скопируйте сгенерированную строку ключа и временно сохраните её — целиком ключ показывается только в момент создания.

Шаг 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 или примерами кода.

Пошаговая настройка подключения
  1. В Cherry Studio нажмите на иконку шестерёнки (Настройки) в левом нижнем углу и перейдите в раздел Поставщики моделей (Model Providers).
  2. Нажмите кнопку Добавить внизу списка поставщиков: укажите имя RouterAI и выберите тип API OpenAI (RouterAI полностью совместим со стандартом OpenAI).
  3. В поле API-ключ вставьте ключ, полученный в кабинете RouterAI.
  4. В поле Адрес API (API Host / Base URL) укажите базовый адрес провайдера (проверьте точный URL в разделе «Быстрый старт» личного кабинета RouterAI — обычно https://routerai.ru/api/v1; если клиент сам дописывает /v1, скорректируйте адрес по подсказке предпросмотра строки запроса под полем).
  5. Ниже нажмите Управление или Добавить, чтобы внести идентификатор нужной модели с каталога 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). Чтобы вам не приходилось собирать этот контекст вручную, в подсистему встроена пошаговая обработка подготовки рабочего каталога.

  1. Создайте на компьютере пустую папку под разработку вашего бота — например, C:\Dev\MaxBot.
  2. Откройте 1С:Предприятие в пользовательском режиме, перейдите в раздел подсистемы «Сервер мессенджеров» и откройте пункт меню «Разработка через ИИ» (обработка «Выгрузка для разработки через ИИ-агента»).
  3. Пройдите шаги помощника слева направо, выгружая данные в выбранную папку.
Что именно выгружает помощник по шагам
  1. Выбор каталога — укажите созданную локальную папку разработки. Все последующие файлы лягут прямо в неё.
  2. Выгрузка расширения — выгружает исходники расширения АретеСерверМессенджеров в XML-файлы, чтобы нейросеть видела экспортные методы общих модулей (АСМ_Роутинг, АСМ_Шаблонизатор и др.) и их точные параметры.
    Важно: у вашего пользователя 1С должны быть права на конфигуратор и выгрузку расширения, а сам Конфигуратор в момент нажатия кнопки должен быть закрыт.
  3. Выгрузка методов — формирует файл Методы.json с полным описанием доступных в базе методов API мессенджера Max и их параметров.
  4. Выгрузка роутинга — создаёт файл Роутинг.json со списком всех зарезервированных слов и операторов сравнения, чтобы агент писал маршруты без ошибок в синтаксисе условий.
  5. Выгрузка шаблонов и состояний (при необходимости) — сохраняет Шаблоны.json и Состояния.json, если вы дорабатываете бота, у которого в базе уже заведены шаблоны сообщений или состояния диалога, либо хотите сразу задать перечень новых.
  6. Создание обработчика — записывает заготовку модуля вашего бота (например, МойБот.bsl) со всеми обязательными экспортными процедурами.
  7. Оформление комментариев и сводные требования — создаёт файлы Требования к оформлению комментариев.txt и Требования.md. В Требования.md уже собрана готовая системная инструкция для ИИ-агента: какие файлы изучить, куда класть код, как инициализировать шаблоны и как оформлять процедуры-заглушки для объектов вашей основной конфигурации (например, создания документа «Заказ клиента»).

Шаг 6. Укажите каталог разработки в Cherry Studio и поставьте задачу

Осталось направить агента в подготовленную папку, чтобы он работал не как обычный чат «скопируй-вставь», а сам читал контекст подсистемы и правил файл обработчика на диске.

Как подключить рабочую папку
  1. В левой боковой панели Cherry Studio откройте раздел Работа (Work / Агенты) — именно этот режим даёт модели инструменты чтения и записи локальных файлов (в отличие от обычного раздела «Чат»).
  2. В верхней панели рабочей области выберите агента (подойдёт встроенный ассистент или созданный вами агент для кода) и укажите подключённую ранее модель из RouterAI.
  3. Нажмите на выбор Рабочего каталога (Working Directory / иконка папки) и укажите каталог, в который вы только что сделали выгрузку из 1С (например, C:\Dev\MaxBot). В правой панели на вкладке файлов сразу отобразится содержимое папки.
Первый запрос к агенту и перенос кода обратно в 1С

В первом сообщении попросите нейросеть изучить правила проекта и опишите сценарий вашего бота простыми словами:

Пример стартового задания для ИИ
Внимательно изучи файл Требования.md, справочные файлы Методы.json и Роутинг.json, а также общие модули выгруженной подсистемы АСМ.

Реализуй в файле обработчика следующий сценарий бота:
1. По команде /start приветствовать пользователя и выводить клавиатуру с кнопками «Статус заказа» и «Связаться с менеджером».
2. При нажатии «Статус заказа» запрашивать номер заказа, сохраняя ожидание ответа через механизм состояний АСМ, и вызывать процедуру-заглушку ПолучитьСтатусЗаказаВБазе(НомерЗаказа).
3. Все тексты ответов вынести в шаблоны и прописать их в процедуру инициализации обработчика.
  1. Дождитесь, пока агент прочитает файлы подсистемы и запишет готовый код в ваш файл .bsl.
  2. Скопируйте содержимое обновлённого файла .bsl в модуль объекта вашей внешней обработки в Конфигураторе (или соберите .epf), сохраните обработку и сразу проверьте поведение бота в 1С.
  3. Если при проверке в «Журнале» АСМ появилась ошибка или захотелось поменять логику — просто скопируйте текст ошибки из журнала обратно в диалог Cherry Studio, и агент сам исправит нужный участок кода.

Напоминание на время отладки: пока вы активно правите маршруты вместе с нейросетью, используйте в процедуре ОбработатьСобытие прямой вызов Роутер = СобратьРоутер(Бот); вместо кэширующего АСМ_НастройкиПовтИсп.СобратьРоутер(Бот);, чтобы изменения роутинга подхватывались мгновенно (перед переводом в продуктив верните вызов через АСМ_НастройкиПовтИсп).


Другие руководства