Справочник операций
TalkBar предоставляет 144 операции (57 на чтение и 87 на изменение): ИИ-ассистентам — через MCP, скриптам — через CLI TalkBar. В этом справочнике описана каждая из них: что она делает, какой инструмент MCP её выполняет, включена ли она по умолчанию, какие у неё аргументы и что она возвращает.
Операции по категориям
| Категория | Чтение | Изменение | Всего |
|---|---|---|---|
| Рабочее пространство и профиль | 5 | 2 | 7 |
| Сессии | 10 | 11 | 21 |
| Проекты и заметки | 6 | 12 | 18 |
| Задачи | 2 | 4 | 6 |
| База знаний | 3 | 13 | 16 |
| Люди и компании | 5 | 8 | 13 |
| Темы и закладки | 3 | 8 | 11 |
| Чаты и документы | 6 | 4 | 10 |
| Календарь и серии | 8 | 14 | 22 |
| Планировщик | 3 | 2 | 5 |
| Экспорт | 6 | 9 | 15 |
| Все | 57 | 87 | 144 |
Как читать этот справочник
У каждой операции свой раздел, заголовок которого — её название (например, sessions.get), а под ним строка вида:
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata
| Метка | Значение |
|---|---|
| Тип | Операции чтения только читают данные. Операции изменения что-то меняют. |
| Выполняется через | Инструмент MCP, который выполняет операцию. Чтение выполняется через talkbar_read. Изменения выполняются через talkbar_change, кроме 15 операций, которые перемещают элементы в корзину, архивируют или удаляют их либо отменяют запланированную встречу: они выполняются только через talkbar_delete. Такие операции требуют вашего подтверждения, если ваше ИИ-приложение умеет его запрашивать; запросы приложений, которые не умеют, отклоняются, если не включён параметр Разрешить удаление без подтверждения. |
| Переключатель MCP | Включена ли операция сразу после настройки MCP. Каждую операцию можно включить или выключить в разделе Настройки → Доступ по MCP. 81 операция изначально включена, 63 — выключены: операции чтения включены; изменения ваших элементов выключены, а большинство операций с календарём, сериями, планировщиком и экспортом включены. Выключенная операция отвечает turned_off. CLI эти переключатели не учитывает. |
| Группа политики | Группа, которую политика администратора может разрешить или заблокировать. Если вашим TalkBar управляет организация, заблокированная группа недоступна и через MCP, и через CLI. Подробнее — в разделе Доступ и разрешения. |
Группы политик
| Группа | Что охватывает | Операции |
|---|---|---|
metadata | Названия, количества, списки и расписания без текста встреч: рабочие пространства, тариф, списки сессий и их показатели, записываемая сессия, списки проектов, чтение календаря и серий. | 14 |
content | Чтение, которое возвращает текст встреч: итоги, транскрипты, заметки, чаты, карточки, люди, фрагменты результатов поиска, подготовка к встрече и предпросмотр экспорта. | 35 |
contentChanges | Все изменения сессий, проектов, заметок, задач, базы знаний, людей, тем, закладок, чатов, документов, вашего профиля и названий рабочих пространств. | 62 |
scheduling | Изменения запланированных встреч и серий сессий. | 14 |
scheduler | Просмотр фоновых заданий и управление ими. | 5 |
exports | Настройки, пакеты и доставки экспорта (кроме exports.preview, которая входит в content). | 14 |
Аргументы
Для каждого аргумента указан тип, обязательные аргументы отмечены. Диапазоны, допустимые значения и значения по умолчанию берутся из схемы операции; полную схему любой операции также можно получить у talkbar_tools с помощью {"tool": "<operation>"}.
workspaceIdвезде необязателен, поэтому в списках аргументов не указан. Без него используется рабочее пространство, открытое в приложении.workspace.listвообще не принимает аргументов и показывает пространства, которые можно указать.- Аргумент, который операция не принимает, отклоняется с указанием его имени и никогда не игнорируется. Значение вне допустимого диапазона отклоняется, а не обрезается до границы.
- Поля времени, названия которых оканчиваются на
Ms, содержат время Unix в миллисекундах (или, где это указано, миллисекунды от начала сессии). В тексте транскрипта и хронологии время показано какmm:ssилиh:mm:ss. - Если аргумент принимает
null, тоnullочищает значение, а если аргумент не передан, значение сохраняется.
Коды ошибок, постраничный вывод и лимиты тарифа описаны в разделе Ошибки и ограничения.
Как вызвать операцию
Через MCP передайте операцию и её аргументы инструменту, который её выполняет:
{"tool": "sessions.get", "args": {"sessionId": "ses_123"}}
Из командной строки тот же вызов выглядит так:
talkbar-cli tools call sessions.get --args '{"sessionId":"ses_123"}'
Чтобы выполнить по порядку до 20 операций, используйте {"calls": [...]}. После ошибки вызовы продолжаются, если не добавить "stopOnError": true (по умолчанию false). Идентификаторы в примерах на этих страницах условные. Настоящие можно найти через talkbar_find или операцию получения списка. Подробнее — в разделах Пять инструментов MCP и CLI.
Чего ассистенты не могут делать
Ни одна операция не ведёт запись и не управляет ею, не редактирует транскрипт, не подводит итоги, не меняет настройки приложения (исключение — места и правила экспорта через операции exports.*), не очищает корзину, не удаляет безвозвратно элементы, у которых есть корзина, и не добавляет документы. Всё это делается только в приложении.