Конфигурация AI инструментов
===============================

Раздел описывает AI-инструменты платформы Citeck: настраиваемых агентов на базе LLM, микросервис транскрипции и модуль записи совещаний.

:ref:`Пользовательские AI-агенты <user-agents>` — конфигурируемые сущности с системным промптом, набором инструментов и выбранным :ref:`LLM-провайдером <AI_assistant_config>`. Агенты работают в двух режимах: stateless (однократный вызов из :ref:`BPMN-процессов <process_bpmn>`) и stateful (многоходовой диалог в :ref:`AI Assistant UI <AI_assistant>`). Администратор создаёт агентов через **Admin > AI Agents**, разработчик подключает собственные инструменты, реализуя интерфейс ``CiteckAiTool``.

:ref:`Микросервис транскрипции аудио и диаризации <citeck-stt-sidecar>` —  работающий как sidecar к сервису ``citeck-ai``. Принимает аудиофайл (WebM, WAV), конвертирует его в WAV 16 кГц через ``ffmpeg``, транскрибирует чанками по 25 секунд с помощью модели **GigaAM-v3** и при наличии токена HuggingFace определяет говорящих через **pyannote.audio**. Доступен по порту ``8090``.

:ref:`Модуль записи совещаний <call-recording-module>` захватывает аудио из браузерной вкладки и микрофона через :ref:`Chrome-расширение <citeck_browser_plugin>`, передаёт поток по WebSocket, транскрибирует его с помощью :ref:`citeck-stt-sidecar <citeck-stt-sidecar>` и автоматически формирует резюме через LLM. Результат сохраняется как ECOS-активность типа ``meeting-activity`` или ``call-activity``. Модуль доступен начиная с версии **1.11.0**.

.. toctree::
    :maxdepth: 2
    :hidden:

    AI_instruments/user_agents
    AI_instruments/citeck-stt-sidecar
    AI_instruments/call-recording-module