Создаём пользовательскую инструкцию для 1С быстро и без боли

20.03.26

Задачи пользователя - Инструкции пользователю

Если вы когда-нибудь пытались написать инструкцию для пользователей 1С, то знаете – кода много, а понятных слов мало, но есть способ, который превращает рутину в творчество. Секрет прост – выгружаем конфигурацию в файлы, находим модули и формы нужного объекта, переименовываем .bsl в .txt и… отправляем всё это нейросети. Главное – правильно попросить!

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

В текущих реалиях (начало 2026 года), есть проверенный способ – вы можете «скормить» код нейросети и получить на выходе структурированную инструкцию, например, по ГОСТу. Звучит как фантастика? Вовсе нет.

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

Этап 1: Подготовка исходных данных

Первый этап – самый технический, но без него никуда. Мы не можем просто дать нейросети ссылку на базу данных (но это не точно). Ей нужен «исходник» – метаданные.

Этап 2: Навигация по выгруженным файлам (поиск нужного объекта) 

После выгрузки откройте созданную папку. Структура папок в точности повторяет дерево метаданных конфигурации. Вам нужно найти файлы того объекта, на который вы пишете инструкцию. Это ключ к расшифровке технических названий! 

  • Примеры структуры: 
    • Для Документа: Путь: [Каталог выгрузки]\Documents\ИмяДокумента\ 
      • o ИмяДокумента.xml – основной файл метаданных документа. 
      • o Ext\ – папка с модулями (если есть). 
      • o Forms\ФормаДокумента\Ext\Form.xml – структура формы (элементы, реквизиты, команды). 
      • o Forms\ФормаДокумента\Ext\Form\Module.bsl – модуль формы (программная логика кнопок, событий). 
      • Templates\ – папка с макетами (печатные формы). 
    • Для Отчета: Путь: [Каталог выгрузки]\Reports\ИмяОтчета\ 
      • ИмяОтчета.xml – основной файл метаданных. 
      • Templates\ОсновнаяСхемаКомпоновкиДанных\Ext\Template.xml – файл схемы компоновки данных (СКД). 
      • Forms\ФормаОтчета\Ext\Form.xml – структура формы настроек 
    • Для Справочника (важно для понимания ссылок): Путь: [Каталог выгрузки]\Catalogs\ИмяСправочника\ 
      • ИмяСправочника.xml – содержит описание реквизитов и их типов. 

Этап 3: Преобразование и систематизация файлов для нейросети 

Для создания качественной инструкции нейросети нужно дать полную картину.

  • Переименуйте модули – все файлы с расширением .bsl (код 1С) переименуйте в .txt, т.к. это стандартный текстовый формат, который легко читается и обрабатывается нейросетями. 
  • Подготовьте набор файлов для загрузки в новый чат (например, DeepSeek): 
    • Обязательно: 
      • o Файл структуры формы (Form.xml). 
      • o Файл модуля формы (Module.txt, бывший Module.bsl). 
    • o Если есть: 
      • Файл схемы компоновки данных (Template.xml) для отчетов. 
      • Файл основного макета печатной формы (если есть). 
    • Для расширения контекста: 
      • Если в форме или коде встречается ссылка на перечисление (например, Перечисления.СтатусыЗадачи), найдите и загрузите файл этого перечисления: [Каталог выгрузки]\Enums\СтатусыЗадачи.xml. 
      • Если есть ссылка на справочник (например, Справочники.ВидыТребований), загрузите его файл, например, [Каталог выгрузки]\Catalogs\ВидыТребований.xml. Это позволит нейросети понять, что выбирает пользователь из этого поля. 

Этап 4: Взаимодействие с нейросетью 
Теперь, когда все файлы готовы, можно приступать! 

  • Создайте новый чат в выбранной нейросети (DeepSeek, ChatGPT и т.д.). Это важно, чтобы контекст беседы не был зашумлен предыдущими обсуждениями. 
  • Загрузите подготовленные файлы в окно сообщения. Загружайте их все сразу или последовательно, если есть ограничение по объему. 
  • Напишите промт, используя пример как основу: 

Проанализируй загруженные файлы. 
 

Задача 1 (Анализ) – подробно объясни, для чего предназначен этот объект (документ, 
отчет и т.д.), выдели его основные функции и опиши логику работы ключевых 
алгоритмов (например, при нажатии кнопки "Заполнить" или "Провести"). 
Задача 2 (Инструкция) – на основе проведенного анализа и строго в соответствии 
с ГОСТ Р 59795-2021 напиши подробную инструкцию пользователя. 

Важные требования к инструкции: 
• Пользовательский язык – не используй технические имена реквизитов 
(например, "Объект.Контрагент", "ртТепловаяКарта"). Вместо них используй 
понятные представления (например, "поле 'Контрагент'", "документ 'Тепловая 
карта'", "статус 'В работе'"). Черпай эти представления из структуры формы 
(заголовки элементов) и загруженных справочников. 

• Структура по ГОСТ – раздели инструкцию на обязательные разделы: 
• Назначение программы – кратко, для чего этот объект. 
• Условия выполнения (правила эксплуатации): Требования к входным данным, 
какие справочники должны быть заполнены перед началом работы. 
• Выполнение операции (описание функций): Пошаговое описание работы с 
формой: как заполнить поля, нажать кнопки, провести документ, 
сформировать отчет. 
• Сообщения пользователю (возможные ошибки): Опиши типичные ситуации, 
которые могут возникнуть (например, "не заполнено обязательное поле", "нет 
прав на проведение"), и что пользователю делать в таких случаях. 


Создай структурированный, читаемый документ на русском языке. 

P.S. Используйте https://promptessor.com для формирования промтов.

Этап 5: Анализ и доработка (Критически важно!)

Нейросеть – это мощный, но не идеальный инструмент и полученный результат нужно обязательно проверить.

  • Проверьте факты – сверьте шаги, описанные нейросетью, с реальной работой программы в режиме 1С:Предприятие. Все ли кнопки на месте? Правильно ли описан алгоритм заполнения?
  • Переведите имена – убедитесь, что нейросеть правильно заменила все технические имена (ДатаНач, СуммаДок) на понятные пользователю названия (Дата начала, Сумма документа). При необходимости поправьте вручную.
  • Проверьте полноту – не упустила ли нейросеть важную функцию, которая есть на форме, но не описана в модуле? Допишите её.
  • Уточните контекст – если в ответе чего-то не хватает или есть ошибки, загрузите дополнительные файлы (например, общий модуль с вызываемыми функциями) и уточните запрос: «Ты использовал функцию "РассчитатьИтоги" из общего модуля. Вот его код. Перепиши описание этой функции в инструкции более точно.» 

Этап 6: Повторный анализ по итогам корректировки 

  • Закончив редактирование, необходимо сохранить результат в файл. 
  • Загрузите файл в окно сообщения (в тот же самый чат). 
  • Напишите промт, например, такой:

«Проведи детальный файла с акцентом на следующее:

1) выяви и составь таблицу грамматических ошибок, указав номер страницы, фразу и корректный вариант;

2) собери в отдельную таблицу описания неточностей, двусмысленностей и противоречий с указанием страницы и контекста;

3) на основе анализа предложи конкретные рекомендации по унификации структуры документа опиши необходимые изменения и конкретные примеры поправок, чтобы улучшить читаемость и единообразие.

Все таблицы должны иметь четкие заголовки и структурированный формат, а рекомендации быть точными и реализуемы» 

  • Скорректируйте при необходимости результат. 

Итоговый чек-лист: 

  • Конфигурация выгружена в файлы. 
  • Найдены и подготовлены основные файлы объекта (Form.xml, Module.bsl > Module.txt). 
  • Подготовлены файлы контекста (перечисления, справочники, общие модули). 
  • Создан новый чат и загружены файлы. 
  • Отправлен промт с четкими требованиями по ГОСТ и пользовательскому языку (шаг 4). 
  • Ответ нейросети проверен и скорректирован вручную (шаг 5). 
  • Отправлен промт с для анализа результатов корректировки (шаг 6). 
  • Готовая инструкция сохранена в нужном формате (DOCX, PDF). 

В качестве заключения - этот подход позволяет создавать актуальную документацию, а самое главное выполнять ее актуализацию! Достаточно выгрузить новые версии файлов конфигурации, добавить предыдущую версию документации и попросить выполнить актуализацию :)

Вопрос для ответа в комментариях - почему я использую подробное описание операций?

P.S. Что дальше? Дальше агенты, MCP, генерация изображений и максимальная роботизация.

Вступайте в нашу телеграмм-группу Инфостарт

Пользовательская инструкция Промт (запрос) Нейросеть (DeepSeek / ChatGPT) Пользовательский язык

Вы можете заказать платную адаптацию этой статьи под ваши задачи на «Бирже заказов».

  • Поиск от одного разработчика до ИТ-команд под проект.
  • Обмен любыми контактами разрешён.
  • 0% комиссии, допускаются расчёты напрямую.

См. также

Инструкции пользователю 1С:Предприятие 8 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Зарплата и Управление Персоналом 3.x 1С:Управление нашей фирмой 3.0 Бесплатно (free)

Рассказываем об истории создания 1C-Store и о том, какие проблемы пользователей и разработчиков решает каталог. Узнайте, как устроена система конвейера и аудита решений и как такой формат формирует новую экосистему вокруг 1С.

08.10.2025    2479    artbear    4    

12

Инструкции пользователю Бесплатно (free)

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

23.05.2025    4320    Eugeneer    13    

14

Инструментарий разработчика Инструкции пользователю Бесплатно (free)

Макропад — это программируемая мини-клавиатура, позволяющая назначить на его кнопки выполнение каких-то действий: от управления громкостью медиа проигрывателя и до ввода макросов для автоматизации каких-то действий, например, для ввода с клавиатуры шаблонов кода 1С. Все участники конференции INFOSTART TECH EVENT 2024 получили в комплекте участника такое устройство. В этой статье - необходимые файлы и инструкции по настройке.

10.10.2024    12888    kuntashov    59    

15

Инструкции пользователю Пользователь 1С:Предприятие 8 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Зарплата и Управление Персоналом 3.x Россия Абонемент ($m)

Практические советы пользователям по настройке отчетов на СКД. Такие отчеты - как встроенные, так и внешние - используются в современных типовых конфигурациях: УТ 11, КА 2, ERP 2, БП 3.0, ЗУП 3.1 и других.

2 стартмани

11.03.2024    9193    73    accounting_cons    2    

20

Инструкции пользователю СКД Бухгалтер Пользователь 1С:Предприятие 8 1C:Бухгалтерия 1С:Бухгалтерия 3.0 Россия Бесплатно (free)

Простые приемы работы с отчетами на СКД. Что нужно знать пользователю про настройку отчетов, чтобы использовать их на полную катушку, – продолжение.

16.10.2023    41714    accounting_cons    14    

15
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. gybson 6 20.03.26 11:16 Сейчас в теме
Я так понимаю это предположение, которое мы должны проверить и рассказать что получилось?
4. SultanovStas 117 20.03.26 12:56 Сейчас в теме
(1) Нет. Состав операция можно превратить в функциональную модель внутри 1С:СППР.
2. muskul 20.03.26 11:39 Сейчас в теме
звучит интересно. Но что делать когда ожидание нажатие на кнопку не совпадает с результатом
SultanovStas; +1 Ответить
3. SultanovStas 117 20.03.26 12:25 Сейчас в теме
(2) Не понял вопрос. Инструкция собирается по фактическому коду как его понял ИИ.
7. Константин С. 684 22.03.26 14:57 Сейчас в теме
(3)
Инструкция собирается по фактическому коду как его понял ИИ.


вопрос... кому такая инструкция нужна?..
ответ: только другому разработчику. т.к. для пользователи интересна нужна инструкция на бизнес-процесс. Или пояснение что будет "при установленной глачке".
А при текущих вводных ИИ-шка не выдасть такое.
SultanovStas; +1 Ответить
8. SultanovStas 117 22.03.26 15:58 Сейчас в теме
(7) Я специально приложил скриншоты из реальной инструкции, которую собирал, использую текущий подход.
10. Константин С. 684 22.03.26 16:19 Сейчас в теме
(8) типа
"Условия выполнения:
Документ открыт и готов для заполнения:"

ну соглашусь.. для гос.контор которым актуально "по ГОСТу" и формирующих ЧТЗ на работу с типовым банк-клиентом. Такое описание пойдет.
Но реальное применение данной инструкции далеко от жизни.
11. SultanovStas 117 22.03.26 17:30 Сейчас в теме
(10) Подготовьте другой промт, в котором:
- укажите другие характеристики
- можно подгрузить дополнительный контекст в виде существующих инструкций, указав - возьми за основу структуру и глубину наполнения ранее подготовленных материалов.
14. gybson 6 24.03.26 22:20 Сейчас в теме
(11) А если внести еще пару изменений, то получится неплохой рецепт для курицы или забавный рассказ.
9. SultanovStas 117 22.03.26 16:05 Сейчас в теме
(7) ИИ не сможет сделать делально, если у вас:
- нет нормальных комментариев в коде (из также можно ИИ сгенерировать)
- нет пояснений к свойствам метаданных
- нет комментариев в атрибутам.

Ни кто не запрещает выдать чуток контекста ИИ, например, пояснить:
- что это за документа
- какие задачи решает
- кто его использует, когда и при каких условиях..
12. SultanovStas 117 22.03.26 21:05 Сейчас в теме
(7) Разве на скринах инструкция для разработчика?
13. Константин С. 684 22.03.26 21:49 Сейчас в теме
(12) на скринах инструкция для очень подготовленного пользователя. т.ч. учитывая какие данные вы предлагаете скормить ИИ, построить бизнесовую инструкцию мало реально. Вот описание структуры конфы, это да...

ИХМО

ps: вот приложите пример, по оформлению приобретения в БУ, даже не надо деления на счета, просто товар/услуга)

вот посмотрим какая пользовательская инструкция получится.
5. Ne_guru 20.03.26 21:18 Сейчас в теме
Пока что единственная возможность анализа кода модулей без посредства ide, как бы топорно не звучало. Минус в том, что существуют обращения в другие модули, механизмы которых выполняются через 10 других модулей, заранее можно не знать этого и играть в угадайку, где 10 раз придеться пересылать txtшники, и то если заранее это учесть и в правилах указать подобное поведение. Но для кого то единственный возможный вариант, конечно. Как раз пишу внешнюю обработку для чата с иишкой, где нужны api, модель, base url и выгрузка файлов конфигурации. По сути автоматизированная версия того, что автор описал в статье.
6. SultanovStas 117 21.03.26 11:46 Сейчас в теме
(5) Все правильно, поэтому я и написал - "P.S. Что дальше? Дальше агенты, MCP, генерация изображений и максимальная роботизация".


Да, это "вариант на коленке", но этот вариант позволил мне быстро (за 3 дня) собрать руководство пользователя на 250 листов и это без картинок.

Попозже будет более продвинутый вариант, но и этот вариант не каждый сможет осилить.
15. gybson 6 24.03.26 22:32 Сейчас в теме
Главная проблема в том, что уже лет 40 или более как убрали жесткую связку между хранением данных, бизнес-логикой и пользовательским интерфейсом.

А главное сама ситуация, когда у вас конфигурация черный ящик, которым надо пользоваться без инструкций и руководства, то вы её вообще где взяли то? Приснилась?
16. Craig 280 04.04.26 19:10 Сейчас в теме
Тема называется "Создаём пользовательскую инструкцию для 1С быстро и без боли", а главный вопрос "Дальше агенты, MCP, генерация изображений и максимальная роботизация" - не раскрыт. Ждать продолжения?
Для отправки сообщения требуется регистрация/авторизация