1С:Фреш и ИИ: подключение через OData, без обработки
Основной способ подключить 1С к ИИ у нас - внешняя обработка: база сама ходит наружу за заданиями. Но есть базы, куда обработку ставить неудобно или нельзя: 1С:Фреш в облаке и базы, опубликованные на веб-сервере. Для них мы сделали второй путь - через стандартный протокол OData. Обработку скачивать и запускать не нужно, мост сам обращается к базе. Пока только на чтение, запись в планах.
Когда этот способ
Обычный способ подключения к сервису - внешняя обработка внутри базы: она сама опрашивает мост исходящим HTTPS, входящих подключений к 1С нет вообще. Это основной путь, и подходит он почти для любой базы, куда обработку можно поставить и запустить, - от современных конфигураций до обычных форм и старых платформ.
Но запустить обработку можно не везде. Там, где это нельзя или неудобно, универсальным путем становится подключение через OData:
- 1С:Фреш - закрытое облако: запустить там свою внешнюю обработку не выйдет, даже если бы очень хотелось. А стандартный механизм OData во Фреше есть - им и пользуемся;
- база уже опубликована на веб-сервере - значит стандартный OData у нее, скорее всего, включен, и им можно воспользоваться напрямую;
- к конфигуратору доступа нет, а завести служебного пользователя и отметить состав данных - можно.
Во всех этих случаях подойдет подключение через OData. Мост сам обращается к базе по стандартному адресу под отдельной служебной учетной записью, а вы в это время ничего в базе не запускаете.
Как это работает
ИИ не получает сырой OData и не пишет запросы к базе напрямую. Мост разбирает состав базы сам и дает ассистенту понятный набор операций: список сущностей, поля одной сущности, чтение порции данных, один объект по ссылке, срез последних значений регистра. Большие выборки отдаются частями.
Обработка или OData
Это не замена, а второй маршрут. Выбирайте по ситуации.
Через обработку
Универсально: работает на любых платформах, включая старые и обычные формы. Есть чтение и запись (запись через пробный прогон). Подходит, когда есть доступ к базе и можно открыть обработку или настроить регламентное задание.
Через OData
Для 1С:Фреш и баз на веб-сервере. Ставить в базу ничего не нужно, окно держать открытым тоже. Пока только чтение. Отдаются данные из объектов, которые вы включили в состав OData на стороне базы.
Как решить
Нужна запись или база на старой платформе - берите обработку. База в 1С:Фреш или уже опубликована, а от ИИ нужно чтение - берите OData: это быстрее всего и без установки.
Настройка за пять минут
Со стороны базы нужен служебный пользователь OData, со стороны сервиса - ключ. По шагам:
Служебный пользователь на стороне базы
В 1С:Фреш откройте обработку «Настройка автоматического REST-сервиса». На вкладке «Авторизация» заведите отдельного служебного пользователя - не свой личный логин. На вкладке «Состав» отметьте только те объекты, которые нужны ИИ: справочники, документы, регистры по делу, не всю базу подряд.
Официальная инструкция 1С: 1cfresh.com/articles/data_odata. Для базы, опубликованной на своем веб-сервере, стандартный OData включается при публикации.
Источник в кабинете
В кабинете нажмите «Создать ключ» и выберите вид «1С Фреш». Укажите адрес приложения так, как он в адресной строке браузера, когда вы работаете в базе, - хвост вроде /odata/standard.odata добавлять не нужно, сервер подставит его сам. Введите логин и пароль служебного пользователя. Нажмите «Проверить соединение»: мост зайдет в базу и покажет, сколько сущностей доступно.
Ключ и промт для ИИ
После успешной проверки выпустите ключ. В кабинете есть готовый текст-промт для ассистента: в нем уже адрес, ключ и весь набор операций. Отдайте его первым сообщением ассистенту, который умеет ходить в интернет по инструментам, - Claude, ChatGPT с доступом в сеть, агент в среде разработки. Дальше спрашивайте базу словами.
Что с безопасностью
Отдельная служебная учетная запись. ИИ ходит в базу не под вашим логином, а под служебным пользователем, которого вы завели специально и с ограниченным составом объектов. Логин и пароль хранятся у нас в зашифрованном виде.
Только чтение. Через этот способ данные нельзя изменить в принципе - доступны только операции выборки. Показать, свести, посчитать можно; проводить документы и править справочники - нет.
Состав вы задаете сами. ИИ увидит ровно те объекты, которые вы включили в состав OData на стороне базы. Не включили - значит и через ключ их не видно.
Выключается мгновенно. Выключили ключ в кабинете - обмен прекращается сразу. Показ структуры базы ассистенту - отдельное согласие в карточке ключа, по умолчанию имена объектов ИИ подсказываете вы сами.
Границы способа
Пока только чтение. Запись через OData в планах, сейчас изменить данные этим способом нельзя. Нужна запись уже сегодня - подключайте базу через обработку.
Работает там, где есть стандартный OData: 1С:Фреш и базы, опубликованные на веб-сервере. На обычных формах и совсем старых платформах его нет - там остается обработка.
ИИ видит только то, что вы включили в состав OData, и работает через наш набор операций, а не сырыми запросами. Это сделано специально: так модель не уходит в произвольные конструкции и не тянет из базы лишнее.
Коротко
Если у вас 1С:Фреш или база на веб-сервере и от ИИ нужно чтение - теперь это подключается без обработки за несколько минут: завели служебного пользователя, вписали адрес и учетную запись в кабинете, выпустили ключ. Все остальное сервис берет на себя. А там, где нужна запись или платформа старая, по-прежнему работает подключение через внешнюю обработку.
Три дня работы одной базы при регистрации, карта не нужна.
Ключи OData тарифицируются так же, как обычные. Подробно о тарифах
Комментарии
Вопросы по делу, свой опыт и спокойная критика - публикуем. Реклама и ссылки на сторонние сайты не проходят. Комментарии открываются после проверки.