Планировщик

Операции MCP и CLI для просмотра фоновых заданий TalkBar, а также для отмены или повторного запуска отдельного задания.

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

ОперацияТипИнструментПо умолчаниюГруппа
scheduler.statusЧтениеtalkbar_readВкл.scheduler
scheduler.jobs.listЧтениеtalkbar_readВкл.scheduler
scheduler.job.getЧтениеtalkbar_readВкл.scheduler
scheduler.job.cancelИзменениеtalkbar_changeВкл.scheduler
scheduler.job.retryИзменениеtalkbar_changeВкл.scheduler

Статусы заданий

Задание может иметь статус pending, leased, running, succeeded, skipped, failed или cancelled.

scheduler.status

Показывает, сколько фоновых заданий рабочего пространства находится в каждом статусе и когда подойдёт время следующего.

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

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

Возвращает: {pending, leased, running, succeeded, skipped, failed, cancelled, nextDueAtMs}.

{"tool": "scheduler.status", "args": {}}

scheduler.jobs.list

Выводит недавние фоновые задания рабочего пространства, начиная с новых.

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

Аргументы

limit
integer

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

Возвращает: массив заданий. Задание: jobId, jobKind, scopeType, scopeId, targetType, targetId, queueName, priority, runAtMs, status, attemptCount, maxAttempts, lastError, createdAtMs, updatedAtMs, startedAtMs, completedAtMs, cancelledAtMs и несколько служебных полей маршрутизации.

scheduler.job.get

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

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

Аргументы

jobIdrequired
string

Фоновое задание из scheduler.jobs.list.

runLimit
integer

Наибольшее число запусков в ответе: от 1 до 500. По умолчанию 50.

Возвращает: {job, runs}. У каждого запуска есть runId, jobId, attemptNumber, status, startedAtMs, finishedAtMs, error и outputJson.

{"tool": "scheduler.job.get", "args": {"jobId": "job_31"}}

scheduler.job.cancel

Отменяет одно задание со статусом pending, leased или running.

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

Аргументы

jobIdrequired
string

Фоновое задание из scheduler.jobs.list.

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

  • Для уже завершённого задания запрос отклоняется с кодом failed. Отмена задания не удаляет встречу, напоминание или экспорт, которые его создали.

scheduler.job.retry

Возвращает одно задание с ошибкой в очередь.

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

Аргументы

jobIdrequired
string

Фоновое задание из scheduler.jobs.list.

runAtMs
integer

Когда запустить, мс эпохи Unix. По умолчанию — сейчас. Прошедшее время означает «сейчас».

Возвращает: задание в его текущем состоянии — со статусом pending и очищенной последней ошибкой.

  • Повторить можно только задание со статусом failed; для остальных запрос отклоняется с кодом failed.

См. также