КРАТКАЯ ИНСТРУКЦИЯ
От первого запуска
до первой задачи.
Пройдите шесть шагов. Подробности раскрываются там, где они нужны.
Что понадобится
От 8 ГБ оперативной памяти, из них не менее 3 ГБ свободно. От 5 ГБ свободного места на диске без учёта базы 1С. Доступ к интернету.
Доступ к базе, учётная запись 1С и права на нужные операции. Для чтения данных нужен установленный компонент COMConnector.
Связывает ИИ-агента с вашей базой 1С и предоставляет инструменты для работы с ней. Скачайте и распакуйте архив. Во время работы агента приложение должно быть запущено.
Клиент, который умеет подключать внешние инструменты и вызывать их при выполнении задачи. Доступ к ИИ предоставляется отдельно.
Чем агент отличается от обычного чата?
Обычный чат работает с тем, что вы ему сообщили. Подключённый агент может вызвать инструмент, получить данные из базы, оценить результат и выполнить следующий шаг. UniOneCAI предоставляет эти инструменты, а ИИ-клиент управляет их вызовами.
MCP — протокол подключения инструментов. Важно, чтобы клиент поддерживал подходящий транспорт и способ авторизации, а не только назывался «ИИ-агентом».
Первый запуск
- Распакуйте полученный архив приложения целиком в отдельную папку, доступную вам для записи.
- Запустите
UniOneCAI.exeиз корня этой папки. Не запускайте приложение внутри архива. - Дождитесь подготовки компонентов. При первом запуске требуется интернет: необходимые среды загружаются автоматически.
- Если появится окно активации, введите ключ лицензии и затем ПИН-код, если он требуется.
Не нужно самостоятельно устанавливать .NET и Python для приложения. Подготовка необходимых компонентов выполняется при запуске.
Показано «Требуется пакет возможностей»
Пакет содержит инструменты и знания для работы агента. Проверьте действительность лицензии и доступ к интернету, затем загрузите или обновите пакет в приложении. Пока пакет недоступен, запуск инструментов невозможен.
Добавьте базу 1С
Подключения → Добавить подключение → 1С
- Задайте понятное имя подключения. По нему вы сможете отличать базы.
- Выберите базу из списка или укажите её расположение: каталог файловой базы либо сервер и имя базы.
- Укажите пользователя и пароль 1С.
- Нажмите «Проверить подключение». При ошибке проверьте доступ к базе и выбранную платформу.
Учётная запись 1С и учётные данные входа ИИ — разные вещи. Пароль базы вводится в приложении; отправлять его в переписку с ИИ не нужно.
Выберите права
В карточке подключения откройте настройки прав. У нового подключения изначально выбраны все доступные по лицензии права. Уберите лишние перед подключением агента.
Из чего складывается фактический доступ?
Действие должно быть разрешено лицензией, правами базы в UniOneCAI, назначением MCP и полномочиями токена. Дополнительно действуют права пользователя 1С. Разрешение на одном уровне не снимает запрет на другом.
Что важно знать о внешних обработках и группах прав?
Даже обработка в безопасном режиме может изменять данные 1С. Если нужен доступ только для чтения, отключите оба права запуска внешних обработок, редактирование и доступ к конфигуратору.
Полностью выбранная группа разрешает и будущие подправа этой группы. Если нужен фиксированный набор, выбирайте отдельные пункты. «Запуск скриптов и работа с файлами» разрешает вычисления на вашем ПК — включайте, когда это нужно для задачи.
Подключите ИИ
Карточка подключения → MCP
Адрес должен быть доступен ИИ-клиенту. localhost подходит только для клиента, который обращается к MCP с этого компьютера. Для облачного клиента нужен доступный из интернета адрес, например через Bridge.
Где искать настройку в ИИ-клиенте?
Откройте раздел внешних инструментов, подключений или MCP-серверов. Название зависит от клиента. Добавьте адрес MCP и выберите соответствующий способ авторизации. Если клиент не позволяет подключить MCP-сервер нужного типа, одного окна чата недостаточно.
После сохранения настроек обновите список инструментов или переподключите сервер в ИИ-клиенте. Если менялись права OAuth, может потребоваться повторная авторизация.
Попробуйте на своей базе
Выберите пример и отправьте его агенту. Он уточнит недостающие условия и обратится к вашей 1С.
Продажи
Сравни продажи за два последних полных месяца. Покажи, какие товары и покупатели дали основной рост или снижение.
Долги покупателей
Покажи задолженность покупателей на сегодня. Выдели просроченные долги и документы, по которым они возникли.
Товары без движения
Найди товары, которые есть на складе, но не продавались последние 90 дней. Покажи количество и дату последней продажи.
Работа с документами
Помоги создать заказ покупателя. Уточни у меня клиента, товары и количество. Перед записью покажи, что будет в документе.
Доступность задачи зависит от конфигурации базы и выбранных прав. Для работы с документами нужны права на редактирование.
Часто задаваемые вопросы
Агент пишет ответ, но не обращается к 1С
Проверьте, включено ли подключение MCP в текущем чате и доступны ли инструменты. Попросите явно вызвать инструмент получения списка баз. Текстовое обещание подключиться не означает выполненный вызов.
Нет подключения или доступ запрещён
Нет связи: в UniOneCAI должен быть статус «Работает»; затем проверьте адрес MCP и его доступность со стороны клиента.
Доступ запрещён: проверьте токен или вход OAuth, лицензию и назначенные права. Если инструменты доступны, но не открывается база — вернитесь к «Проверить подключение» на вкладке 1С.
Для точной причины откройте журнал приложения: ошибка связи с MCP и ошибка входа в 1С относятся к разным этапам.