ИИ-агент для 1С: три способа подключения — внешняя обработка, OData в 1С:Фреш и пакетный конфигуратор для расширений
Ниже три способа дать ИИ-агенту (языковой модели с набором инструментов) доступ к информационной базе 1С. Они отличаются тем, где работает база и что разрешено менять: локальная база с внешней обработкой, облако 1С:Фреш через стандартный интерфейс OData и пакетный режим конфигуратора для доработки расширением. Все примеры выполнены на учебных и тестовых базах.
Сравнение способов
| Способ | Где применим | Что доступно агенту | Что меняется в базе |
|---|---|---|---|
| Внешняя обработка с MCP-сервером | Локальная файловая или серверная база, открыт клиент 1С | Запросы, метаданные, выполнение кода (создание и проведение документов) | Конфигурация не меняется |
| Стандартный интерфейс OData | 1С:Фреш и любые базы с опубликованным OData | CRUD по опубликованным объектам, проведение, регистры | Конфигурация не меняется, нужен отдельный пользователь |
| Пакетный режим конфигуратора | Доработки на копии базы | Выгрузка и загрузка ИБ, сборка и загрузка расширения, проверка модулей | Добавляется расширение, основная конфигурация остаётся на поддержке |
1. Локальная база: внешняя обработка с MCP-сервером
Пример задачи: поставщик прислал скан товарной накладной. Нужно найти контрагента и договор, сверить номенклатуру и суммы, создать документ «Поступление (акт, накладная, УПД)» и провести его.
Как подключается агент. Окно 1С остаётся клиентом, агент обращается к информационной базе через MCP-коннектор. В примере использован открытый 1c-mcp-toolkit (ROCTUP), для серверного варианта подходит коннектор В. Харина на расширении с HTTP-сервисом. Внешняя обработка .epf поднимает локальный сервер, пока открыта 1С, и конфигурацию не меняет. Через неё доступны запросы, метаданные и выполнение кода.
Порядок обработки документа:
- Письмо → вложение (скан) → Windows OCR → извлечение полей языковой моделью (YandexGPT): ИНН, номер и дата, строки, суммы, НДС.
- Запросом к базе: поставщик по ИНН, договор, номенклатура (поиск по наименованию и артикулу), проверка на дубль документа.
- Карточка «что будет создано», бухгалтер подтверждает.
- Создание и проведение документа, затем сверка проводок регистра бухгалтерии с суммами скана.
- Вопросы по учёту обычным языком: сальдо 60, ОСВ за период.
Грабли:
- При программном проведении срабатывает проверка заполнения. Обязательные реквизиты табличных частей нужно заполнять так же, как это делает форма: ставки НДС, счета учёта, подразделения.
- Запись через коннектор лучше держать на отдельном порту с отдельным пользователем, а основной порт оставить только на чтение.
- Слабой модели нельзя давать «сырые» запросы. Агенту стоит выдавать крупные инструменты (найти контрагента, создать поступление по структуре), а логику держать внутри инструмента.
2. Облако 1С:Фреш: стандартный интерфейс OData
Во Фреш нет конфигуратора и внешних обработок в привычном виде. Зато есть стандартный интерфейс OData: Администрирование → Синхронизация данных → «Настройки стандартного интерфейса OData». Там создаётся отдельный пользователь, загружаются метаданные и выбирается состав объектов.
Что проверено на тестовой базе БП 3.0 во Фреш:
GET Catalog_Контрагенты?$filter=Description eq '...'— поиск. Пробелы в$filterкодируются%20, иначе сервер отвечает 500.POST Catalog_Контрагенты,Catalog_ДоговорыКонтрагентов(ВидДоговора = «СПокупателем»),Catalog_Номенклатура(Услуга = true).POST Document_РеализацияТоваровУслугс табличной частьюУслуги: ВидОперации = «Услуги», СчетДоходов 90.01.1 + субконто — номенклатурная группа, СтавкаНДС = «БезНДС» для УСН.- Проведение:
POST Document_РеализацияТоваровУслуг(guid'...')/Post(). - Проводки:
AccountingRegister_Хозрасчетный_RecordType?$filter=Recorder eq cast(guid'...', 'Document_РеализацияТоваровУслуг')— Дт 62.01 / Кт 90.01.1. - Остатки:
AccountingRegister_Хозрасчетный/Balance(AccountCondition='Account_Key eq guid''...'''). - DELETE через OData запрещён правами. Тестовые объекты помечаются
DeletionMarkи удаляются штатной обработкой «Удаление помеченных объектов». - После проведения через OData иногда висит плашка «Проводки неактуальны», помогает «Актуализировать».
Ограничения: доступны только объекты, включённые в состав OData; бизнес-логика форм (заполнение по умолчанию, обработчики форм) не выполняется, поэтому реквизиты нужно передавать явно; права пользователя OData стоит ограничить нужными объектами.
3. Пакетный режим конфигуратора: доработка расширением на копии базы
Пример задачи: признак «надёжность поставщика» в карточке контрагента и запрет проводить поступления от поставщиков из стоп-листа.
Порядок действий агента:
/DumpIB— резервная копия, затем/RestoreIBв отдельную копию.- Сборка расширения из XML: реквизит справочника, элемент формы, подписка или обработчик
ОбработкаПроверкиЗаполнения/ПередЗаписьюс отказом и сообщением. - Загрузка расширения в копию,
/CheckModules,/UpdateDBCfg. - Проверка в интерфейсе: поле появилось, проведение от поставщика из стоп-листа запрещено с понятным текстом.
- Сверка: основная конфигурация не изменена (типовая остаётся на поддержке), отчёт об изменениях для разработчика.
Грабли пакетного режима: безопасный режим расширений; зарезервированные слова в именах; расширение не применится без /UpdateDBCfg; Smart App Control на Windows мешает запуску платформы из скриптов.
Безопасность
- Отдельная учётная запись агента с ограниченными правами.
- Работа на копии базы, запись в рабочую только после подтверждения специалиста.
- Типовая конфигурация не снимается с поддержки, доработки только расширениями.
- Модели российские (YandexGPT, GigaChat), данные остаются в России.
«1С», «1С:Фреш» и названия конфигураций — товарные знаки их правообладателей.
Вступайте в нашу телеграмм-группу Инфостарт
Вы можете заказать платную адаптацию этой статьи под ваши задачи на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.