Сценарии транскрибации и AI-анализа
Сценарий хранит модель, настройки, фильтр записей и способ запуска. Сначала создайте сценарии в интерфейсе MindVoice под учётной записью с нужными правами. Через публичный API https://api.mindvoice.pro с API-ключом можно читать, активировать и запускать готовые сценарии, но нельзя создавать или редактировать их: таких методов нет в спецификации.
Сценарий транскрибации
В интерфейсе выберите Workspace, откройте сценарии транскрибации, задайте имя, активную STT-модель из каталога Workspace, язык и другие разрешённые настройки. При необходимости задайте фильтр файлов (file_filter), включите резюме (summary_enabled) и выберите LLM-модель для резюме. Параметры max_attempts (1–10, включая первый вызов) и retry_delay_seconds (1–3600) управляют безопасными автоматическими повторами временных ошибок провайдера. После создания сохраните ID sct-<UUID>; его можно получить через GET /api/v1/workspaces/{workspace_id}/transcription-scenarios с transcripts:read.
В интерфейсе выберите способ запуска: вручную (manual), автоматически (auto) или по расписанию (scheduled). Для расписания задайте частоту, время и часовой пояс. Созданный сценарий интеграция может прочитать через GET /api/v1/workspaces/{workspace_id}/transcription-scenarios/{scenario_id}.
Сценарий AI-анализа
Создайте его в том же Workspace после настройки транскрибации. Выберите LLM-модель, задайте source_filter для готовых транскрипций, инструкции pre_prompt и критерии questions. Каждый критерий содержит непустые key, title, type (boolean, text или list) и prompt. summary_enabled включает общее резюме. Сохраните ID sca-<UUID>; список доступен через GET /api/v1/workspaces/{workspace_id}/analysis-scenarios с analysis:read.
В интерфейсе настройте способ запуска и при необходимости ограничьте источник конкретным STT-сценарием. Анализ выполняется только по готовым транскрипциям. При нескольких текстах записи пакетный запуск берёт последний подходящий текст, поэтому для точной версии в одиночном запуске передавайте transcript_id. Созданный сценарий интеграция может прочитать через GET /api/v1/workspaces/{workspace_id}/analysis-scenarios/{scenario_id}.
Способ запуска
trigger_type | Когда стартует | Что требуется интеграции |
|---|---|---|
manual | По явному запуску | Вызвать одиночный или пакетный endpoint |
auto | Транскрибация — после подготовки нового подходящего аудиофайла; анализ — после появления подходящего текста | Загрузить файл и ждать run/result |
scheduled | По frequency/time/timezone активного сценария | Дождаться ближайшего слота и результата |
Расписание поддерживает hourly, daily и weekly; для еженедельного запуска weekday — 0–6 (понедельник–воскресенье). Неактивный сценарий не запускается автоматически. Для auto и scheduled backend исключает повторные исполнения одного события или слота. Фильтры и доступность обработки Workspace также влияют на запуск. Если ожидаемого запуска нет, проверьте активность сценария, фильтр, готовность записи или текста и доступность обработки Workspace.
Ручной запуск по API-ключу
Для одного файла используйте:
POST /recordings/{recording_id}/transcription-runsс{"transcription_scenario_id":"sct-…"}иtranscripts:write;POST /recordings/{recording_id}/analysis-runsс{"analysis_scenario_id":"sca-…","transcript_id":"<UUID>"}иanalysis:write.
Для набора файлов используйте POST /transcription-scenarios/{scenario_id}/executions или POST /analysis-scenarios/{scenario_id}/executions с recording_ids и необязательным idempotency_key. Без recording_ids применяется сохранённый фильтр. Повтор того же ключа идемпотентности возвращает существующее исполнение. История доступна через GET /…-scenarios/{scenario_id}/executions, а дочерние запуски — через списки runs. Одиночный и пакетный вызовы подробно показаны в руководстве от файла до результата.
POST /transcription-scenarios/{scenario_id}/activation и POST /analysis-scenarios/{scenario_id}/activation с {"active":true} или {"active":false} позволяют включить или выключить готовый сценарий по API-ключу с соответствующим *:write scope. Изменение имени, модели, фильтров и критериев через методы этой спецификации недоступно; меняйте их в интерфейсе MindVoice.