Операции базы знаний работают с карточками знаний (в аргументах они обозначаются как memoryId) и с предложениями, которые находит извлечение знаний. Чтобы управлять карточками одной сессии, используйте операции sessions.cards.* на странице Сессии. Каждая операция также принимает необязательный workspaceId. Общие правила описаны в разделе Как читать этот справочник.

Операция	Тип	Инструмент	По умолчанию	Группа
`knowledge.list`	Чтение	`talkbar_read`	Вкл.	`content`
`knowledge.get`	Чтение	`talkbar_read`	Вкл.	`content`
`knowledge.create`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.update`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.pin`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.assign`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.approve`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.confirm`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.mark_outdated`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.archive`	Изменение	`talkbar_delete`	Выкл.	`contentChanges`
`knowledge.restore`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.suggestions.list`	Чтение	`talkbar_read`	Вкл.	`content`
`knowledge.suggestions.approve`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.suggestions.dismiss`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.suggestions.snooze`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`knowledge.suggestions.reopen`	Изменение	`talkbar_change`	Выкл.	`contentChanges`

Статусы карточек

Карточка может быть в статусе approved (одобрена), outdated (устарела) или archived (в архиве). Когда TalkBar опирается на вашу базу знаний, используются только одобренные карточки, и закреплёнными остаются тоже только одобренные.

Из статуса	Операция	В статус
одобрена	`knowledge.mark_outdated`	устарела
одобрена или устарела	`knowledge.archive`	в архиве
устарела или в архиве	`knowledge.approve` или `knowledge.restore`	одобрена

Любой другой переход отклоняется с failed. Запрос статуса, который у карточки уже есть, ничего не меняет.

`knowledge.list`

Показывает карточки знаний. Можно фильтровать по статусу, типу, проекту, разделу «Общее», закреплению, сессии или тексту.

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

Аргументы

statuses

string[]

Только карточки с этими статусами: approved, outdated, archived. По умолчанию — только одобренные карточки.

types

string[]

Только карточки этих типов: fact, preference, decision, commitment, risk, open_question, relationship_context, instruction, key_moment, contract_term, pricing_detail, technical_detail.

projectId

string

Только карточки, относящиеся к этому проекту.

generalOnly

boolean

Только карточки, не относящиеся ни к одному проекту.

pinnedOnly

boolean

Только закреплённые карточки.

query

string

Текст для поиска в карточках.

sessionId

string

Только карточки, взятые в эту сессию, в порядке сессии (так, как их показывает sessions.live_cards).

offset

integer

nextOffset из предыдущей страницы. Не меньше 0.

limit

integer

Сколько вернуть. От 1 до 200. По умолчанию 50.

Возвращает: {cards: [{memoryId, title, type, status, pinned, projectId, sessionOnly, updatedAt}], total, nextOffset}. sessionOnly: true означает, что карточка остаётся только в своей сессии.

{"tool": "knowledge.list", "args": {"projectId": "proj_456", "types": ["decision", "commitment"]}}

`knowledge.get`

Читает одну карточку знаний с текстом, данными и источниками, включая цитаты.

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

Аргументы

memoryIdrequired

string

Карточка знаний из knowledge.list.

Возвращает: карточку: {memoryId, title, body, type, status, pinned, priority, confidence, projectId, contactId, organizationId, sessionId, sessionOnly, createdBy, lastConfirmedAtMs, createdAt, updatedAt}, а также sources: [{sourceType, sourceId, atMs, quote, locator, status}].

{"tool": "knowledge.get", "args": {"memoryId": "mem_321"}}

`knowledge.create`

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

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

Аргументы

titlerequired

string

Заголовок карточки. Не может быть пустым.

body

string

Текст карточки.

type

string

Одно из значений: fact, preference, decision, commitment, risk, open_question, relationship_context, instruction, key_moment, contract_term, pricing_detail, technical_detail. По умолчанию fact.

projectId

string

Отнести карточку к этому проекту. Без него карточка попадает в раздел «Общее».

pinned

boolean

Закрепить карточку.

{"tool": "knowledge.create", "args": {"title": "Prefers email over calls", "type": "preference", "projectId": "proj_456"}}

`knowledge.update`

Меняет заголовок, текст или тип карточки знаний.

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

Аргументы

memoryIdrequired

string

Карточка знаний из knowledge.list.

title

string

Новый заголовок. Не может быть пустым.

body

string

Новый текст.

type

string

Укажите хотя бы одно поле.

`knowledge.pin`

Закрепляет или открепляет карточку знаний.

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

Аргументы

memoryIdrequired

string

Карточка знаний из knowledge.list.

pinnedrequired

boolean

true закрепляет, false открепляет. Закрепление относится к самой карточке: она показывается закреплённой во всех сессиях и списках, где она есть.

Возвращает: {memoryId, pinned}.

Карточка, которая перестаёт быть одобренной (устаревает или попадает в архив), открепляется, и последующее одобрение или восстановление не закрепляет её снова.

`knowledge.assign`

Относит карточки знаний к проекту или убирает их из проекта.

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

Аргументы

memoryIdsrequired

string[]

Карточки, которые нужно отнести к проекту. Не может быть пустым.

projectIdrequired

string | null

Проект или null, чтобы убрать карточки из проекта. Обязательный аргумент.

Возвращает: {memoryIds, projectId, changed}.

{"tool": "knowledge.assign", "args": {"memoryIds": ["mem_321", "mem_322"], "projectId": "proj_456"}}

`knowledge.approve`

Возвращает карточку знаний в статус одобренной. Одобрение уже одобренной карточки ничего не меняет.

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

Аргументы

memoryIdrequired

string

Карточка знаний из knowledge.list.

У карточек нет статуса «ожидает проверки»: то, что находит извлечение знаний, — это предложения. Их одобряют через knowledge.suggestions.approve.

`knowledge.confirm`

Подтверждает, что карточка знаний всё ещё актуальна. Записывает время в lastConfirmedAtMs и не меняет статус.

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

Аргументы

memoryIdrequired

string

Карточка знаний из knowledge.list.

`knowledge.mark_outdated`

Отмечает карточку знаний как устаревшую.

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

Аргументы

memoryIdrequired

string

Карточка знаний из knowledge.list.

Устаревшая карточка открепляется. Чтобы вернуть её, одобрите или восстановите её.

`knowledge.archive`

Отправляет карточку знаний в архив. Её можно восстановить.

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

Аргументы

memoryIdrequired

string

Карточка знаний из knowledge.list.

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

`knowledge.restore`

Возвращает карточку знаний из архива (или устаревшую карточку) в статус одобренной.

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

Аргументы

memoryIdrequired

string

Карточка знаний из knowledge.list.

`knowledge.suggestions.list`

Показывает карточки, людей и компании, которые предлагает извлечение знаний, вместе с цитатами, из которых они взяты.

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

Аргументы

status

string

Одно из значений: pending, approving, approved, dismissed. По умолчанию pending.

kind

string

Только предложения для memory (карточки знаний), contact (человека) или organization (компании).

projectId

string

Только предложения для этого проекта.

query

string

Текст для поиска в предложениях.

limit

integer

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

cursor

string

nextCursor из предыдущей страницы.

Возвращает: {suggestions, hasMore, nextCursor}. У каждого предложения есть suggestionId, kind, action, status, proposal, evidence, targetId, confidence, projectId, sessionId, documentId, snoozedUntilMs, appliedCardId и createdAt.

{"tool": "knowledge.suggestions.list", "args": {"kind": "memory", "limit": 20}}

`knowledge.suggestions.approve`

Принимает предложение.

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

Аргументы

suggestionIdrequired

string

Предложение из knowledge.suggestions.list.

approveWithoutSource

boolean

Если сессия или документ, из которых взято предложение, больше недоступны, всё равно одобрить его, уже без связи с источником. Без этого аргумента такое предложение отклоняется.

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

{"tool": "knowledge.suggestions.approve", "args": {"suggestionId": "sug_55"}}

`knowledge.suggestions.dismiss`

Отклоняет предложение. Отменить можно через knowledge.suggestions.reopen.

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

Аргументы

suggestionIdrequired

string

Предложение из knowledge.suggestions.list.

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

`knowledge.suggestions.snooze`

Скрывает предложение до указанного времени. Отменить можно через knowledge.suggestions.reopen.

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

Аргументы

suggestionIdrequired

string

Предложение из knowledge.suggestions.list.

untilMsrequired

integer

Когда показать его снова, как время Unix в мс. Должно быть в будущем.

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

`knowledge.suggestions.reopen`

Возвращает отклонённое или отложенное предложение на проверку.

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

Аргументы

suggestionIdrequired

string

Предложение из knowledge.suggestions.list.

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

См. также

Справочник операций

Все операции, которые ассистент может выполнять через MCP TalkBar или CLI TalkBar, с аргументами, значениями по умолчанию, разрешениями и результатами.

Люди и компании

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

База знаний