AI Expert

Подключить базу 1С

Обработка, агент и первая проверка связи. Около 20 минут, программист не нужен.

Подключение делает тот, кто отвечает за 1С в компании. Понадобится доступ к компьютеру или серверу, где запускается 1С, и права администратора в базе.

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

  • Платформа 1С:Предприятие 8.3 или 8.5.
  • Кабинет AI Expert — зарегистрируйтесь, это бесплатно.
  • Компьютер или сервер с 1С, где будет работать агент: Windows 10, Windows Server 2016 или новее, 64 бит. Права администратора на нём — для установки.

Шаг 1. Добавьте базу в кабинете

  1. Откройте раздел Базы 1С и нажмите Добавить базу.
  2. Укажите название и короткий псевдоним латиницей, например ut или buh. По псевдониму нейросеть отличает базы друг от друга.
  3. В поле «Назначение» опишите базу одной фразой: «Оптовые продажи и склад, данные с 2019 года». Нейросеть читает это описание.

Этот шаг можно пропустить: агент заведёт базу сам, когда вы добавите её в его окне.

Шаг 2. Установите агент

Агент — программа, которая соединяет 1С с облаком AI Expert. Соединение исходящее, открывать порты на сервере не нужно.

  1. Скачайте со страницы базы в кабинете установщик агента для Windows — AIExpertAgentSetup.exe — и запустите его на компьютере с 1С.
  2. Мастер ставит агент в C:\Program Files\AI Expert\Agent (папку можно выбрать другую), кладёт рядом обработку AiExpertHub.epf и создаёт службу AIExpertAgent. Служба работает без входа в Windows, стартует вместе с компьютером и перезапускается сама.
  3. Шаг «Запуск 1С без входа в Windows» можно пропустить — о нём отдельная статья.
  4. В конце откроется окно агента. Нажмите «Войти в кабинет» и подтвердите вход: настройки баз хранятся в кабинете, агент берёт их оттуда.

Windows может предупредить о неподписанной программе: «Подробнее» → «Выполнить в любом случае». Если файл удалил Защитник — см. Если не работает.

Окно агента можно закрывать: запросы обслуживает служба. Снова открыть окно — ярлык «AI Expert - агент 1С» в меню «Пуск». Другим пользователям Windows окно покажет «Нет доступа к настройкам агента» и кнопку «Дать доступ этому пользователю» — она попросит пароль администратора.

Шаг 3. Запустите обработку

  1. Откройте базу в 1С и выберите Файл → Открыть, затем AiExpertHub.epf. Путь к обработке показан в окне агента, в блоке «Обработка для 1С».
  2. Выберите режим «Встроенный сервер» и нажмите «Запустить сервер».

Порт по умолчанию 7001; если он занят, обработка сама возьмёт следующий свободный. Ни адрес, ни токен указывать не нужно: сервер слушает только этот компьютер, а обработка отвечает только агенту.

Шаг 4. Добавьте базу в окне агента

  1. Нажмите «Добавить базу» и заполните:
    • Обработка 1С на этом компьютере — агент сам находит запущенные обработки и показывает их с конфигурацией и именем базы. Выберите нужную; адрес и порт подставятся сами.
    • Название — как база будет называться в кабинете и в журнале.
    • База в кабинете — выберите из списка или оставьте «новая база».
    • Пользователь и пароль 1С — не обязательно. С ними кнопка «Открыть 1С» сама запустит базу вместе с сервером обработки.
  2. Нажмите «Сохранить», затем «Проверить». Отметки должны стать зелёными: 1С отвечает, обработка ждёт только агента, облако подключение приняло. Если нет — агент напишет, что не так; подробнее в статье Если не работает.

Чтобы 1С работала круглосуточно и сама поднималась после перезагрузки сервера, включите у базы «Держать 1С запущенной» — см. 1С без входа в Windows.

Шаг 5. Проверьте в кабинете

На странице базы экземпляр должен показывать «на связи, агент», а в колонке «Компьютер» — имя вашего сервера. После первого вопроса кабинет сам определит конфигурацию базы.

Несколько баз 1С

Один агент обслуживает сколько угодно баз — ставить его второй раз не нужно. Откройте обработку во второй базе и запустите её сервер: если порт 7001 занят первой базой, обработка возьмёт 7002. Затем в окне агента снова нажмите «Добавить базу».

Базы работают независимо: если одну 1С закрыли, вторая продолжает отвечать. Нейросеть различает базы по псевдониму из шага 1 — спросите её «какие базы доступны», и она перечислит подключённые.

Обновление и удаление

Обновление — скачайте новый установщик и запустите поверх: службу и окно он закроет сам, вход в кабинет и базы сохранятся. Агент прежней версии без установщика (aiexpert-agent-windows-amd64.exe) установщик тоже обновит: настройки службы перенесутся сами, а если службы не было — войдите в кабинет заново.

Удаление — «Параметры» → «Приложения» → «AI Expert - агент 1С». В конце мастер спросит, удалить ли настройки агента с компьютера.

Linux и проверка без установки

Для Linux и для проверки на Windows без установки на странице базы есть агент без установки — одна программа без мастера. В Windows она не создаёт службу: пока она открыта, запросы обслуживает её окно. Для постоянной работы в Windows ставьте агент установщиком.

Режим «Прокси» — если ставить программы нельзя

Если на компьютер с 1С нельзя поставить агент, в обработке выберите режим «Прокси» и укажите адрес сервера:

https://mcp.aiexpert.aleksdev.ru/c/<токен экземпляра>

Режим работает без агента, но у него два ограничения: интерфейс 1С на мгновение подвисает при каждом опросе, а анонимизация данных не действует. Поэтому для постоянной работы лучше встроенный сервер с агентом.

Что дальше

Подключить базу 1С — AI Expert