Модуль записи совещаний (callrecording)
Модуль callrecording захватывает аудио из браузерной вкладки и микрофона через Chrome-расширение, передаёт его фрагментами через REST API, транскрибирует через GigaAM и генерирует резюме через LLM. Результат сохраняется как Citeck-активность типа meeting-activity или call-activity.
Статья описывает архитектуру модуля, REST API, конфигурацию, артефакты и ключевые файлы. Функциональность доступна начиная с версии 1.11.0 (30 апреля 2026). Начиная с версии 1.12.0 (3 июня 2026) аудио передаётся по REST вместо WebSocket — отдельная WebSocket-инфраструктура и аутентификация по wsToken больше не используются.
Принцип работы
Расширение решает сквозную задачу: от момента обнаружения активного звонка до появления структурированной записи встречи в CRM/проекте — без ручного участия пользователя в процессе обработки.
Обнаружение звонка
content/call-detector.js следит за открытыми вкладками Chrome. Как только пользователь переходит на страницу Yandex Telemost, скрипт отправляет событие call-detected в Service Worker. Пользователю достаточно открыть вкладку встречи — ничего запускать вручную не нужно.
Захват и передача аудио
Service Worker создаёт скрытое окно-рекордер (recorder/recorder.js), которое работает параллельно со встречей:
Захват голосов участников — через
tabCapture.getMediaStreamIdполучает аудиопоток вкладки Telemost (то, что слышит пользователь).Захват микрофона — через
getUserMedia({audio: true})захватывает локальный микрофон пользователя.tabCaptureсам по себе микрофон не включает, поэтому используется отдельный поток.Микширование — оба потока объединяются в
AudioContextчерезGainNode, образуя единый аудиовыход.Кодирование —
MediaRecorderпишет сжатый поток в форматaudio/webm;codecs=opusфрагментами по 30 секунд, что позволяет начинать передачу немедленно, не дожидаясь конца встречи.Передача — каждый фрагмент аудио отправляется POST-запросом на
/api/call-recording/session/{id}/chunksс теломapplication/octet-streamи заголовкамиX-Upload-Token(токен сессии) иX-Chunk-Sequence(порядковый номер фрагмента). При сетевых ошибках и ответах 5xx расширение повторяет отправку с экспоненциально растущей задержкой (от 1 до 30 секунд) в пределах 5 минут; ответ 4xx считается неисправимой ошибкой, и запись останавливается.
Состояние записи зеркалируется в chrome.storage.session, чтобы не потерять контекст при выгрузке MV3 Service Worker после ~30 сек неактивности.
Транскрипция и генерация резюме
Фрагменты аудио поступают в бэкенд citeck-ai по REST через стандартный gateway (пути вида /gateway/ai/api/call-recording/…) — отдельный WebSocket-прокси не требуется. Бэкенд запускает pipeline:
STT — Микросервис для транскрипции аудио и диаризации транскрибирует аудио с помощью GigaAM (распознавание речи на русском языке).
LLM summary — на основе транскрипта языковая модель формирует структурированное резюме встречи.
После выгрузки последнего фрагмента расширение завершает сессию запросом POST /session/{id}/end, что запускает пост-обработку. Если расширение не смогло завершить сессию явно (окно рекордера закрыто, сбой браузера), бэкенд автоматически завершает сессию, не получавшую фрагментов дольше 5 минут. Пока идёт обработка, Service Worker каждые 3 секунды опрашивает /session/{id}/status (до 15 минут) и записывает результат в chrome.storage.local.
Сохранение в Citeck
Результат — транскрипт и резюме — сохраняется как объект meeting-activity в платформе Citeck и автоматически привязывается к нужной сущности (сделке или проекту). Пользователь выбирает сущность в popup-интерфейсе расширения через combobox с поиском ещё до начала записи.
Уведомление пользователя
Когда обработка завершена, Service Worker отправляет Chrome Notification. Popup расширения может быть закрыт к этому моменту — уведомление гарантирует, что пользователь узнает о готовности результата вне зависимости от состояния UI.
Архитектура
Chrome Extension (захват аудио)
→ POST /api/call-recording/session/start
→ POST /api/call-recording/session/{id}/chunks (фрагменты аудио)
→ POST /api/call-recording/session/{id}/end
→ CallRecordingController
→ CallRecordingService
→ GigaAmSttProvider (транскрибация)
→ CallSummaryService (LLM-резюме)
→ CallActivityService (сохранение в Citeck)
Зависимости (внешние сервисы)
citeck-ai — REST API + pipeline: STT → LLM summary → сохранение активности
citeck-stt-sidecar — сервис транскрипции на базе GigaAM
REST API
Метод |
URL |
Описание |
|---|---|---|
|
|
Платформы, типы записей, STT-провайдер (Speech-to-Text — сервис распознавания речи, преобразующий аудио в текст) |
|
|
Поиск записей по типу |
|
|
Старт сессии — возвращает |
|
|
Загрузка фрагмента аудио (тело |
|
|
Завершение сессии и пост-обработка |
|
|
Статус сессии |
Загрузка фрагментов аудио
Жизненный цикл сессии записи:
POST /session/startсоздаёт сессию и возвращаетsessionIdиuploadToken— токен, который выдаётся на одну сессию записи и авторизует загрузку аудио именно в эту сессию.Каждый фрагмент аудио отправляется отдельным запросом
POST /session/{id}/chunksс бинарным телом (application/octet-stream) и двумя заголовками:X-Upload-Token— токен, полученный при старте сессии, иX-Chunk-Sequence— порядковый номер фрагмента (целое число). Повторная загрузка фрагмента с тем же номером идемпотентна: дубликат подтверждается ответом 200, но не сохраняется второй раз, поэтому клиент может безопасно повторять запрос после потерянного ответа.POST /session/{id}/endзавершает сессию и запускает пост-обработку (транскрипция, резюме, сохранение активности), прогресс которой отслеживается черезGET /session/{id}/status.
Коды ответов /session/{id}/chunks: 400 — некорректный заголовок X-Chunk-Sequence; 403 — неверный X-Upload-Token; 404 — сессия не существует или принадлежит другому пользователю; 409 — сессия уже не находится в состоянии записи; 413 — фрагмент превышает лимит размера (свойство citeck.ai.call-recording.session.max-chunk-size-bytes, по умолчанию 5 МБ).
Конфигурация
Настройки задаются в application.yml:
citeck.ai.call-recording:
enabled: true
stt:
provider: gigaam
sidecar-url: http://localhost:8090
language: ru
enable-diarization: false
session:
# Предел применяется: сессия, превысившая его, завершается так же, как по команде
# завершения, а фрагмент, пришедший после этого, получает ошибку 408
max-duration-minutes: 180
chunk-size-seconds: 30
summary:
model: ${citeck.ai.base.model}
temperature: 0.3
Через интерфейс
В рабочем пространстве администратора в разделе AI перейдите в журнал Запись звонков.
Журнал доступен по адресу: v2/journals?journalId=call-recording-config-journal&viewMode=table&ws=admin$workspace
Заполните Название.
Выберите Типы данных для привязки.
Укажите STT-провайдер по умолчанию для платформы (например, GigaAM для Telemost).
Сохраните.
Citeck-артефакты
Модуль работает с аспектом recording-aspect (атрибуты recording — аудиофайл, transcription, transcriptionDiarized, summary, recordingDuration, recordingStatus, callPlatform, meetingUrl), подключённым к типам meeting-activity и call-activity.
Примечание
Сам аспект и его подключение к типам активностей поставляются сервисом ``ecos-model``, а не citeck-ai. Раньше аспект и два патча артефактов шли в составе citeck-ai; при обновлении ранее поставленные записи патчей выключаются разово и автоматически, вмешательство администратора не требуется.
Путь |
Назначение |
|---|---|
|
Аспект с атрибутами записи |
|
Подключение аспекта к |
|
Подключение аспекта к |
|
Форма с полями аудио, резюме, расшифровки |
|
Действие привязки встречи к сделке или проекту |
|
Тип конфигурации записи (типы, платформы, STT-провайдер) |
|
Форма администрирования конфигурации |
|
Журнал конфигураций |
|
Дашборд встречи |
LLM-промпт
src/main/resources/prompts/call_summary_prompt.xml — инструкция для генерации резюме на русском языке. Промпт формирует адаптивный по длине текст с разделами: ключевые темы, решения, задачи, открытые вопросы, участники.
Безопасность и хранение сессий
Все эндпоинты
/api/call-recording/*требуют доступности AI-функций: лицензия с признакомaiи членство в группеai-feature-allowed(подробнее).Сессию записи можно запустить только от собственного имени; целевая запись (
targetRecordRef) должна быть доступна пользователю на чтение — иначе запуск отклоняется.Завершённые сессии (успешные и ошибочные) хранятся в памяти сервиса 60 минут и затем удаляются. Срок настраивается свойством
citeck.ai.call-recording.session.terminal-session-retention-minutes.
Тесты
Файл |
|---|
|
|
|
|
|
|
|
Ключевые файлы
Компонент |
Файл |
|---|---|
Оркестрация сессий |
|
Хранилище сессий |
|
REST-контроллер |
|
STT через GigaAM |
|
LLM-резюме |
|
Загрузка в Citeck |
|
Перехват Telemost-URL |
|
Конфигурационные свойства |
|
DTO и статусы |
|
Все пути относительно src/main/java/ru/citeck/ecos/ai/.