Как подключить 1С:Фреш к Алисе AI для бизнеса

Почему штатно не получается

Плагин Яндекса устроен так: в базу ставится расширение из комплекта Яндекса, база публикуется на веб-сервере с HTTP-сервисом, заводится служебный пользователь, и адрес публикации вписывается в настройки плагина. Каждый из этих шагов требует доступа к серверу и к конфигуратору.

В 1С:Фреш база живет в облаке 1С. Публикацию делает провайдер, а не вы, и по адресу приложения нет нужного HTTP-сервиса. Расширения там ставятся только из проверенного каталога, произвольное расширение Яндекса загрузить нельзя. Поэтому у пользователя Фреша нет ни адреса, который можно вписать в плагин, ни возможности добавить в базу то, что плагин ждет на другой стороне.

Единственное, что Фреш дает наружу штатно, это стандартный интерфейс OData: после настройки REST-сервиса база отвечает на запросы данных под служебным пользователем. Но Алиса с OData не работает, ее плагин знает только свой протокол.

Как это решает Жёлтый мост

Мост встает между Алисой и базой. С одной стороны он выглядит для Алисы как та самая база с расширением: плагину выдается адрес на нашем сервере, и Алиса общается с ним своим обычным способом. С другой стороны мост ходит в вашу базу во Фреше по OData под служебным пользователем, которого вы завели сами.

Между этими сторонами мост делает работу, которую иначе пришлось бы делать Алисе: находит нужные таблицы и поля, превращает вопросы плагина в чтения OData, подставляет вместо внутренних ссылок читаемые названия контрагентов, товаров и счетов, считает остатки и обороты по регистрам, включая бухгалтерские, и складывает итоги там, где OData отдает только строки. Для Алисы это выглядит как обычная база 1С, в которой можно спросить остатки, долги, обороты и документы за период.

Ключ Алисы отдельный, только на чтение и без тарификации: он выдается от ключа базы, работает, пока жив основной, и гаснет вместе с ним. Записывать в базу через этот путь нельзя в принципе.

Что понадобится

• Подписка Яндекс 360 для бизнеса с включенной Алисой AI. Ее оформляет Яндекс, у нас она не продается.
• База в 1С:Фреш с правами администратора, чтобы настроить REST-сервис и завести служебного пользователя.
• Кабинет в сервисе Жёлтый мост. Регистрация по почте, первые дни работы ключа бесплатны.

Подключение по шагам

1. Служебный пользователь во Фреше

В базе откройте обработку "Настройка автоматического REST-сервиса". На вкладке "Авторизация" заведите отдельного служебного пользователя, не свой личный логин. На вкладке "Состав" отметьте объекты, которые Алисе можно видеть: нужные справочники, документы и регистры, а не всю базу подряд. Официальная инструкция 1С: 1cfresh.com/articles/data_odata.

2. Ключ базы в кабинете

В кабинете нажмите "Создать ключ" и выберите вид "1С Фреш". Укажите адрес приложения так, как он виден в адресной строке браузера, когда вы работаете в базе, и логин с паролем служебного пользователя. Нажмите "Проверить соединение": мост зайдет в базу и покажет, сколько объектов доступно. После проверки выпустите ключ. Учетная запись хранится у нас в зашифрованном виде и Алисе не передается.

3. Разрешите показ структуры

В карточке ключа на вкладке "Источник" включите "показывать схему ИИ". Без этого Алиса не получит список объектов базы и сможет обращаться только к таблицам, имена которых знает сама. Это отдельное согласие, потому что состав базы тоже информация о вашем учете.

4. Ключ для Алисы

В той же карточке откройте вкладку "Ключи приложений", выберите "Алиса AI для бизнеса" и нажмите "Выдать". Под ключом появится адрес подключения. Скопируйте его целиком.

5. Плагин в Яндекс 360

Откройте Алису в Яндекс 360 для бизнеса, раздел "Плагины", включите "1С:Предприятие" и вставьте адрес из кабинета. Логин и пароль в настройках плагина любые: их проверяет наш адрес, а не база, и настоящую учетную запись Фреша туда вводить не нужно.

6. Первый вопрос

Спросите Алису: "Какие остатки товаров на складе на сегодня?" или "Кто нам должен больше всего по счету 62?". Первый ответ приходит через 10-20 секунд: Алиса сначала смотрит состав базы, потом строит запросы. Дальше быстрее.

Что Алиса сможет и чего не сможет

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

Сложные конструкции языка запросов 1С через OData не переводятся: соединения таблиц, вложенные запросы, объединения, временные таблицы. Если Алиса такое построит, она получит понятный отказ и, как правило, переформулирует вопрос в несколько простых. На точность это влияет мало, на скорость иногда заметно.

Запись в базу недоступна. Это ограничение самого плагина Яндекса, и мост его не снимает: ключ Алисы выдается только на чтение независимо от прав служебного пользователя.

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

• Алиса не знает ни адреса вашей базы во Фреше, ни учетной записи. У нее есть только адрес на нашем сервере и ключ, который вы можете отозвать одной кнопкой.
• Персональные данные маскируются на нашей стороне до отправки в Алису. На ключах это включено всегда.
• Состав доступных объектов вы задаете сами на стороне Фреша, мост не может увидеть больше, чем разрешено служебному пользователю.

Что почитать дальше

Как Алиса отвечает на вопросы к 1С в сравнении с ChatGPT и Claude, с цифрами и протоколами: Тест-драйв подключения ИИ к 1С. Подключение Алисы к обычной, не облачной базе, включая старые конфигурации: Алиса AI для бизнеса и 1С без публикации базы. Почему ChatGPT и Claude тоже не подключаются к Фрешу напрямую и как это решается: ИИ для 1С:Фреш через OData.