ИИ помощник обновления процедур/функций расширений

Назначение обработки

Обработка «Обновление процедур расширения» предназначена для автоматизации двух типовых задач разработчика расширений конфигураций 1С:

• обновление существующей процедуры расширения при выходе нового релиза типовой конфигурации;
• создание процедуры для расширения по измененной и оригинальной версиям кода.

Обработка отправляет тексты процедур в выбранную нейросеть и получает готовый результат для дальнейшего переноса в расширение. После получения результата автоматически формируется таблица построчного сравнения всех трёх текстов.

Требования

• Платформа: 1С:Предприятие 8.3.23 и выше.
• Доступ к интернету для обращения к API провайдера.
• API-ключ одного из поддерживаемых провайдеров.

Запуск обработки

1. Откройте 1С:Предприятие в режиме «Предприятие».
2. Выберите Файл → Открыть или нажмите Ctrl+O.
3. Укажите файл ОбновлениеПроцедурРасширения.epf.
4. После открытия появится основная форма обработки.

Элементы формы

Форма обработки состоит из двух вкладок: «Процедуры» (основная работа) и «Сравнение» (таблица diff-сравнения).

Вкладка «Процедуры»

Вкладка «Сравнение»

Настройка провайдера

OpenRouter

1. Зарегистрируйтесь на сайте openrouter.ai.
2. Создайте API-ключ в личном кабинете.
3. В обработке выберите провайдер OpenRouter.
4. Вставьте ключ в поле API-ключа.
5. Выберите модель. Рекомендуемый вариант: anthropic/claude-sonnet-4.

Доступные модели по умолчанию: anthropic/claude-sonnet-4, openai/gpt-4o, google/gemini-2.5-flash-lite. Можно ввести любой идентификатор модели вручную.

GigaChat

1. Зарегистрируйтесь на developers.sber.ru.
2. Создайте проект и получите Authorization Key для GigaChat API.
3. В обработке выберите провайдер GigaChat.
4. Вставьте ключ в поле Ключ авторизации GigaChat.
5. Выберите модель. Рекомендуемый вариант: GigaChat-Pro.

Доступные модели: GigaChat-Pro, GigaChat, GigaChat-Max.

YandexGPT

1. Зарегистрируйтесь в Yandex Cloud.
2. Создайте каталог и получите его folder-id.
3. Создайте API-ключ сервисного аккаунта.
4. В обработке выберите провайдер YandexGPT.
5. Укажите API-ключ и folder-id.
6. Выберите модель. Рекомендуемый вариант: yandexgpt/latest.

Доступные модели: yandexgpt/latest, yandexgpt-lite/latest.

Режим 1: Обновление процедуры расширения

Когда использовать: если у вас уже есть процедура расширения, и нужно перенести её доработки в новую типовую версию процедуры.

1. Выберите режим «Обновление процедуры».
2. В левое поле вставьте текст текущей процедуры расширения со всеми аннотациями и вставками (или нажмите «Заполнить» для загрузки из файла).
3. В среднее поле вставьте текст новой типовой процедуры из обновленной конфигурации (или загрузите из файла).
4. При необходимости добавьте пояснения в поле Чат.
5. Нажмите «Выполнить запрос».
6. Проверьте результат в правом поле и перенесите его в модуль расширения.
7. Перейдите на вкладку «Сравнение» для построчного сопоставления всех трёх текстов.

В этом режиме нейросеть:

• берет новую типовую процедуру как основу;
• находит кастомные вставки и удаления из текущего расширения;
• переносит их в актуальную версию процедуры;
• сохраняет аннотации расширения.

Пример

Текущая процедура расширения:

&ИзменениеИКонтроль("НекаяПроцедура")
Процедура ск_НекаяПроцедура(Параметр1)

    ТиповаяПеременная = 1;

    #Удаление
    ВызовУдалённогоКода();
    #КонецУдаления

    #Вставка
    ДополнительнаяПеременная = 2;
    #КонецВставки

    Возврат ТиповаяПеременная;

КонецПроцедуры

Новая типовая процедура:

Процедура НекаяПроцедура(Параметр1)

    ТиповаяПеременная = 1;

    ВызовУдалённогоКода();

    ТиповаяПеременная = 4;

    Возврат ТиповаяПеременная;

КонецПроцедуры

Режим 2: Создание процедуры для расширения

Когда использовать: если нужно перенести доработанную процедуру из основной конфигурации в расширение с корректной разметкой изменений.

1. Выберите режим «Создание процедуры для Расширения».
2. В левое поле вставьте изменённую процедуру из основной конфигурации (или нажмите «Заполнить»).
3. В среднее поле вставьте оригинальную процедуру поставщика (или загрузите из файла).
4. При необходимости добавьте уточнения в поле Чат.
5. Нажмите «Выполнить запрос».
6. Проверьте итоговую процедуру и перенесите её в расширение.
7. Перейдите на вкладку «Сравнение» для визуальной проверки.

В этом режиме нейросеть:

• сравнивает изменённую и оригинальную процедуры;
• добавляет аннотацию &ИзменениеИКонтроль;
• переименовывает процедуру с префиксом ск_;
• обрамляет добавленный код блоками #Вставка / #КонецВставки;
• обрамляет удалённый код блоками #Удаление / #КонецУдаления;
• переносит все комментарии из изменённой процедуры.

Пример

Изменённая процедура:

Процедура НекаяПроцедура(Параметр1)

    ТиповаяПеременная = 1;

    ДополнительнаяПеременная = 2;

    Возврат ТиповаяПеременная;

КонецПроцедуры

Оригинальная процедура поставщика:

Процедура НекаяПроцедура(Параметр1)

    ТиповаяПеременная = 1;

    ВызовУдалённогоКода();

    Возврат ТиповаяПеременная;

КонецПроцедуры

Результат:

&ИзменениеИКонтроль("НекаяПроцедура")
Процедура ск_НекаяПроцедура(Параметр1)

    ТиповаяПеременная = 1;

    #Вставка
    ДополнительнаяПеременная = 2;
    #КонецВставки

    #Удаление
    ВызовУдалённогоКода();
    #КонецУдаления

    Возврат ТиповаяПеременная;

КонецПроцедуры

Таблица сравнения (Diff-view)

После успешного выполнения запроса обработка автоматически формирует построчную таблицу сравнения трёх текстов. Таблица расположена на второй вкладке «Сравнение».

Структура таблицы

Алгоритм выравнивания

Обработка использует алгоритм LCS (Longest Common Subsequence) для попарного сравнения текстов. Одинаковые строки выравниваются на одном уровне, что позволяет визуально увидеть, какие строки добавлены, удалены или изменены.

Условное оформление

• Аннотации расширения (#Вставка, #КонецВставки, #Удаление, #КонецУдаления) — выделяются цветом #993366 во всех трёх колонках.
• Строки с различиями — если строка присутствует только в одной колонке (другие две пусты), фон строки окрашивается серебряным цветом, что позволяет быстро найти отличия.

Дополнительные инструкции (Чат)

Поле «Чат» используется для передачи дополнительного контекста модели. Например:

• Переменная СтараяПеременная была переименована в НоваяПеременная.
• Сохрани комментарии из текущей процедуры.
• Не переноси блок с временной отладочной логикой.
• Размести вставку после инициализации переменной Результат.

Статистика токенов и стоимость

После успешного выполнения запроса под кнопкой «Выполнить запрос» отображается строка статистики:

• Токены входных — количество токенов, потраченных на отправку запроса (prompt).
• Токены выходных — количество токенов, потраченных на генерацию ответа (completion).
• Всего — суммарное количество токенов.
• Стоимость — стоимость запроса в долларах США (отображается, если провайдер возвращает данные о стоимости; доступно для OpenRouter).

Эта информация помогает контролировать расходы и оценивать сложность обработки.

Сохранение настроек

После успешного выполнения запроса обработка сохраняет:

• выбранного провайдера;
• API-ключи для каждого провайдера отдельно;
• текущую модель;
• folder-id для YandexGPT;
• значение Max tokens.

При следующем открытии обработки эти настройки восстанавливаются автоматически. API-ключи хранятся в ХранилищеОбщихНастроек, что означает их привязку к конкретному пользователю информационной базы.

Рекомендации

1. Всегда проверяйте результат вручную перед переносом в расширение. Используйте вкладку «Сравнение» для быстрой визуальной проверки.
2. Для сложных процедур используйте более сильные модели (например, GigaChat-Max или anthropic/claude-sonnet-4).
3. Если процедура очень большая, увеличьте значение Max tokens, чтобы избежать обрезки ответа.
4. Используйте кнопки «Заполнить» для загрузки текста из файлов — это удобнее, чем копировать большие процедуры через буфер обмена.
5. Используйте поле Чат, если в новой версии изменились названия переменных, структура процедуры или порядок вызовов.
6. Если ответ модели вас не устраивает, повторите запрос с другой моделью или более точными дополнительными инструкциями.
7. Не передавайте файл обработки с сохранёнными ключами третьим лицам.