Ai Communicator

Модуль BPM2B Ai Communicator — это слой бизнес-логики AI-операций для платформы BPM2B. Он отвечает за подготовку данных, оркестрацию AI-задач, выполнение инструментов, файловые операции, vector search и режим AI Magic с возможностью отката изменений. Сам модуль провайдеров не реализует — для связи с моделями используется bpm2bAiGateway или удалённый шлюз через HTTP.

Основные функциональные возможности:

• Стейтлесс AI-задачи: в metadata app.aiTasks описывается метод (chat / toolSession / embedding / transcribe), inputTemplate, responseFormat и список инструментов; AiService.executeTask готовит контекст по сущности и запускает выполнение.
• Tool Execution с инструментами: реестр инструментов в app.aiTools, синхронный цикл AI ↔ tools (ToolSessionRunner), асинхронный режим через webhook от Gateway (POST /AiCommunicator/toolCallback/:token) — модель сама дёргает get_entity_metadata, get_formula_functions и т. п.
• AI Magic (Preview → Apply → Revert): сначала POST /AiMagic/execute возвращает diff изменений; затем POST /AiMagic/applyChanges применяет и создаёт AiCorrectionHistory с previousValues; в любой момент POST /AiMagic/revert возвращает значения как было — поддержка linkMultiple и мультиязычных полей (Ru/Kz/En).
• Vector search через pgvector: кастомный тип поля vector (1–16000 dim, HNSW / IVFFlat / none, метрики cosine / l2 / inner); сущность EntityEmbedding хранит вектор + хеш текста; SelectBuilder понимает vectorSimilar, vectorNearest, vectorWithinRadius, vectorTextSearch, similarToEntity.
• Embedding Pipeline: EmbeddingHook на afterSave кладёт сущность в очередь EmbeddingQueueItem; ScheduledJob запускает GenerateEmbedding Job; RetryFailedEmbeddings каждые 5 минут перезапускает падения (max 3 попытки); конфигурация per entity через embeddingConfig.
• Файловые операции: сущность AiFileOperation с типами transcribe / translate / analyze / correct / extractPdf / extractDoc / summarize / tts; стейт-машина pending → processing → completed / failed; конфигурация в app.fileOperations.
• Formula Sandbox: POST /AiFormula/generate (только админ) — 5 режимов (generate / explain / find / pattern / improve); внутри Tool Session с инструментами проверки синтаксиса и выдачи метаданных; полное описание языка Formula Script для AI хранится в app.aiFormulaDescription.
• Async AI-задачи: сущность AiJob для длительных операций (web_search / deep_research / batch); поля responseId и webhookEventId с индексами для матчинга колбэков от провайдера.
• Нечёткий поиск (trigram, Levenshtein): кроме vector-поиска SelectBuilder понимает fuzzyContains, fuzzyWordContains, fuzzyEquals, levenshtein — через расширения PostgreSQL pg_trgm и fuzzystrmatch.
• Fields, panels, formula: кастомные view-поля ai-magic, ai-menu (с голосовым вводом через MediaStreamRecorder + Whisper), vector; side panel ai-correction-history; формула-функции aiConnector\aiTask, aiTaskEntity, aiToolSession.

Модуль предназначен для команд, встраивающих AI глубже, чем «один промпт в чате»: автозаполнение полей с ревертом, поиск по смыслу, безопасная генерация Formula-скриптов, обработка голоса и документов. Зависит от bpm2bApiLog ≥ 1.1.0 и bpm2bCore ≥ 2.1.0; опционально — bpm2bAiGateway (LocalAiClient).