Чтобы подключить 1С:Предприятие к ИИ-агенту в СуперИнтеллекте, нужно сделать два шага на стороне 1С и один на стороне платформы: опубликовать у базы стандартный OData-интерфейс, завести отдельного пользователя информационной базы с ролью удалённого доступа OData и вписать адрес публикации, логин и пароль в карточке интеграции 1С:Предприятие. Дорабатывать конфигурацию не нужно: коннектор работает через стандартный протокол OData, поэтому подходит для любой типовой конфигурации — Управление торговлей (УТ), Бухгалтерия (БП), ЗУП, УНФ, Розница и другие, — как для локальной 1С, так и для облачной 1С:Фреш. Ниже — пошаговая инструкция и настройки, от которых зависит, будет агент отвечать точно или путаться в названиях объектов.
Что умеет коннектор 1С:Предприятие
| Модуль | Инструментов | Что делает |
|---|---|---|
| Состав базы | 3 | Проверка подключения с диагностикой (подсказывает, что именно поправить в 1С); список объектов базы — справочники, документы, регистры — с поиском по русскому названию; описание объекта: поля, типы, табличные части |
| Данные | 11 | Выборка с фильтрами, сортировкой и постраничностью; получение записи по ссылке; поиск по-человечески — по названию, коду, номеру, артикулу, ИНН; подсчёт количества; итоги регистров — остатки и обороты (остатки на складе, задолженность контрагента, продажи за период, актуальные цены); создание элементов справочников, документов вместе с табличными частями и записей регистров; обновление; проведение и отмена проведения документов; пометка на удаление и физическое удаление; экспертный режим прямого OData-запроса на чтение |
| HTTP-сервисы | 3 | Вызов ваших собственных HTTP-сервисов 1С — например, готовых отчётов и печатных форм, которых нет в стандартном OData. Выключен по умолчанию, включается вручную и работает по списку разрешённых адресов |
Шаг 1. Опубликовать OData-интерфейс базы
Первый шаг делает администратор 1С. Задача — чтобы база отвечала снаружи по HTTPS и отдавала стандартный интерфейс OData. Писать код не нужно: это штатная возможность платформы 1С.
- База опубликована на веб-сервере. Для локальной 1С публикацию настраивает администратор; для облачной 1С:Фреш адрес базы берётся в личном кабинете сервиса.
- Включён стандартный интерфейс OData, и в его состав добавлены объекты, которые понадобятся агенту: справочники, документы, регистры. Если нужного справочника нет в составе интерфейса, агент его не увидит — база просто не отдаст его наружу.
- Адрес открывается по HTTPS. Адрес без шифрования коннектор не примет.
- База доступна из интернета, а не только из локальной сети — платформа обращается к ней снаружи. Если 1С стоит в закрытом контуре, вопрос доступа решается с вашим системным администратором.
Шаг 2. Создать отдельного пользователя с ролью удалённого доступа OData
Не подключайте агента под своей учётной записью и тем более не под администратором. Заведите отдельного пользователя информационной базы — так вы в любой момент увидите, что делалось от его имени, и сможете отозвать доступ одним действием, не трогая остальных сотрудников.
- Создайте нового пользователя информационной базы в 1С.
- Имя пользователя задайте латиницей — кириллический логин коннектор не примет.
- Задайте длинный уникальный пароль: коннектор подключается по логину и паролю пользователя информационной базы, а не через аутентификацию операционной системы.
- Выдайте роль удалённого доступа OData — без неё запросы к базе будут отклоняться, даже если логин и пароль верные.
- Дайте минимальные права на чтение тех объектов, которые нужны агенту. Права на изменение — только если вы осознанно дойдёте до шага 6.
Шаг 3. Заполнить подключение в каталоге интеграций
Дальше — сторона платформы. Откройте каталог интеграций, найдите карточку 1С:Предприятие и заполните поля подключения. Если аккаунта ещё нет — зарегистрируйтесь и откройте каталог.
| Поле | Что вписать | Где взять |
|---|---|---|
| Адрес публикации базы | HTTPS-адрес опубликованной базы. Хвост /odata/standard.odata дописывать не нужно — коннектор добавит его сам | У администратора 1С — адрес публикации на веб-сервере. Для 1С:Фреш — адрес базы в личном кабинете сервиса |
| Имя пользователя | Логин отдельного пользователя информационной базы, только латиницей | Создали на шаге 2 |
| Пароль | Пароль этого пользователя | Задали на шаге 2 |
| Часовой пояс базы | Часовой пояс, в котором работает база | У администратора 1С. Влияет на корректность запросов вида «остаток на сегодня» |
| Словарь синонимов | Пары «бизнес-слово → объект 1С» | Собирается из инструмента «список объектов базы» — см. шаг 5 |
| Список разрешённых объектов | Что агенту вообще видно | Ваше решение: чем уже список, тем предсказуемее поведение |
| Список объектов для записи | Более узкий перечень объектов, которые можно менять | Ваше решение. Заполняется только вместе с правами на запись |
| Поля по умолчанию и подсказки агенту | Какие поля возвращать для «тяжёлых» объектов и свободные пояснения о вашем учёте | Ваша практика работы в 1С |
Шаг 4. Проверить подключение диагностикой
В модуле «Состав базы» есть инструмент проверки подключения, и он отличается от обычного «ок / не ок»: при неудаче он показывает диагностику — что именно поправить в 1С. Просто напишите агенту: «Проверь подключение к 1С и скажи, что нужно исправить». Дальше попросите список объектов базы — это и проверка, и первый шаг к словарю синонимов: вы увидите, как реально называются справочники, документы и регистры в вашей конфигурации, и сможете искать их по русскому названию.
Шаг 5. Часовой пояс и словарь синонимов
Часовой пояс базы — короткая настройка с заметным эффектом. Итоги регистров считаются на момент времени, и если платформа и база расходятся во времени, «остаток на сегодня» или «продажи за вчера» могут посчитаться не за тот период. Укажите часовой пояс один раз — и вопросы «на сегодня», «за прошлую неделю», «на конец месяца» начнут работать так, как вы ожидаете.
Словарь синонимов — самая полезная настройка
Пропускать её не стоит. Проблема в том, что вы говорите бизнес-словами («товары», «заказы», «клиенты», «долги»), а в базе лежат объекты со своими именами, причём в разных конфигурациях они называются по-разному. Словарь синонимов сопоставляет одно с другим: «товары» → справочник «Номенклатура», «заказы» → документ «Заказ клиента». После этого агент перестаёт гадать и сразу идёт в нужный объект, а вы перестаёте формулировать запросы на языке 1С.
slovar-sinonimov.txt
# формат: как говорите вы → как объект называется в вашей базе
товары → справочник «Номенклатура»
заказы → документ «Заказ клиента»
клиенты → <справочник контрагентов вашей конфигурации>
остатки → <регистр остатков номенклатуры вашей конфигурации>
долг → <регистр взаиморасчётов вашей конфигурации>
# точные имена объектов получите у самого агента:
«Покажи список справочников, документов и регистров базы —
найди всё, что связано с контрагентами и с остатками»
# и уточните состав полей перед тем, как строить отчёты:
«Опиши объект <название>: какие есть поля, типы и табличные части»Шаг 6. Права на запись — только если они нужны
По умолчанию агент работает только на чтение: смотрит справочники и документы, считает итоги регистров, отвечает на вопросы. Если нужно, чтобы он ещё и заводил данные, права на изменение включаются вручную. Тогда становятся доступны создание элементов справочников, документов вместе с табличными частями и записей регистров, обновление, проведение и отмена проведения документов, пометка на удаление (штатная для 1С и обратимая) и физическое удаление — последнее только с явным подтверждением. Разумная практика: включить запись, но ограничить её отдельным узким списком объектов — например, разрешить создавать заказы клиента и не пускать агента в справочники, которые ведёт бухгалтерия. Не забудьте, что права должны быть выданы и пользователю в самой 1С: платформа не может дать больше, чем разрешено учётной записи.
Безопасность и ограничение доступа
Коннектор ходит в вашу базу под вашей же учётной записью — значит, границы задаёте вы, причём в двух местах сразу: правами пользователя в 1С и настройками карточки интеграции. Что стоит сделать при подключении:
- Оставить режим только на чтение, пока не появится конкретная задача на запись.
- Ограничить список разрешённых объектов — агент видит только то, что вы перечислили, остальная база для него не существует.
- Держать отдельный, более узкий список объектов для изменений — он не обязан совпадать со списком для чтения.
- Помнить, что пометка на удаление обратима, а физическое удаление выполняется только после явного подтверждения.
- Не включать модуль HTTP-сервисов без нужды: он выключен по умолчанию, а при включении работает по списку разрешённых адресов ваших собственных сервисов 1С.
- Использовать отдельного пользователя информационной базы — доступ можно отозвать в 1С в любой момент, не затрагивая остальных сотрудников.
- Учитывать, что вызовы инструментов 1С не расходуют нейроны платформы — работает ваш собственный доступ к базе.
Первые запросы агенту
После проверки подключения не начинайте со сложного. Сначала убедитесь, что агент видит нужные объекты и правильно понимает ваши слова, и только потом переходите к отчётам и записи. Вот формулировки, с которых удобно стартовать — их можно писать обычным языком, никаких команд запоминать не нужно:
pervye-zadachi-agentu.txt
Проверь подключение к 1С и скажи, что нужно поправить.
Покажи, какие справочники, документы и регистры есть в базе.
Найди всё, что связано с номенклатурой.
Опиши объект «Номенклатура»: какие поля, типы и табличные части.
Найди контрагента по ИНН <ИНН> и покажи карточку.
Найди товар по артикулу <артикул>.
Найди документ по номеру <номер> и покажи табличную часть.
Сколько сейчас остатков по товару <название> на складе?
Покажи задолженность контрагента <название> на сегодня.
Сколько продали за прошлый месяц? Сравни с позапрошлым.
Покажи актуальные цены по группе товаров <название>.
Сколько всего позиций в справочнике номенклатуры?
Выведи последние документы за неделю, отсортируй по дате.Частые ошибки и как их починить
- Аутентификация операционной системы вместо пароля. Коннектор подключается по логину и паролю пользователя информационной базы. Если публикация настроена на доменную авторизацию, заведите обычного пользователя базы с паролем.
- Адрес без HTTPS. Нужен именно защищённый адрес — обычный незашифрованный подключить не получится.
- Нет роли удалённого доступа OData. Частая причина отказа: пользователь существует, пароль верный, а данные не отдаются. Проверяется в настройках ролей пользователя в 1С.
- Объект не включён в состав интерфейса OData. Агент «не видит» справочник не потому, что не умеет, а потому что база его не публикует. Добавьте объект в состав стандартного интерфейса.
- Кириллический логин. Имя пользователя должно быть латиницей.
- Дописанный вручную хвост адреса. Часть /odata/standard.odata коннектор добавляет сам — если вписать её ещё раз, адрес получится некорректным.
- Пустой словарь синонимов. Формально всё работает, но агент отвечает мимо: он не знает, что ваши «заказы» — это конкретный документ вашей конфигурации. Лечится по шагу 5.
- Часовой пояс не указан. Ответы «на сегодня» и «за вчера» смещаются. Особенно заметно на остатках и оборотах.
Частые вопросы
Нужно ли дорабатывать конфигурацию 1С?
Нет. Коннектор работает через стандартный протокол OData, поэтому подходит для любой типовой конфигурации — Управление торговлей (УТ), Бухгалтерия (БП), ЗУП, УНФ, Розница и другие. Достаточно опубликовать стандартный OData-интерфейс и создать пользователя с ролью удалённого доступа. Программист для подключения не нужен, нужен администратор 1С.
Работает ли это с облачной 1С:Фреш?
Да. Коннектор работает и с локальной 1С на своём сервере, и с 1С:Фреш. Разница только в том, где брать адрес: в первом случае это адрес публикации на вашем веб-сервере, во втором — адрес базы в личном кабинете сервиса.
Может ли агент что-то испортить в базе?
По умолчанию агент работает только на чтение — права на изменение и удаление включаются вручную. Физическое удаление требует явного подтверждения, а пометка на удаление штатная для 1С и обратимая. Дополнительно можно ограничить список объектов, которые агенту видно, и отдельным, более узким списком — то, что ему можно менять. Больше, чем разрешено учётной записи в самой 1С, коннектор сделать не может.
Почему агент не находит «товары» или «заказы»?
Обычно причин три: не заполнен словарь синонимов (агент не знает, какой объект вы имеете в виду), объект не включён в состав опубликованного OData-интерфейса или он не попал в список разрешённых объектов в карточке интеграции. Начните с запроса «покажи список объектов базы» — сразу станет видно, что именно доступно.
Расходует ли работа с 1С нейроны платформы?
Вызовы инструментов 1С не расходуют нейроны платформы — коннектор работает через ваш собственный доступ к базе. Расходуется только сама работа модели в диалоге, как в любом другом чате.
Подключите свою базу и задайте первый вопрос
Начните с чтения, соберите словарь синонимов, а права на запись включайте позже и точечно — так остатки, долги, продажи и документы становятся доступны обычным вопросом, без выгрузок и промежуточных отчётов. Дальше по теме: анонс интеграции 1С, практический разбор 1С для бухгалтера и подборка сценариев ИИ для бухгалтеров. Создать аккаунт и открыть каталог интеграций — регистрация на платформе.
