Темы помечают сессии и заметки; ключевые слова — это слова, которые TalkBar (или вы) привязывает к сессии; закладки отмечают момент сессии и могут содержать заметку. Каждая операция также принимает необязательный workspaceId. Общие правила описаны в разделе Как читать этот справочник.

Операция	Тип	Инструмент	По умолчанию	Группа
`topics.list`	Чтение	`talkbar_read`	Вкл.	`content`
`topics.create`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`topics.rename`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`topics.delete`	Изменение	`talkbar_delete`	Выкл.	`contentChanges`
`topics.assign`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`topics.unassign`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`sessions.keywords.get`	Чтение	`talkbar_read`	Вкл.	`content`
`markers.list`	Чтение	`talkbar_read`	Вкл.	`content`
`markers.create`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`markers.update`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`markers.delete`	Изменение	`talkbar_delete`	Выкл.	`contentChanges`

`topics.list`

Выводит темы, которыми помечаются сессии и заметки.

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

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

Возвращает: {topics: [{topicId, name, color}]}, по алфавиту названий.

{"tool": "topics.list", "args": {}}

`topics.create`

Добавляет тему.

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

Аргументы

namerequired

string

Название темы, от 1 до 80 символов.

color

string

Одно из значений: slate, sky, stone, teal, indigo, green, yellow, blue, purple, rose, lime, emerald, amber, cyan, fuchsia, pink — или цвет в шестнадцатеричном виде #RGB / #RRGGBB. Если цвет не указан, он выбирается по названию, поэтому одно и то же название всегда получает один и тот же цвет.

Возвращает: {topicId, name, color}.

Уже существующее название отклоняется с кодом failed. Неподдерживаемый цвет отклоняется с кодом failed («Unsupported topic color»).

{"tool": "topics.create", "args": {"name": "Hiring", "color": "teal"}}

`topics.rename`

Изменяет название или цвет темы.

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

Аргументы

topicIdrequired

string

Тема из topics.list.

name

string

Новое название, от 1 до 80 символов.

color

string

Новый цвет, как в topics.create.

Возвращает: {topicId, name, color}.

Укажите name, color или оба.

`topics.delete`

Удаляет тему и снимает её со всех сессий и заметок.

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

Аргументы

topicIdrequired

string

Тема из topics.list.

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

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

`topics.assign`

Добавляет тему одной сессии или заметке.

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

Аргументы

topicIdrequired

string

Тема из topics.list.

sessionId

string

Сессия, которую нужно пометить. Укажите это поле или noteId, но не оба.

noteId

string

Заметка, которую нужно пометить. Укажите это поле или sessionId, но не оба.

Возвращает: {sessionId, noteId, topics} — темы элемента после изменения.

{"tool": "topics.assign", "args": {"topicId": "top_9", "sessionId": "ses_123"}}

`topics.unassign`

Снимает тему с одной сессии или заметки.

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

Аргументы

topicIdrequired

string

Тема из topics.list.

sessionId

string

Сессия. Укажите это поле или noteId, но не оба.

noteId

string

Заметка. Укажите это поле или sessionId, но не оба.

Возвращает: {sessionId, noteId, topics} — темы элемента после изменения.

`sessions.keywords.get`

Читает ключевые слова сессии.

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

Аргументы

sessionIdrequired

string

Сессия, с которой нужно работать. Идентификатор сессии, которая записывается сейчас, возвращает sessions.recording.

Возвращает: {sessionId, keywords: [string]}, а пока идёт запись сессии — ещё и pending: true.

TalkBar записывает свои ключевые слова от ИИ вместе с итогами, после остановки записи; до этого выводятся только ключевые слова, добавленные вами.

{"tool": "sessions.keywords.get", "args": {"sessionId": "ses_123"}}

`markers.list`

Выводит закладки сессии: заметку, время, цвет и слова, прозвучавшие в этот момент.

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

Аргументы

sessionIdrequired

string

Сессия, с которой нужно работать. Идентификатор сессии, которая записывается сейчас, возвращает sessions.recording.

Возвращает: {sessionId, markers}. Каждая закладка — {markerId, sessionId, kind, body, quote, atMs, turnId, chunkId, pointId, color, updatedAt}.

{"tool": "markers.list", "args": {"sessionId": "ses_123"}}

`markers.create`

Добавляет закладку в сессию, в том числе во время записи: на реплику или фрагмент транскрипта, точку хронологии, момент или цитату, с необязательной заметкой и цветом. Закладка сразу появляется в сессии.

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

Аргументы

sessionIdrequired

string

Сессия, с которой нужно работать. Идентификатор сессии, которая записывается сейчас, возвращает sessions.recording.

turnId

string

Реплика транскрипта (sessions.transcript с format: "json"). Укажите хотя бы одно из полей turnId, chunkId, pointId, atMs или quote.

chunkId

string

Фрагмент транскрипта, записанного в реальном времени (sessions.transcript с format: "json"). Закладка ставится на первую реплику фрагмента. Укажите хотя бы одно из полей turnId, chunkId, pointId, atMs или quote.

pointId

string

Точка хронологии (sessions.timeline). Нельзя сочетать с turnId или chunkId. Укажите хотя бы одно из полей turnId, chunkId, pointId, atMs или quote.

atMs

integer

Момент в мс от начала сессии. Вместе с репликой, фрагментом или точкой он должен попадать внутрь них; во время записи он не может быть позже текущего момента. Укажите хотя бы одно из полей turnId, chunkId, pointId, atMs или quote.

quote

string

Слова, к которым относится закладка. Само по себе это поле находит реплику с этими словами; если таких реплик несколько, добавьте turnId или atMs, чтобы выбрать одну. Укажите хотя бы одно из полей turnId, chunkId, pointId, atMs или quote.

body

string

Заметка к закладке, до 2 000 символов.

color

string

Цвет закладки, от 1 до 40 символов; по умолчанию amber.

Возвращает: закладку ({markerId, sessionId, kind, body, quote, atMs, turnId, chunkId, pointId, color, updatedAt}) и sessionStatus (а также warning, если сессия была прервана или идёт её запись, когда TalkBar не запущен).

Идентификатор, которого нет в сессии, или atMs за пределами указанного места отклоняются с кодом invalid_arguments.
Закладка хранит не только идентификаторы, но и свой момент, поэтому приложение правильно размещает её и после улучшения транскрипта.

{"tool": "markers.create", "args": {"sessionId": "ses_123", "quote": "we can ship in March", "body": "Ship date commitment", "color": "rose"}}

`markers.update`

Изменяет заметку или цвет закладки.

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

Аргументы

markerIdrequired

string

Закладка из markers.list.

body

string

Новая заметка.

color

string

Новый цвет.

Возвращает: закладку и sessionStatus (а также warning, если сессия была прервана или идёт её запись, когда TalkBar не запущен).

Укажите body, color или оба.

`markers.delete`

Удаляет закладку.

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

Аргументы

markerIdrequired

string

Закладка из markers.list.

sessionId

string

Необязательная проверка: сессия, которой принадлежит закладка. Если указана другая сессия, ничего не удаляется и возвращается not_found.

Возвращает: {markerId, sessionId, deleted: true} и sessionStatus (а также warning, если сессия была прервана или идёт её запись, когда TalkBar не запущен). sessionId — сессия, которой принадлежит закладка.

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

См. также

Сессии

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

Рабочее пространство и профиль

Операции MCP и CLI для рабочих пространств, поиска и статистики по пространству, вашего профиля и тарифа.

Темы и закладки