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

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

Эти операции сообщают ассистенту, в каком рабочем пространстве он работает, ищут по нему, считают, что в нём хранится, и читают ваш профиль и тариф. Все операции здесь, кроме 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

Аргументы

queryrequired
string

Что искать. Не может быть пустым. Регистр и диакритические знаки не учитываются.

projectId
string

Искать только в этом проекте.

kinds
string[]

Какие виды элементов искать. Пустой список или отсутствие аргумента означает все виды. Значения: session, note, document, chat, action_item, project, series, person, company, memory (карточка знаний).

limit
integer

Наибольшее число совпадений в ответе. От 1 до 100. По умолчанию 20.

match
string

any (по умолчанию) принимает запрос на естественном языке и находит элементы, содержащие любое из оставшихся слов; all требует всех слов.

includeArchived
boolean

Искать также в архивных сериях, людях, компаниях и карточках знаний; они возвращаются с отметкой 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

Аргументы

projectId
string

Считать только в этом проекте. Действует на сессии, заметки, документы и карточки знаний; на число проектов не влияет.

startedAfterMs
integer

Считать только сессии, начатые в это время или позже (время Unix в мс, включительно). Действует только на сессии.

startedBeforeMs
integer

Считать только сессии, начатые раньше этого времени (время 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

Аргументы

namerequired
string

Новое название. Не может быть пустым; пробелы по краям удаляются.

Возвращает: {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

Аргументы

name
string | null

Ваше имя. null или пустая строка очищает его.

email
string | null

Ваш email. В нём должен быть ровно один символ @ с текстом до и после него и не должно быть пробелов. null или пустая строка очищает его.

jobTitle
string | 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": {}}

См. также