Документация ИИ Ассистента для 1С
1. Назначение
ИИ Ассистент — это надстройка над GigaChat, которая:
EPUB );Он действует как «внутренний ИИ», обученный на твоих данных.
Технологии:
2. Архитектура
2.1 Компоненты системы
| Компонент | Назначение | Пример |
|---|---|---|
| ИИ_ОбщиеМодули | Служебные функции: JSON , кодировки, конвертации. |
Преобразует вектор в строку JSON для записи в регистр. |
| ИИ_GigaChat | Работа с API GigaChat ( chat/completions , embeddings ). |
Вызывает GigaChat-Max или Embeddings , получает токен. |
| ИИ_RAG | Поиск фрагментов по косинусному сходству . |
Находит 5 наиболее релевантных страниц книги. |
| ИИ_АссистентОбщий | Основная логика диалога с ИИ. | Обрабатывает вопрос пользователя, вызывает ChatCompletion . |
| ИИ_Ассистент (обработка) | Визуальный интерфейс (форма). | Поле для вопроса, область с HTML -ответом. |
3. Процесс работы (пошагово)
Шаг 1: Импорт книги
.epub загружается пользователем через форму. СобратьСтраницыEPUB() : {chapter, page, text, images} .Аналогия:
«ИИ читает книгу постранично, вычленяя из HTML только слова и картинки.»
Шаг 2: Индексация
ИИ_GigaChat.Embedding(Текст) → получается вектор (список чисел). ИИ_КнигаФрагменты . ИИ_КнигаИзображения .Пример записи в регистр:
| Источник | Страница | Текст | ВекторJSON |
|---|---|---|---|
| EPUB:Блок1 | 5 | «Машинное обучение — это...» | [0.12, 0.45, -0.31, ...] |
Шаг 3: Поиск (RAG)
Когда пользователь задаёт вопрос:
Embedding . НайтиТопK ищет 5 ближайших фрагментов по косинусному сходству:Score = Сумма(A[i]*B[i]) / (Sqrt(ΣA²) * Sqrt(ΣB²)) Score .Аналогия:
ИИ находит «похожие» страницы книги, где уже есть ответ.
Шаг 4: Генерация ответа
СпроситьПоКниге(Вопрос) :Вопрос: Как пробить чек возврата? Контекст: [1] В разделе «Возврат продажи» выберите режим «Возврат по чеку»... [2] Без чека — откройте форму «Возврат продажи» вручную... GigaChat.ChatCompletion . GigaChat-Max ) выдаёт осмысленный ответ с цитатами.Шаг 5: Формирование HTML-ответа
Функция ПостроитьHTMLОтвет_Строкой делает визуальный вывод:
Markdown → HTML ). <img src="image/..."> .Пример вывода в форме:
Ответ:
Чтобы оформить возврат по чеку в УНФ:
Источники:
4. Визуально это выглядит так:
"Как оформить возврат по чеку?"
Текст + цитаты + картинки (если были в книге).
Технические требования
Работоспособность расширения гарантируется на:
- 1С:УНФ 3.0.12.170
Внимание! Расширение не работает на БАЗОВЫХ конфигурациях (в базовых конфигурациях 1С, возможности подключения расширений - отсутствуют)!
Код открыт.
Остались вопросы?
Для получения дополнительной информации и помощи в настройке модуля под нужды вашего бизнеса — оставьте заявку
Проверено на следующих конфигурациях и релизах:
- Управление нашей фирмой, редакция 3.0, релизы 3.0.12.170
