Инструкция по установке

Глоссарий

Сокращения и определения

1. Назначение документа

Документ фиксирует порядок установки программного обеспечения (далее – ПО) «Система на базе ИИ для работы с корпоративными данными с использованием платформы 1С:Предприятие»

2. Поставка программного обеспечения

«Система на базе ИИ для работы с корпоративными данными с использованием платформы 1С:Предприятие» поставляются в виде расширения конфигурации 1С (устанавливаемую на актуальную типовую конфигурацию 1С) и сервера (разработанного на python). Далее будет описан порядок установки расширения, настройки сервера и основные административные функции.

3. Установка расширения «Система на базе ИИ для работы с корпоративными данными с использованием платформы 1С:Предприятие»

Чтобы добавить расширение, запустите базу 1С в режиме 1С Конфигуратор. Откройте дерево конфигурации по кнопке «Открыть конфигурацию».

Закрыть ×

Далее перейдите на вкладку «Конфигурация», выберите пункт «Расширения конфигурации».

Закрыть ×

В форме «Расширения конфигурации» добавьте пустое расширение по кнопке «Добавить».

Закрыть ×

Нажмите на созданное расширение правой кнопкой мыши.

В открывшемся окне выберите «Конфигурация» и «Загрузить конфигурацию из файла».

Закрыть ×

Выберите расширение «Система на базе ИИ для работы с корпоративными данными с использованием платформы 1С:Предприятие».

Закрыть ×

В открывшемся окне нажмите «Да».

Закрыть ×

Подтвердите выбранное действие (нажмите «Да»).

Закрыть ×

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

Если при запуске 1С возникли проблемы необходимо обратиться в 1С ПРО Консалтинг.

4. Настройка клиента 1С ИИ

Зайдите в раздел ИИ:

Закрыть ×

1. Установите Program uid (ИИ) – настройка отвечает за routing и идентификацию клиента для сервера «Система на базе ИИ для работы с корпоративными данными с использованием платформы 1С:Предприятие». Заполняем любой, не используемый ранее UID.

2. Адрес сервера (ИИ) – реквизит отвечает за адрес обращения к серверу «Система на базе ИИ для работы с корпоративными данными с использованием платформы 1С:Предприятие» (например, http://10.254.172.13:8000). Порт 8000 — это стандартный порт для FastAPI.

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

4. Логирования сообщений включает фиксацию сообщений обмена в журнале регистрации 1С

Закрыть ×

5. Типы и алгоритмы сообщений ИИ. Нажмите «Создать, заполнить по умолчанию». После этого обновите страницу. В столбце «Адрес сервиса» должны появиться пути FastAPI к соответствующим алгоритмам.

6. Перезапустите 1С, чтобы сбросить кэш.

5. Настройка обработки файлов в 1С

Закрыть ×

1. В разделе ПО в меню «Дополнительные темы» создайте новую тему с названием проекта

• Установите флаг «Доступ», чтобы тема отображалась в интерфейсе;
• Выберите ответственного за раздел (РП);
• Проверьте, что автоматически сгенерирован пользователь и уникальный идентификатор;
• Перейдите в раздел «Пользователи» и убедитесь, что появился пользователь с именем, совпадающим с названием темы;
• Этот пользователь будет использоваться на сервере, где под его именем создаётся папка с базой ChromaDB и загруженными файлами.

2. Перейдите в регистр сведений «Обрабатываемые объекты ИИ» и заполните его:

• Укажите проект и список типов объектов, которые ИИ должен уметь обрабатывать (например, регламенты, техпроекты и т.д.). В этих объектах при обновлении файлов будет автоматически происходить переобучение

Закрыть ×

6. Установка сервера

1. Создайте рабочую папку (рекомендуется выполнять на сервере Ubuntu 22.04)

2. Разместите файлы сервера (передается при приобретении ПО)

3. Установите необходимые зависимости

camelot-py>=0.10.1
python-docx>=0.8.11
PyMuPDF>=1.22.3
langchain>=0.3.20
langchain-chroma>=0.1.2
langchain-community>=0.3.19
langchain-huggingface>=0.1.2
langchain-ollama>=0.1.0
pandas>=1.5.3
pyTelegramBotAPI>=4.12.0
sentence-transformers>=2.2.2
configparser>=5.3.0
telebot>=0.0.4
pypdf>=3.9.1
docx2txt>=0.8
unstructured>=0.6.7
config>=0.5.1
pi-heif>=0.21.0
unstructured_inference>=0.8.9
pdf2image>=1.17.0
pytesseract>=0.3.13
unstructured_pytesseract>=0.3.15
python-pptx
tabulate

4. Заполнить актуальными значениями файлов настройки

APP_NAME=LLM API
DEBUG=True
VERSION=0.0.1
DESCRIPTION=API for LLM
USE_DB=False
DATABASE_URL=sqlite:///./app/main_api.db
SECRET_KEY=
ACCESS_TOKEN_EXPIRE_MINUTES=30
GIGACHAT_TOKEN=""
ALLOWED_ORIGINS=["*"]
ALLOW_METHODS=["*"]
ALLOW_HEADERS=["*"]
ALLOW_CREDENTIALS=True
API_V1_STR=/api/v1
URL_1C_ROOT=http://0.0.0.0:8080
URL_TELEBOT_ROOT=http://0.0.0.0:8080
UID_PROGRAM_1C=6a09f20a-8de6-11e1-b3e1-001617ec3f2a
UID_PROGRAM_TELEBOT=e23429d1-c015-4d4b-8ab5-3f0689ef9805
CONNECTION_FILE_PATH=app/utils/clients.json
MAIN_FOLDER_PATH= указать путь к папке, где будут располагаться файлы пользователей
LOGS_FOLDER_PATH= указать путь к папке, где будут располагаться файлы логов

TASK_FOR_TEST=
CLASS_NAME_SEPARATE_FILE=sf_DataProcessing_keywords_512_chunk_and_Tables
CLASS_NAME_EMBEDDINGS=e_multilingual_e5_large
CLASS_NAME_PUT_VECTOR_IN_DB=pvid_default
CLASS_NAME_GET_VECTOR_DB=gvid_multilingual_e5_large
CLASS_NAME_SEARCH=s_k_five
CLASS_NAME_SEARCH_SEARCH=s_k_150
CLASS_NAME_PROMT=promt_instr
MODEL=gemma3:12b – имя модели ollama
URL_LLM=http://188.225.36.45 – сервер, если ollama распложена на другом сервере
USER_LLM=ollamaadmin – пользователь, если ollama распложена на другом сервере
PASSWORD_LLM= пароль, если ollama распложена на другом сервере

5. Зайти в папку pro_club/python/webAPI

6. Запустите скрипт python/webAPI/app/init_db.py для инициализации базы данных

7. Запустить uvicorn app.main:app --host 0.0.0.0 для запуска web-сервера

7. Добавление пользователя 1С на сервер

1. На сервере (например, http://10.254.172.13) запустить браузер, FastAPI Swagger (обычно IP:порт/docs) http://127.0.0.1:8000/docs

2. Перейдите в раздел /api/v1/stings/connection_settings

3. Нажмите кнопку “Try it out” и вставьте запрос (например)

{
"program uid": "7a09f20a-8de6-11e1-b3e1-001617ec3f2a",
"name": "OneC",
"clienttype": "OneC",
"description": "",
"url": "http://10.254.172.18:446/1C_MODELING/hs/proai",
"client_login": "Baran08A", // Имя пользователя
"client_pass": "ПАРОЛЬ", // Пароль пользователя
"endpoint": "response",
"code_uid": {
"username": "dakinfilev",
"program_uid": "e23429d1-c015-4d4b-8ab5-3f0689ef9805",
"request_uid": "0000000000"
},
"request": ""
}

• program uid – тот что мы ранее заполнили в СППР
• url – адрес веб-публикации 1С:СППР
• client_login – имя пользователя для доступа в 1С:СППР
• client_pass

4. Нажмите кнопку "Execute".

5. Убедитесь, что получен ответ 200 OK — это означает успешное подключение.

6. Проверьте работоспособность системы в интерфейсе ПО, например, через мессенджер в 1С: задать свободный вопрос