Как ИИ-агент писал обработку для 1С:ERP: 7 ошибок за один вечер
Зачем всё это
Проходил курс по подсистеме планирования в 1С:ERP 2.5. Методически всё правильно: сценарии планирования, виды планов, источники данных, сезонные коэффициенты, экземпляры бюджетов… Но когда я прикинул, во что выльется настройка всего этого в боевой базе ради простой задачи - «менеджер заполняет план продаж по номенклатуре на 12 месяцев» - стало грустно. Типовой механизм мощный, но порог входа высокий, а нужен был простой инструмент: открыл, увидел сетку по месяцам, заполнил руками или из Excel, нажал кнопку - получил документы «План продаж».
Решил сделать внешнюю обработку «Мастер планирования». Писать руками было лень, и я поставил задачу ИИ-агенту: стек - управляемые формы, динамическая таблица значений на форме, импорт из Excel без COM, создание документов ПланПродаж. Агент выдал модуль формы примерно на 600 строк и инструкцию по сборке: какие реквизиты формы создать, какие команды, куда вставить код.
Собрал за вечер. Запустил. И дальше началось самое интересное - то, о чём в статьях про «ИИ напишет всё за вас» обычно не пишут.
Как выглядело ТЗ агенту
Чтобы было понятно, с чего всё началось, приведу формулировку задачи почти дословно:
Внешняя обработка «Мастер планирования» для 1С:ERP 2.5, управляемые формы. На форме: выбор сценария товарного планирования и вида плана, начало периода, количество периодов (месяцев). По кнопке строится сетка: строки - номенклатура (подбор из справочника или заполнение фактом продаж за прошлый год), колонки - месяцы, на пересечении количество. Бланк сетки выгружается в Excel и загружается обратно без COM-объекта (через ТабличныйДокумент). По кнопке создаются документы «План продаж» - по одному на период, статус «Утверждён». Режим запрета модальности, тонкий клиент.
Обратите внимание на последнюю фразу про модальность - я её написал. И, как вы уже поняли из первой ошибки, агент её всё равно проигнорировал в первой версии: контекст в промпте снижает вероятность ошибки, но не обнуляет её. Зато после первого падения агент этот контекст учёл уже навсегда в рамках сессии - и модальных вызовов больше не появлялось.
Отдельно отмечу: указывать в ТЗ «без COM-объекта» обязательно. Дефолтный рефлекс любого ИИ (да и многих людей) при слове «Excel» - Excel.Application, который на 64-битном сервере без установленного Office умирает красиво и навсегда. ТабличныйДокумент.Прочитать() и .Записать() решают ту же задачу платформенными средствами.
Ошибка 1. «Обращение к процедуре объекта как к функции (Показать)»
{ВнешняяОбработка.МастерПланирования.Форма.Форма.Форма(351)}:
Если Не Диалог.Показать() Тогда
Агент сгенерировал синхронный вызов диалога выбора файла - в стиле, который был нормой лет десять назад. Но в моей базе (как и в любой современной) включён режим запрета модальности: ДиалогВыбораФайла.Показать() там - процедура, принимающая ОписаниеОповещения, а не функция, возвращающая булево.
Причина. Агент знает оба API - и модальный, и асинхронный - но выбирает по «среднему» из обучающих данных, а там модального кода исторически больше. Настройку конкретной базы он не видит.
Исправление - классический async-паттерн:
Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.Открытие);
Диалог.Фильтр = "Книга Excel (*.xlsx)|*.xlsx";
Диалог.Показать(Новый ОписаниеОповещения("ЗагрузитьИзExcelПослеВыбора", ЭтотОбъект));
Урок. Первое, что надо написать в ТЗ агенту для 1С: режим модальности, режим совместимости, версия платформы и конфигурации. Это четыре строки, которые экономят час.
Ошибка 2. «Количество параметров 4. Ожидаемое количество - 2»
В методе ЗагрузитьИзExcelЗавершение количество параметров 4.
Ожидаемое количество - 2.
Следом за диалогом агент написал callback для НачатьПомещениеФайлаНаСервер с четырьмя параметрами - по образцу какой-то другой асинхронной операции. У этого метода сигнатура обработчика ровно (Результат, ДополнительныеПараметры).
Причина. У платформы десятки асинхронных методов, и у каждого своя сигнатура обработчика: у НачатьПомещениеФайлаНаСервер одна, у НачатьПолучениеФайлаССервера другая, у ПоказатьВопрос третья. Агент их путает, потому что для него это «похожие» места в текстах. Компилятор модуля (проверка по F7) сигнатуры оповещений не проверяет - ошибка всплывает только в рантайме.
Урок. Все асинхронные обработчики из сгенерированного кода - зона обязательной ручной сверки с синтакс-помощником. F7 их не ловит.
Ошибка 3. «Поле объекта не обнаружено (ОписаниеОшибки)»
Если Не ПустаяСтрока(РезультатЗагрузки.ОписаниеОшибки) Тогда
Агент предположил, что результат помещения файла - структура с полем ОписаниеОшибки. В моей версии платформы такого поля нет.
Причина. Состав свойств объектов, возвращаемых асинхронными методами платформы, меняется между версиями и почти не документирован в тех источниках, на которых учился агент. Он «додумал» правдоподобное поле. Галлюцинация не из злого умысла - из статистики: где-то такое поле точно было.
Исправление - обращение через Свойство() с проверкой… что привело к ошибке 4.
Ошибка 4. «Метод объекта не обнаружен (Свойство)»
Если РезультатЗагрузки.Свойство("ПомещениеФайлаОтменено") Тогда
А вот это уже моя любимая. Оказалось, что в этой версии платформы результат - вообще не структура, и метода Свойство() у него нет. То есть агент дважды промахнулся о тип возвращаемого значения.
Исправление - защитная универсальная функция-извлекатель, которая выживает при любом типе результата:
&НаКлиенте
Функция ИзвлечьАдресФайла(Результат)
Если Результат = Неопределено Тогда
Возврат Неопределено;
КонецЕсли;
ТипРезультата = ТипЗнч(Результат);
Если ТипРезультата = Тип("Структура") Тогда
Адрес = Неопределено;
Результат.Свойство("Адрес", Адрес);
Возврат Адрес;
КонецЕсли;
Если ТипРезультата = Тип("Строка") Тогда
Возврат Результат;
КонецЕсли;
Попытка
Возврат Результат.Адрес;
Исключение
Возврат Неопределено;
КонецПопытки;
КонецФункции
Урок. Для всего, что платформа возвращает «как получится» (результаты асинхронных файловых операций, COM-объекты, ответы внешних сервисов), просите агента сразу писать защитный разбор через ТипЗнч() и Попытка/Исключение, а не обращение к полям в лоб. Формулировка «напиши код, устойчивый к любому типу результата» работает лучше, чем «напиши правильно».
Ошибка 5. «Поле не найдено “Факт.Количество”»
Ошибка при вызове метода контекста (Выполнить):
Поле не найдено "Факт.Количество"
Запрос к виртуальной таблице оборотов регистра накопления ВыручкаИСебестоимостьПродаж.Обороты. Агент написал Факт.Количество. Но виртуальная таблица оборотов отдаёт ресурс с суффиксом - КоличествоОборот.
Причина. В физической таблице регистра ресурс называется Количество, в виртуальной - КоличествоОборот. Разница тонкая, в примерах из интернета встречается и так, и так (зависит от таблицы), и агент угадал не ту сторону. Опять же: консоль запросов в конфигураторе такое подсветила бы мгновенно, но у агента консоли нет.
Исправление - одна строчка: СУММА(Факт.КоличествоОборот) КАК Количество.
Урок. Запросы - самое слабое место. Имена виртуальных таблиц, суффиксы ресурсов (Оборот, Остаток), параметры виртуальных таблиц агент путает регулярно. Правило: каждый нетривиальный запрос из сгенерированного кода прогонять в консоли запросов до запуска обработки.
Ошибка 6. «Не определен каталог для размещения получаемых файлов»
Ошибка при вызове метода контекста (НачатьПолучениеФайлаССервера):
Не определен каталог для размещения получаемых файлов.
Выгрузка бланка Excel. Агент передал в НачатьПолучениеФайлаССервера простое имя файла без пути, рассчитывая, что платформа сама покажет диалог сохранения. Не покажет - сначала нужно явно спросить у пользователя полный путь.
Исправление - сначала асинхронный диалог сохранения, потом получение файла по выбранному пути:
Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.Сохранение);
Диалог.Фильтр = "Книга Excel (*.xlsx)|*.xlsx";
Диалог.ПолноеИмяФайла = "Бланк_плана.xlsx";
Диалог.Показать(Новый ОписаниеОповещения("ВыгрузитьБланкПослеВыбора", ЭтотОбъект, Адрес));
Урок. Файловые операции в управляемых формах - это всегда цепочка из двух-трёх асинхронных вызовов. Агент склонен схлопывать её в один шаг, «как было бы удобно». Требуйте в ТЗ явно: «все диалоги выбора/сохранения файлов - отдельным шагом перед операцией».
Ошибка 7. «Поле объекта не обнаружено (ИмяФайла)»
Диалог.ИмяФайла = "Бланк_плана.xlsx";
Финальный штрих: у ДиалогВыбораФайла нет свойства ИмяФайла - есть ПолноеИмяФайла. Агент перепутал с похожим объектом (у Файл и у текстовых документов - свои составы свойств).
Исправление - замена одного слова. После неё обработка заработала целиком: сетка построилась, Excel загрузился, документы «План продаж» создались и провелись.
Что было общего во всех семи
Разложив ошибки, получается всего три корня:
|
Корень |
Ошибки |
Признак |
|
Память вместо проверки: агент «помнит» API неточно |
3, 4, 5, 7 |
Несуществующие поля/методы, перепутанные имена |
|
Платформенная изменчивость: версии и режимы у всех разные |
1, 3, 4 |
«У меня работало» на другой версии |
|
Асинхронная модель: сигнатуры и цепочки |
1, 2, 6 |
Падает только в рантайме, F7 молчит |
Заметьте: ни одной алгоритмической ошибки. Логика обработки — построение динамической сетки, сохранение введённых данных при перестроении колонок, разбор Excel, группировка строк по периодам — была написана правильно с первого раза. Агент споткнулся не о сложное, а о «приземлённое»: точные имена свойств, сигнатуры, режимы. Это, кстати, удобная новость: то, что он путает, проверяется механически и быстро.
Что реально помогло
- Кидайте текст ошибки целиком, со стеком. Все семь итераций заняли около часа именно потому, что я вставлял сообщение платформы как есть - агент по номеру строки и тексту находил свою же строку и чинил прицельно. Фраза «не работает» стоила бы вечер переписки.
- Указывайте контекст заранее. После первой же ошибки я добавил в промпт: режим запрета модальности, ERP 2.5, тонкий клиент. Ошибки того же класса больше не повторялись.
- Просите защитный код для внешних границ. Функция ИзвлечьАдресФайла с ТипЗнч() и Попытка/Исключение - лучший артефакт вечера: она переживёт и смену версии платформы, и перенос в другую базу.
- Проверяйте запросы в консоли до запуска. Дешевле, чем ловить «Поле не найдено» в работающей форме.
- Дробите итерации. Одна ошибка - одно исправление - один запуск. Не просите «исправь всё и добавь ещё фичу» между двумя запусками: локализация сразу размазывается.
Выводы
ИИ-агент написал обработку, которая реально работает в моей базе, за один вечер - включая отладку. Руками я бы писал её дольше, это факт. Но второй факт в том, что «написал» здесь не равно «написал без меня»: моя роль была не в кодинге, а в прогоне, чтении ошибок и постановке контекста. Агент - это быстрый джун с отличной памятью на шаблоны и неточной памятью на детали API. Работать с ним надо как с джуном: ТЗ с окружением, ревью по горячим точкам (запросы, асинхронность, файловые операции), маленькие итерации.
Технологически это значит простую вещь: порог входа в прикладную разработку для 1С снизился до «умеешь читать ошибки платформы». А вот ценность тех, кто понимает, что должно получиться в ERP и почему именно так, - только выросла. Агент не знал, зачем нужна сетка по месяцам и почему план продаж, а не бюджет. Я знал.
Сама обработка «Мастер планирования» опубликована здесь же, на Инфостарте - ссылка в профиле. Если статья зайдёт, следующая будет про программное создание документов ввода остатков в ERP 2.5: там агент снова уверенно пошёл не в тот документ, и это тоже поучительная история.
Вступайте в нашу телеграмм-группу Инфостарт
Вы можете заказать платную адаптацию этой статьи под ваши задачи на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.