Рабочее пространство и профиль
Эти операции сообщают ассистенту, в каком рабочем пространстве он работает, ищут по нему, считают, что в нём хранится, и читают ваш профиль и тариф. Все операции здесь, кроме workspace.list, также принимают необязательный workspaceId; без него используется пространство, открытое в приложении. Общие правила описаны в разделе Как читать этот справочник.
| Операция | Тип | Инструмент | По умолчанию | Группа |
|---|---|---|---|---|
workspace.list | Чтение | talkbar_read | Вкл. | metadata |
workspace.search | Чтение | talkbar_read | Вкл. | content |
workspace.stats | Чтение | talkbar_read | Вкл. | metadata |
workspace.rename | Изменение | talkbar_change | Выкл. | contentChanges |
profile.get | Чтение | talkbar_read | Вкл. | content |
profile.update | Изменение | talkbar_change | Выкл. | contentChanges |
plan.get | Чтение | talkbar_read | Вкл. | metadata |
workspace.list
Показывает ваши рабочие пространства и отмечает то, которое открыто в приложении. Операции, вызванные без workspaceId, используют это открытое пространство.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata
Аргументы: нет.
Возвращает: {workspaces: [{workspaceId, name, active}]}. active: true отмечает пространство, открытое в приложении.
- Хороший первый вызов: он сообщает ассистенту, какое пространство по умолчанию будут использовать все остальные вызовы.
{"tool": "workspace.list", "args": {}}
workspace.search
Ищет по названиям и тексту в рабочем пространстве среди сессий, заметок, документов, чатов, задач, проектов, серий, людей, компаний и карточек знаний, начиная с лучших совпадений. Инструмент talkbar_find выполняет тот же поиск.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content
Аргументы
Что искать. Не может быть пустым. Регистр и диакритические знаки не учитываются.
Искать только в этом проекте.
Какие виды элементов искать. Пустой список или отсутствие аргумента означает все виды. Значения: session, note, document, chat, action_item, project, series, person, company, memory (карточка знаний).
Наибольшее число совпадений в ответе. От 1 до 100. По умолчанию 20.
any (по умолчанию) принимает запрос на естественном языке и находит элементы, содержащие любое из оставшихся слов; all требует всех слов.
Искать также в архивных сериях, людях, компаниях и карточках знаний; они возвращаются с отметкой archived. По умолчанию false. Элементы в корзине не ищутся никогда.
Возвращает: {matches, contentSearch}. У каждого совпадения есть kind, id, title, snippet, href (ссылка в приложение), score, projectId, matchedIn, atMs (начало сессии, для остальных элементов — последнее изменение), detail, context, itemCount, archived и, для совпадения в проиндексированном тексте транскрипта или документа, content. contentSearch сообщает, искал ли поиск по проиндексированному содержимому: on, keywordOnly (модель эмбеддингов не установлена), off или failed (совпадения по названиям и тексту всё равно возвращаются).
- Фрагменты могут содержать текст транскрипта.
- Поиск идёт по названиям элементов и их собственному тексту (итоги сессий, текст заметок, сообщения чатов, подробности задач, текст карточек), а также по проиндексированному содержимому, если оно доступно.
{"tool": "workspace.search", "args": {"query": "pricing decision for Northwind", "kinds": ["session", "note"], "limit": 10}}
workspace.stats
Считает сессии по статусам, заметки, документы, проекты и одобренные карточки знаний в рабочем пространстве. Текст содержимого не возвращается.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata
Аргументы
Считать только в этом проекте. Действует на сессии, заметки, документы и карточки знаний; на число проектов не влияет.
Считать только сессии, начатые в это время или позже (время Unix в мс, включительно). Действует только на сессии.
Считать только сессии, начатые раньше этого времени (время Unix в мс, не включительно). Действует только на сессии.
Возвращает: {sessions: {total, byStatus, firstStartedAtMs, lastStartedAtMs}, notes: {total}, documents: {total}, projects: {total}, knowledge: {approvedTotal}}.
{"tool": "workspace.stats", "args": {"startedAfterMs": 1761955200000}}
workspace.rename
Переименовывает рабочее пространство: открытое или то, которое указано в workspaceId.
Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Выкл. · группа политики contentChanges
Аргументы
Новое название. Не может быть пустым; пробелы по краям удаляются.
Возвращает: {workspaceId, name}.
- Создание, переключение и удаление пространств в корзину остаются в приложении.
{"tool": "workspace.rename", "args": {"name": "Client work"}}
profile.get
Читает ваше имя, email и должность из профиля, который использует рабочее пространство.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content
Аргументы: только workspaceId.
Возвращает: {profileId, workspaceId, name, email, jobTitle, isDefault}.
{"tool": "profile.get", "args": {}}
profile.update
Меняет ваше имя, email или должность в профиле, который использует рабочее пространство.
Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Выкл. · группа политики contentChanges
Аргументы
Ваше имя. null или пустая строка очищает его.
Ваш email. В нём должен быть ровно один символ @ с текстом до и после него и не должно быть пробелов. null или пустая строка очищает его.
Ваша должность. null или пустая строка очищает её.
Возвращает: профиль в том же виде, что и profile.get.
- Укажите хотя бы одно поле. Неуказанные поля не меняются; аватар сохраняется.
- Профиль виден в приложении и на страницах, которыми вы делитесь.
{"tool": "profile.update", "args": {"jobTitle": "Head of Product"}}
plan.get
Читает ваш тариф TalkBar: его лимиты и сколько из каждого занято в этом рабочем пространстве и в папке данных, состояние лицензии, а также тарифы выше вашего и что даёт каждый из них.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata
Аргументы: только workspaceId.
Возвращает: plan ({id, name}, действующий тариф), licensedPlan, previewTrialActive, previewTrialExpiresAt, environment, license (plan, status, paid, updatesUntil, onlineServicesUntil, renewalOpen), limits, features, upgrades ([{id, name, adds, limits}], пустой на самом старшем тарифе) и upgradeUrl (null, если тарифа выше нет).
limitsсодержитprojectsиsessions(на рабочее пространство),workspaces,profilesиshareLinks(на папку данных) иdevices(на лицензию), каждый в виде{max, used, per};max: nullозначает «без ограничений». У других лимитов, напримерrecordingMinutes, нетused.- Во время пробного периода тестовой версии
plan— тариф пробного периода, аlicensedPlanсохраняет тариф вашей лицензии. - Никогда не возвращает лицензионный ключ, email, имя владельца или платёжные данные и не может сменить тариф. Если изменение отклонено с
plan_limit, именно здесь ассистент видит причину. Подробнее — в разделе Ошибки и ограничения.
{"tool": "plan.get", "args": {}}
См. также
Темы и закладки
Операции MCP и CLI для тем, которыми помечаются сессии и заметки, для ключевых слов сессии и для закладок на моментах сессии.
Обзор MCP и CLI
Что MCP-сервер TalkBar и talkbar-cli позволяют ИИ-ассистенту делать с вашими сессиями, заметками и базой знаний и что всегда остаётся только в приложении.