Вызываем LLM из нативного кода 1С: Предприятие (внешняя обработка, HTTP-запрос и парсинг ответа)

Встроенного ИИ в платформе 1С нет. Платформа даёт HTTP-соединение и работу с JSON, а обращение к модели пишется в модуле обработки. Отдельный продукт 1С с моделями, «1С:Напарник», работает в среде 1С:EDT: в конфигуратор и в пользовательский режим он не встроен.

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

📦 Что берём из платформы

Схема стенда: прогон модуля ii-zapros.bsl на платформе 8.3.27.2130 против локального HTTPS-сервиса

Для обращения к сервису хватает четырёх объектов встроенного языка:

• HTTPСоединение: соединение с сервером. В конструкторе задаются сервер, порт, таймаут и объект защищённого соединения. Метод ОтправитьДляОбработки отправляет POST-запрос, Получить читает ответ GET.
• HTTPЗапрос: адрес ресурса, заголовки и тело. Метод УстановитьТелоИзСтроки кладёт в тело строку, кодировка по умолчанию UTF-8.
• HTTPОтвет: свойство КодСостояния и метод ПолучитьТелоКакСтроку.
• ЗаписьJSON и ЧтениеJSON: сборка тела и разбор ответа, плюс глобальные процедуры ЗаписатьJSON и ПрочитатьJSON.

HTTPS требует объекта защищённого соединения: без него соединение пойдёт по HTTP и сервис его отклонит. В справке платформы приведён пример Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаОС, Новый СертификатыУдостоверяющихЦентровОС, РежимПроверкиОтзываСертификатовУдостоверяющихЦентров.Строгий).

Чего в платформе нет: клиента конкретного сервиса, учёта израсходованных токенов, потоковой выдачи ответа и общей для всех моделей обёртки. Всё это пишется в модуле обработки или не делается вовсе.

🧱 Тело запроса

Тело - обычная структура с полем model и массивом сообщений, как в OpenAI-совместимом протоколе. Заголовок Authorization несёт ключ доступа, Content-Type сообщает формат.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

// Собирает тело запроса и возвращает строку JSON.
Функция СобратьТелоЗапроса(Модель, ТекстЗапроса, ОграничениеОтвета) Экспорт

    Сообщение = Новый Структура;
    Сообщение.Вставить("role", "user");
    Сообщение.Вставить("content", ТекстЗапроса);

    Сообщения = Новый Массив;
    Сообщения.Добавить(Сообщение);

    Тело = Новый Структура;
    Тело.Вставить("model", Модель);
    Тело.Вставить("messages", Сообщения);
    Тело.Вставить("max_tokens", ОграничениеОтвета);
    Тело.Вставить("temperature", 0);

    Запись = Новый ЗаписьJSON;
    Запись.УстановитьСтроку();
    ЗаписатьJSON(Запись, Тело);

    Возврат Запись.Закрыть(); // при записи в строку возвращает готовый JSON

КонецФункции

// Отправляет запрос и возвращает объект HTTPОтвет.
// Порт и Защита необязательны: по умолчанию HTTPS на порту 443 с сертификатами операционной системы.
Функция ОтправитьЗапрос(Сервер, АдресРесурса, КлючДоступа, Тело, Таймаут, Порт = 443, Защита = Неопределено) Экспорт

    Если Защита = Неопределено Тогда
        Защита = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаОС,
            Новый СертификатыУдостоверяющихЦентровОС);
    КонецЕсли;
    Соединение = Новый HTTPСоединение(Сервер, Порт, , , , Таймаут, Защита);

    Запрос = Новый HTTPЗапрос(АдресРесурса);
    Запрос.Заголовки.Вставить("Content-Type", "application/json");
    Запрос.Заголовки.Вставить("Authorization", "Bearer " + КлючДоступа);
    Запрос.УстановитьТелоИзСтроки(Тело);

    Возврат Соединение.ОтправитьДляОбработки(Запрос);

КонецФункции

Таймаут задаётся числом секунд в конструкторе соединения; в примере он приходит параметром. Порт и объект защищённого соединения тоже можно передать снаружи: по умолчанию это порт 443 и сертификаты операционной системы, а для проверки на локальном сервисе с собственным сертификатом подставляется Новый ЗащищенноеСоединениеOpenSSL(Неопределено, Новый СертификатыУдостоверяющихЦентровФайл(ПутьКСертификату)). Адрес ресурса и имя модели зависят от сервиса: у каждого провайдера свой адрес и свои поля, поэтому сверяйте их с его документацией. Ключ в модуле не хранят - он приходит из настройки или из переменной окружения.

🧪 Разбор ответа

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

// Возвращает текст ответа модели или пустую строку, если поля нет.
Функция ТекстОтвета(Ответ) Экспорт

    Если Ответ.КодСостояния <> 200 Тогда
        ВызватьИсключение СтрШаблон("Сервис вернул код %1: %2",
            Ответ.КодСостояния, Ответ.ПолучитьТелоКакСтроку());
    КонецЕсли;

    Чтение = Новый ЧтениеJSON;
    Чтение.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку());
    Данные = ПрочитатьJSON(Чтение, Истина); // Истина - объекты читаются в Соответствие
    Чтение.Закрыть();

    Выбор = Данные.Получить("choices");
    Если Выбор = Неопределено Или Выбор.Количество() = 0 Тогда
        Возврат "";
    КонецЕсли;

    Возврат Выбор[0]["message"]["content"];

КонецФункции

Два места, где разбор обычно падает. Первое: код ответа проверяют до чтения тела, иначе ошибка сервиса приходит как ошибка разбора JSON. Второе: пустой массив choices встречается при срабатывании фильтров сервиса, и обращение к нулевому элементу без проверки даёт исключение.

🧰 Данные из базы в текст

Таблица значений в JSON уходит плохо: модель читает текст и структуру таблицы не видит. Дешевле перевести строки в текст с разделителем, а число строк ограничить.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

// Переводит таблицу значений в текст. МаксимумСтрок - условный пример ограничения.
Функция ТаблицаВТекст(Таблица, МаксимумСтрок = 100) Экспорт

    Колонки = Новый Массив;
    Для Каждого Колонка Из Таблица.Колонки Цикл
        Колонки.Добавить(Колонка.Имя);
    КонецЦикла;

    Описание = Новый Массив;
    Описание.Добавить("Колонки: " + СтрСоединить(Колонки, " | "));

    Счетчик = 0;
    Для Каждого СтрокаТаблицы Из Таблица Цикл
        Если Счетчик >= МаксимумСтрок Тогда
            Описание.Добавить("... строк не показано: " + (Таблица.Количество() - Счетчик));
            Прервать;
        КонецЕсли;

        Значения = Новый Массив;
        Для Каждого Колонка Из Таблица.Колонки Цикл
            Значения.Добавить(Строка(СтрокаТаблицы[Колонка.Имя]));
        КонецЦикла;

        Описание.Добавить(СтрСоединить(Значения, " | "));
        Счетчик = Счетчик + 1;
    КонецЦикла;

    Возврат СтрСоединить(Описание, Символы.ПС);

КонецФункции

Числа Строка() выводит по региональным настройкам: 1000,5 превращается в 1 000,5 с неразрывным пробелом (код U+00A0) и десятичной запятой. Модель такой текст читает, а разбирать его обратно кодом без замены пробела не стоит.

Ограничение по строкам обязательно: у модели есть предел входного контекста, и таблица на сотни тысяч строк его переполнит. Вместо выгрузки строк подряд считайте агрегаты запросом: суммы, средние, группировки по месяцам и складам.

🔬 Что показал прогон на платформе

Прогон шёл на платформе 1С:Предприятие 8.3.27.2130 в три этапа: серверный вызов через COM-соединение против локальной заглушки, настоящий сервис OpenRouter и простейшая внешняя обработка в тонком клиенте. Стенд: файловая база вне OneDrive, модуль из архива как общий модуль с признаками «Сервер» и «Внешнее соединение», вместо сервиса модели на первом этапе - локальный Python-сервер на https://localhost:8443 с самоподписанным сертификатом. Он принимает тело запроса, проверяет заголовок Authorization и отвечает по имени модели в теле. Проверку модулей платформа прошла (/CheckModules для тонкого клиента, сервера и внешнего соединения: «Синтаксических ошибок не обнаружено!»).

Этап 1. Вызов на сервере

Этап 2. Настоящий провайдер

Те же функции модуля, без правок, против openrouter.ai на порту 443 с сертификатами операционной системы, модель google/gemini-2.5-flash-lite, ключ из переменной окружения:

Сертификаты ОС для openrouter.ai дополнительной настройки не потребовали. Все три ошибочных ответа дошли до исключения с понятным текстом, разбор JSON при этом не запускался.

Этап 3. Внешняя обработка в тонком клиенте

Простейшая обработка «Простой клиент ИИ» собрана платформой из XML (build_epf.py в архиве, файл 10 403 байта). В модуле объекта лежит код из архива и функция Спросить, форма содержит поля сервера, порта, адреса ресурса, ключа, модели, файла сертификата, запроса и ответа и кнопку «Спросить модель». Открывается обработка в тонком клиенте через «Файл - Открыть» (Ctrl+O), и платформа сразу спрашивает разрешение:

Предупреждение безопасности при открытии файла обработки: ответ «Да» открывает форму.

Форма обработки: в полях значения для локальной заглушки.

Нажатие «Спросить модель» против локальной заглушки:

Заглушка отвечает «Получено символов: 52. Макс. токенов: 300.»: запрос дошёл до сервиса и ответ разобран.

Модель limit: в поле ответа текст ошибки с кодом 429 и телом ответа.

Тот же вызов против настоящего сервиса: в форме сервер openrouter.ai, порт 443, адрес /api/v1/chat/completions, модель google/gemini-2.5-flash-lite, поля ключа и сертификата пустые, ключ обработка берёт из переменной окружения:

Ответ настоящей модели: «Позиция с дефицитом (меньше 100 шт) - болт М8х40.»

Клиент показал то, чего не видно на сервере:

• Чтение переменной окружения. Во встроенном языке такой функции нет: имена ПолучитьПеременнуюСреды, ПолучитьПеременнуюОкружения, ПолучитьПеременнуюСредыОкружения и ПолучитьЗначениеПеременнойСреды дали ошибку компиляции. Ключ берётся через Новый COMОбъект("WScript.Shell") и ExpandEnvironmentStrings; это работает на Windows и в файловой базе, на сервере 1С хранят ключ в настройке.
• Предупреждение о COM-объекте. Первое обращение к WScript.Shell платформа прерывает и спрашивает разрешение для модуля. После ответа «Да» текущее действие нужно повторить: первое нажатие кнопки ответа не даёт.

Предупреждение о подключении исполнимого файла для модуля обработки.

Этап 4. Веб-клиент

Кнопка «Спросить в фоне» запускает ФоновыеЗадания.Выполнить("ПроверкаИИ.ФоновыйВызов", ...), ждёт ОжидатьЗавершенияВыполнения(60) и читает сообщения задания. В тонком клиенте с файловой базой задание завершилось успешно:

Фоновое задание в тонком клиенте: состояние «Задание выполнено», вызов модели занял 1 057 мс, всё задание 1 797 мс.

Одна ошибка прогона касается формы: имя Параметры занято самой формой, присвоение массиву даёт «Поле объекта недоступно для записи», переменную пришлось назвать МассивПараметров. Из COM-соединения то же задание после ожидания в 120 секунд оставалось в состоянии «Задание выполняется»; причину я не выясняла.

Веб-клиент проверялся на той же файловой базе. Публикацию сделал webinst.exe -publish -apache24 в 32-битный Apache 2.4 с модулем wsap24.dll из поставки платформы: порт 8081, права администратора не понадобились, IIS не включался. Страница http://localhost:8081/nopik/ открывается в Microsoft Edge. Обработку веб-клиент открывает через собственное окно «Выбор файлов» (Ctrl+O, «выберите с диска»), предупреждения безопасности при этом нет:

Веб-клиент: ответ «Берлин» от настоящего сервиса, ключ взят из окружения процесса Apache.

Веб-клиент: фоновое задание выполнено за 1 603 мс, вызов модели 762 мс.

При автоматическом вводе в веб-клиенте нужны паузы между действиями: при быстрой подстановке текст запроса попал в поле сертификата. После обрыва браузера без выхода из сеанса следующий вход через тот же Apache выдал «В данный момент вход в приложение невозможен»; перезапуск Apache помог.

Этап 5. Сравнение сервисов на наборе вопросов

Модуль из архива ни от чего, кроме формата тела, не зависит, поэтому на нём удобно сравнивать сервисы на регрессионном наборе. Здесь сравнение коротких ответов двух сервисов: сервис А - OpenAI-совместимый шлюз (google/gemini-2.5-flash-lite), сервис Б - вопросно-ответный сервис с контрактом {question, product}, разработка автора статьи; адрес в статье не приводится. Пять вопросов (у сервиса А температура 0), ответы проверены на платформе 8.3.27.2130 (stand/compare-run.json, stand/claims-run.txt):

Сервис А отвечал за 0,8-1,1 секунды, сервис Б за 5,6-12,2 секунды с номерами источников в ответе. Ошибка в вопросе про JSON общая: имя из ответа модели нужно проверять компилятором, прежде чем нести в код. Выборка из пяти вопросов иллюстрирует способ сверки; рейтинга сервисов из неё не получается.

Этап 6. Клиент-серверный вариант

Кластер серверов 1С входит в поставку платформы, но информационной базе в кластере нужна СУБД. Стандартный PostgreSQL 16 на создание базы ответил ошибкой extension "mchar" is not available: расширения 1С в нём отсутствуют. Рабочим оказался пакет postgrespro-1c-17 из репозитория производителя (PostgreSQL 17.10, Debian 12 в Docker, русская локаль); Dockerfile и start.sh лежат в stand/docker. Кластер поднимался из процессов пользователя без службы и без прав администратора (stand/start_cluster.ps1): агент на порту 2540, менеджер кластера 2541, сервер администрирования ras 2545, база создана командой rac infobase create --create-database и заполнена /LoadConfigFromFiles с подключением /S localhost:2541\nopik_llm.

Строка подключения к серверу 1С содержит порт менеджера кластера (2541). С портом агента (2540) Конфигуратор отвечает «Адрес не является адресом кластера серверов 1С:Предприятия».

Тонкий клиент подключается к базе кластера, обработка открывается так же, как в файловом варианте:

Клиент-серверный вариант: ответ «Берлин» получен рабочим процессом кластера; ключ читается из окружения процесса агента.

Фоновое задание на сервере: состояние «Задание выполнено», 848 мс, вызов модели 650 мс.

Ключ OpenRouter рабочий процесс кластера получает от агента, поэтому агент запускают с переменной окружения; в службе Windows её задают в параметрах службы. В клиент-серверной базе фоновое задание исполняет рабочий процесс кластера, и ему же принадлежит исходящее соединение: файрвол и прокси настраиваются для сервера 1С; рабочее место пользователя в этом соединении не участвует.

Регламентное задание проверено в базе кластера (sched.ps1, метод ПроверкаИИ.РегламентныйВызов, протокол sched-run.txt): предопределённое задание ПроверкаВызоваМодели включено с периодом 60 секунд, за 210 секунд прошло четыре запуска, ответ OpenRouter «Вена» пришёл за 601-947 мс, после чего задание выключено. Ключ задание берёт из окружения процесса рабочего сервера, как и фоновое.

Прогон дал две правки кода и одну находку. Первая правка: функции без ключевого слова Экспорт из общего модуля снаружи не видны, платформа отвечает «Метод объекта не обнаружен». Внутри модуля обработки они работают, а при переносе в общий модуль нужен Экспорт; в архиве он уже стоит. Вторая: порт 443 и сертификаты ОС были вшиты в функцию, и локальный сервис на другом порту проверить было нечем. Теперь Порт и Защита приходят необязательными параметрами. Находка касается чисел и описана выше, в разделе про таблицу.

Границы прогона. Качество ответов проверялось одной моделью на коротких запросах; лимиты провайдера и поведение при длинных ответах не измерялись. Запуски шли на сервере через внешнее соединение, в тонком клиенте и в веб-клиенте с файловой базой и в тонком клиенте с базой кластера серверов (один сервер, один пользователь, без нагрузки). Отказоустойчивость кластера, блокировки и параллельные сеансы не проверялись. Регламентное задание проверялось в базе кластера: период 60 секунд, четыре запуска за 210 секунд. Расписание по дням недели, повтор после сбоя и запрет заданий на сервере не проверялись.

🚧 Границы

• Модель не знает вашу конфигурацию. Имена реквизитов, регистров и процедур ей нужно передать в промпте: описанием структуры или выдержкой из метаданных.
• Ответ модели - текст. Если из него нужно получить запрос или код, его придётся разобрать и проверить: синтаксис BSL и язык запросов модель знает неровно.
• Обработка на сервере не имеет доступа к интерфейсу. Всё, что показывается пользователю, собирается в отдельной процедуре.
• Синхронный вызов держит сеанс. Долгий запрос к сервису на клиенте выглядит как зависшая форма, поэтому такие вызовы выносят в фоновое задание.
• Привилегированный режим и права: обработка, читающая данные для отправки, работает под правами пользователя, и обходить RLS в ней не следует.

🔒 Безопасность

Главный вопрос при внедрении - какие данные уходят. Три правила, которые закрывают большинство случаев:

1. Перечисляйте поля явно. Запрос на отправку строится из фиксированного списка колонок: произвольную таблицу пользователя в тело не кладут.
2. Обезличивайте персональные данные. ФИО, телефоны, адреса, номера документов заменяются масками до отправки; обратная замена делается на стороне 1С по справочнику соответствия.
3. Отделяйте окружения. Ключ доступа и адрес сервиса берутся из настройки: в коде, в Git и в поставке обработки их быть не должно.

Если внешний сервис недопустим по требованиям, тот же модуль работает с локальной моделью: меняются адрес, порт и имя модели, схема обмена остаётся прежней. Проверять качество ответов стоит на копии базы и на обезличенных данных.

📋 Порядок внедрения

1. Выберите одну задачу: сводка по данным, разбор текста комментариев, черновик запроса по описанию.
2. Возьмите внешнюю обработку с четырьмя функциями из архива, подставьте адрес сервиса, имя модели и ключ.
3. Прогоните вызов на копии базы с ограничением в 10-20 строк таблицы и посмотрите, что приходит в ответе.
4. Зафиксируйте в списке полей, какие данные разрешено отправлять, и внесите обезличивание в код до первого запуска на рабочей базе.
5. Оформите обработку как регламентное задание с логированием: дата, пользователь, длина запроса, код ответа. Полные тексты запросов в журнал не пишут.

📚 Источники

• Синтакс-помощник платформы 1С:Предприятие 8.3.27.2130, файл справки shcntx_ru.hbk: описания HTTPСоединение, HTTPЗапрос, HTTPОтвет, ЗаписьJSON, ЧтениеJSON, ЗащищенноеСоединениеOpenSSL, СтрСоединить, СтрШаблон.
• Документация OpenAI API, раздел Chat Completions - формат тела запроса и структура ответа choices[].message.content.
• 1С:Предприятие, раздел «Искусственный интеллект» - «1С:Напарник для 1C:EDT»: работа с моделями в среде EDT.

📎 Файл к статье

Во вложении архив к статье: модуль, шаблон промпта, чек-лист по данным, два примера ответа сервиса и описание к ним.

• ii-zapros.bsl: модуль обработки целиком - сборка тела, отправка, разбор ответа, перевод таблицы в текст;
• shablon-prompta.md: шаблон промпта для разбора таблицы и три примера заполнения;
• chek-list-dannyh.md: чек-лист по данным - что можно отправлять во внешний сервис, как обезличивать, что писать в журнал;
• primer-otveta.json: условный пример ответа сервиса, на котором проверялся разбор;
• primer-otveta-oshibka.json: условные примеры ответа с кодом 429 и ответа с пустым массивом choices - два случая, где разбор падает без проверок;
• stand/: стенд прогона - сборка проверочной базы, вспомогательный модуль, сценарий вызовов, локальный HTTPS-сервис-заглушка, сценарий проверки на OpenRouter, сборка обработки build_epf.py, запуск клиента launch_client.ps1 и протоколы прогонов e2e-run.txt и openrouter-run.txt;
• simple-client-ai.epf: готовая простейшая внешняя обработка «Простой клиент ИИ»;
• README.md: что внутри, как подключить модуль к внешней обработке, что проверено на платформе и что нет.

Модуль из архива можно вставить в модуль внешней обработки или в общий модуль серверного вызова: он не зависит от конкретной конфигурации и не обращается к её объектам.

🏁 Итог

Обращение к языковой модели из 1С собирается из штатных объектов платформы: HTTPСоединение, HTTPЗапрос, ЗаписьJSON, ЧтениеJSON. Встроенного ИИ в конфигураторе при этом нет, и «1С:Напарник» живёт в отдельной среде. Код из архива сверен со справкой платформы 8.3.27.2130 и прогнан на ней: на сервере против локальной заглушки, против OpenRouter и в тонком клиенте во внешней обработке. Первый запуск на своей базе делайте на копии с ограниченной выборкой и обезличенными данными. В комментариях интересно, какие задачи вы пробовали решать моделью прямо из обработки и что пришлось переделать после первых ответов.

 

Нинель Адольевна Щербакова (Ninel_S)

Архитектор • SRE & DevOps инженер • HighLoad 1С

Автор 48 технических публикаций на Infostart. Разработчик NOPik, SRE-Suite-for-1C и мультиагентных ассистентов для экосистемы 1С:Предприятие.

Каталог статей и открытых репозиториев Ninel_S