Add AI Functions chapter

ai_functions/ai_ocr.rst

+Распознавание текста (OCR)
+===========================
+
+Функция распознавания текста (OCR) позволяет автоматически извлекать
+текст из файлов и бинарного содержимого документов
+в рамках бизнес-процесса на платформе Synergy.
+
+Функция реализована на уровне маршрута реестра
+и выполняется как отдельный этап маршрута.
+
+
+Назначение функции
+------------------
+
+Распознавание текста используется в случаях,
+когда в процессе обработки документа требуется:
+
+* извлечь текст из загруженного файла (сканированного документа, изображения);
+* автоматически заполнить текстовое поле формы на основе содержимого файла;
+* исключить ручной ввод данных, уже присутствующих в документе.
+
+Функция работает без участия пользователя:
+после запуска маршрута система самостоятельно обрабатывает файл
+и помещает распознанный текст в указанное поле.
+
+
+Техническая реализация
+----------------------
+
+Для обработки файлов используется self-hosted модель,
+работающая на CPU.
+
+Ключевые характеристики:
+
+* модель размещена в Docker-контейнере на отдельном хосте;
+* при наличии GPU модель автоматически использует его
+  для ускорения обработки;
+* время обработки зависит от размера файла и объёма бинарного содержимого;
+* использование мощных LLM не требуется.
+
+В качестве альтернативы возможно подключение сторонних решений,
+включая модели OpenAI.
+
+
+Настройка модели ИИ
+-------------------
+
+Перед использованием функции необходимо выполнить настройку
+в разделе администрирования системы.
+
+Для этого:
+
+1. Перейдите в раздел **Администрирование**.
+2. Откройте **Настройки системы**.
+3. Перейдите в подраздел **Настройки ИИ**.
+4. Нажмите **«Добавить функцию ИИ»**
+5. Укажите **Тип функции** и **Адрес хоста**.
+6. Опционально укажите **Модель ИИ** и **API ключ** 
+7. Сохраните настройки.
+
+
+.. figure:: ../images/ai_settings.png
+
+   Настройка ИИ функций
+
+.. note::
+   В разделе **Настройки ИИ** можно настроить несколько различных моделей.
+   Это позволяет использовать разные модели для разных задач.
+
+
+
+Подготовка формы
+----------------
+
+Для работы функции OCR форма реестра должна содержать хотя бы два поля:
+
+* **Поле файла** - поле, в которое пользователь загружает документ
+  для распознавания;
+* **Поле текста** - поле, в которое система запишет распознанный текст.
+
+
+
+Настройка этапа маршрута
+------------------------
+
+Функция OCR подключается на уровне этапа маршрута реестра.
+
+Для настройки этапа:
+
+1. Откройте маршрут реестра в Synergy IDE.
+2. Добавьте новый этап или выберите существующий.
+3. В настройках этапа в разделе **Тип действия**
+   выберите **«Функция искусственного интеллекта»**.
+4. В поле **«Тип функции ИИ»** выберите **«Распознавание текста»**.
+5. В **«Поле-источник данных»** укажите **поле файла** - источник содержимого для распознавания.
+6. В **«Поле-приемник данных»** укажите **поле текста** - поле, в которое будет записан результат.
+7. Сохраните настройки этапа.
+
+.. figure:: ../images/ai_ocr_stage.png
+
+   Настройка этапа распознавания текста в маршруте
+
+
+Использование функции
+---------------------
+
+После настройки маршрута и этапа OCR работа с функцией
+выполняется в следующем порядке:
+
+1. Откройте запись в реестре.
+2. Загрузите файл в поле файла формы.
+3. Запустите маршрут.
+4. Дождитесь завершения этапа распознавания текста.
+5. Откройте запись - распознанный текст будет отображён
+   в текстовом поле формы.
+
+.. note::
+   Время ожидания на этапе распознавания зависит от размера файла.
+   Для больших документов обработка может занять больше времени.
+
+
+Поведение системы
+-----------------
+
+При выполнении этапа распознавания текста:
+
+* система автоматически извлекает текст из указанного файла;
+* распознанный текст записывается в поле текста документа;
+* пользователю не требуется выполнять дополнительных действий;
+* после завершения этапа маршрут продолжается в соответствии
+  с настроенной логикой.

ai_functions/index.rst

+Функции искусственного интеллекта
+======================================
+
+.. toctree::
+   :maxdepth: 2
+
+   ai_ocr
+   
\ No newline at end of file

index.rst

@@ -18,4 +18,5 @@
    signing
    conditional_transitions
    route_template
+   ai_functions/index
    
\ No newline at end of file