Экспорт

Операции MCP и CLI для экспорта: места и правила автоэкспорта, предпросмотр, очередь, запуск, отмена и повтор, разрешение конфликтов.

Операции экспорта отправляют содержимое сессий (итоги, транскрипт, заметки, задачи, закладки и аудио) в файлы, хранилище Obsidian или Notion. Все они по умолчанию включены в разделе «Доступ по MCP». Каждая операция также принимает необязательный workspaceId. Общие правила описаны в разделе Как читать этот справочник.

ОперацияТипИнструментПо умолчаниюГруппа
exports.configЧтениеtalkbar_readВкл.exports
exports.sessionsЧтениеtalkbar_readВкл.exports
exports.previewЧтениеtalkbar_readВкл.content
exports.enqueueИзменениеtalkbar_changeВкл.exports
exports.runИзменениеtalkbar_changeВкл.exports
exports.statusЧтениеtalkbar_readВкл.exports
exports.runsЧтениеtalkbar_readВкл.exports
exports.historyЧтениеtalkbar_readВкл.exports
exports.cancelИзменениеtalkbar_changeВкл.exports
exports.retryИзменениеtalkbar_changeВкл.exports
exports.resolveИзменениеtalkbar_changeВкл.exports
exports.destination.saveИзменениеtalkbar_changeВкл.exports
exports.destination.deleteИзменениеtalkbar_deleteВкл.exports
exports.rule.saveИзменениеtalkbar_changeВкл.exports
exports.rule.deleteИзменениеtalkbar_deleteВкл.exports

Как выполняется экспорт

  1. Настройте место экспорта через exports.destination.save (или в приложении).
  2. Проверьте, что будет записано, через exports.preview.
  3. Поставьте пакет в очередь через exports.enqueue, затем вызывайте exports.run, пока не останется отправок со статусом scheduled. Ход выполнения можно проверить через exports.status.
  4. Если отправка требует внимания, потому что место экспорта было изменено вне TalkBar, разрешите конфликт через exports.resolve или попробуйте ещё раз через exports.retry.

Отправка может иметь статус scheduled, waitingForSummary, waitingForAudio, exporting, exported, partiallyExported, needsAttention или cancelled; статус пакета определяется статусами его отправок.

exports.config

Читает места экспорта и правила автоэкспорта рабочего пространства.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы: только workspaceId.

Возвращает: {destinations, rules}. У мест экспорта есть destinationId, name, format, location, enabled, layout и credentialRef; у правил — те же поля, что принимает exports.rule.save.

{"tool": "exports.config", "args": {}}

exports.sessions

Постранично выводит идентификаторы сессий, которые можно экспортировать (завершённых и не находящихся в корзине), при необходимости — в пределах проекта или серии.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

projectId
string

Только сессии этого проекта.

seriesId
string

Только сессии этой серии.

after
string

Последний идентификатор сессии из предыдущей страницы.

limit
integer

Сколько вернуть: от 1 до 100. По умолчанию 100.

Возвращает: массив идентификаторов сессий, упорядоченный по идентификатору. Чтобы получить следующую страницу, передайте последний из них в after; пустой массив означает конец списка.

exports.preview

Показывает, что войдёт в экспорт и готова ли каждая сессия, ничего не экспортируя.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content

Аргументы

sessionIdsrequired
string[]

Сессии для экспорта, от 1 до 100.

destinationIdsrequired
string[]

Места экспорта для предпросмотра, от 1 до 10. Каждое должно существовать и быть включено.

selection
object

Что взять из каждой сессии. Неизвестные ключи отклоняются.

  • summary (по умолчанию true), transcript (по умолчанию true), metadata (по умолчанию true), notes, outcomes (задачи), markers (у каждого по умолчанию false).
  • audio: none (по умолчанию), original, mp4, mp3 или wav.
  • summarySectionKeys: только эти разделы итогов. Пустое значение означает итоги целиком.
  • turnIds: только эти реплики транскрипта (до 10 000).
  • ranges: только реплики транскрипта внутри этих интервалов времени, [{startMs, endMs}] в мс от начала сессии (до 100).

Возвращает: {sessions, destinations, outputs}. Для каждой сессии показаны выбранное содержимое, ready и, если сессия не готова, waitReason (sessionNotFinished, summaryMissing, summaryStale или audioPending). Для каждого результата указаны location, files и archiveEntries, которые будут записаны.

  • Возвращает текст выбранных итогов и транскрипта, поэтому относится к группе политики content.
{"tool": "exports.preview", "args": {"sessionIds": ["ses_123"], "destinationIds": ["dest_vault"], "selection": {"summary": true, "transcript": false, "outcomes": true}}}

exports.enqueue

Ставит сессии в очередь на экспорт в одно или несколько мест одним пакетом.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

sessionIdsrequired
string[]

Сессии для экспорта, от 1 до 100.

destinationIdsrequired
string[]

Места экспорта, от 1 до 10. Каждое должно существовать и быть включено.

selection
object

Что взять из сессий, как в exports.preview.

Возвращает: пакет: {batchId, workspaceId, status, automatic, createdAtMs, deliveries}. У каждой отправки есть deliveryId, sessionId, sessionTitle, destinationId, status, location, error, conflict и updatedAtMs.

  • Сессия, запись которой ещё идёт, отклоняется с кодом session_recording: поставьте её в очередь после остановки записи.
  • Постановка в очередь сама по себе ничего не отправляет. Запустите пакет через exports.run или отмените через exports.cancel.
{"tool": "exports.enqueue", "args": {"sessionIds": ["ses_123", "ses_124"], "destinationIds": ["dest_vault"]}}

exports.run

Сразу выполняет небольшую часть одного пакета: каждый вызов отправляет не больше одной сессии в одно место экспорта. Фоновый обработчик операция никогда не запускает.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

batchIdrequired
string

Пакет экспорта из exports.enqueue или exports.history.

Возвращает: пакет после запуска ({batchId, workspaceId, status, automatic, createdAtMs, deliveries}. У каждой отправки есть deliveryId, sessionId, sessionTitle, destinationId, status, location, error, conflict и updatedAtMs).

  • Вызывайте операцию снова, пока в пакете есть отправки в статусе scheduled.
  • Одновременно выполняется только один экспорт: на второй вызов во время выполнения приходит ответ busy с retryAfterMs: 5000.
  • Записывает файлы или страницы Notion в место экспорта.
{"tool": "exports.run", "args": {"batchId": "batch_5"}}

exports.status

Читает статус отправок одного пакета экспорта.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

batchIdrequired
string

Пакет экспорта из exports.enqueue или exports.history.

Возвращает: пакет: {batchId, workspaceId, status, automatic, createdAtMs, deliveries}. У каждой отправки есть deliveryId, sessionId, sessionTitle, destinationId, status, location, error, conflict и updatedAtMs.

exports.runs

Выводит попытки отправки одного пакета экспорта.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

batchIdrequired
string

Пакет экспорта из exports.enqueue или exports.history.

Возвращает: массив попыток: [{runId, deliveryId, status, startedAtMs, finishedAtMs, error}].

exports.history

Выводит недавние пакеты экспорта, начиная с новых.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

limit
integer

Сколько вернуть: от 1 до 100. По умолчанию 30.

Возвращает: массив пакетов в том виде, в каком их возвращает exports.status.

exports.cancel

Отменяет пакет экспорта. Завершённые отправки остаются экспортированными.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

batchIdrequired
string

Пакет экспорта из exports.enqueue или exports.history.

Возвращает: пакет в его текущем состоянии.

  • Все отправки, кроме тех, что в статусе exported, получают статус cancelled — в том числе частично экспортированные и требующие внимания.

exports.retry

Повторяет пакет экспорта: частично экспортированные отправки и отправки, требующие внимания (кроме конфликтов), снова ставятся в очередь.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

batchIdrequired
string

Пакет экспорта из exports.enqueue или exports.history.

Возвращает: пакет в его текущем состоянии.

  • Конфликты вместо этого разрешаются через exports.resolve. Завершённый пакет не меняется.

exports.resolve

Разрешает конфликт экспорта, когда файл или страница в месте экспорта были изменены вне TalkBar.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

deliveryIdrequired
string

Отправка, требующая внимания, из пакета.

actionrequired
string

keepExternal оставляет внешнюю версию, saveCopy записывает версию TalkBar как новую копию, replace перезаписывает внешнюю версию.

Возвращает: пакет в его текущем состоянии.

  • Разрешить можно только отправку, требующую внимания.
{"tool": "exports.resolve", "args": {"deliveryId": "dlv_9", "action": "saveCopy"}}

exports.destination.save

Создаёт или изменяет место экспорта: папку с файлами, хранилище Obsidian, папку для импорта в Notion или подключённую страницу Notion.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

destinationIdrequired
string

Идентификатор, который вы выбираете сами. Сохранение с существующим идентификатором изменяет это место экспорта.

namerequired
string

Название места экспорта. Не может быть пустым.

formatrequired
string

Что записывать:

  • txt, markdown, html, json, srt, vtt, zip: файлы в папке.
  • obsidian: Markdown со свойствами для хранилища Obsidian.
  • notionMarkdown: файлы Markdown для импорта в Notion.
  • notion: страницы, создаваемые в подключённом рабочем пространстве Notion.
locationrequired
string

Для notion — родительская страница (идентификатор или URL страницы). Для остальных форматов — абсолютный путь к папке.

enabledrequired
boolean

Можно ли использовать это место экспорта.

layout
string

Как файлы раскладываются по папке: flat (по умолчанию), project, series или projectSeries.

credentialRef
string | null

Для подключённого места экспорта Notion — сохранённое подключение: ровно export:<workspaceId>:<destinationId> или null. Notion подключается в приложении; ассистент не может сохранить токен.

Возвращает: место экспорта в сохранённом виде.

  • Сохранение заменяет место экспорта целиком: если не указать credentialRef для подключённого места Notion, оно будет отключено.
  • Правила администратора могут ограничивать, какие папки и места экспорта можно использовать.
{"tool": "exports.destination.save", "args": {"destinationId": "dest_vault", "name": "Obsidian vault", "format": "obsidian", "location": "PATH_TO_VAULT/Meetings", "enabled": true, "layout": "project"}}

exports.destination.delete

Удаляет место экспорта, у которого нет активных отправок. Уже экспортированные файлы и страницы сохраняются.

Изменение · выполняется через talkbar_delete · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

destinationIdrequired
string

Место экспорта из exports.config.

Возвращает: {deleted: true, switchedOffRules}. Собственное правило (override), у которого не осталось мест экспорта, переводится в disabled и попадает в switchedOffRules.

  • Пока отправка в это место запланирована, ожидает или выполняется, запрос отклоняется с кодом failed.
  • Также удаляет сохранённое подключение к Notion для этого места экспорта.
  • Выполняется через talkbar_delete: требует вашего подтверждения, если ваше ИИ-приложение умеет его запрашивать; запросы приложений, которые не умеют, отклоняются, если не включён параметр Разрешить удаление без подтверждения.

exports.rule.save

Настраивает автоэкспорт для рабочего пространства, проекта или серии.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

ruleIdrequired
string

Идентификатор, который вы выбираете сами. Повторное сохранение с тем же идентификатором изменяет правило.

scopeKindrequired
string

workspace, project или series.

scopeIdrequired
string

Идентификатор рабочего пространства, проекта или серии. Для workspace — идентификатор самого рабочего пространства.

moderequired
string

inherit (использовать правило уровнем выше; недопустимо для рабочего пространства), override (использовать это правило) или disabled (без автоэкспорта здесь).

destinationIdsrequired
string[]

Места, в которые нужно экспортировать.

selectionrequired
object

Что взять из сессий, как в exports.preview.

timingrequired
object

Когда экспортировать. Один из вариантов:

  • {"kind": "ready"}: как только сессия готова.
  • {"kind": "delay", "delayMs": …}: с задержкой после готовности, не больше 31 дня (2 678 400 000 мс).
  • {"kind": "daily", "hour": …, "minute": …, "timezone": "…"}: раз в день в это время, в часовом поясе IANA.
reexportSummaryrequired
boolean

Экспортировать снова при изменении итогов.

reexportTranscriptrequired
boolean

Экспортировать снова при изменении транскрипта.

enabledAtMsrequired
integer

Обязательное поле, но время TalkBar устанавливает сам: текущее или более раннее, если правило override остаётся override.

Возвращает: правило в сохранённом виде.

  • Одно правило на область: другой ruleId для области, у которой уже есть правило, отклоняется с кодом failed с указанием существующего правила.
{"tool": "exports.rule.save", "args": {"ruleId": "rule_proj456", "scopeKind": "project", "scopeId": "proj_456", "mode": "override", "destinationIds": ["dest_vault"], "selection": {"summary": true, "transcript": true}, "timing": {"kind": "ready"}, "reexportSummary": true, "reexportTranscript": false, "enabledAtMs": 0}}

exports.rule.delete

Удаляет правило автоэкспорта. Экспорты в очереди и уже доставленные сохраняются.

Изменение · выполняется через talkbar_delete · переключатель MCP по умолчанию Вкл. · группа политики exports

Аргументы

ruleIdrequired
string

Правило автоэкспорта из exports.config.

Возвращает: {deleted: true}.

  • Выполняется через talkbar_delete: требует вашего подтверждения, если ваше ИИ-приложение умеет его запрашивать; запросы приложений, которые не умеют, отклоняются, если не включён параметр Разрешить удаление без подтверждения.

См. также