Операции с людьми (contacts.*) и компаниями (organizations.*) работают с людьми и компаниями, которые известны TalkBar. В talkbar_find это типы person и company. Чтобы назвать участника сессии или связать его с человеком, используйте операции sessions.speakers.* на странице Сессии. Каждая операция также принимает необязательный workspaceId. Общие правила описаны в разделе Как читать этот справочник.

Операция	Тип	Инструмент	По умолчанию	Группа
`contacts.list`	Чтение	`talkbar_read`	Вкл.	`content`
`contacts.get`	Чтение	`talkbar_read`	Вкл.	`content`
`contacts.sessions`	Чтение	`talkbar_read`	Вкл.	`content`
`contacts.create`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`contacts.update`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`contacts.archive`	Изменение	`talkbar_delete`	Выкл.	`contentChanges`
`contacts.unarchive`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`organizations.list`	Чтение	`talkbar_read`	Вкл.	`content`
`organizations.get`	Чтение	`talkbar_read`	Вкл.	`content`
`organizations.create`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`organizations.update`	Изменение	`talkbar_change`	Выкл.	`contentChanges`
`organizations.archive`	Изменение	`talkbar_delete`	Выкл.	`contentChanges`
`organizations.unarchive`	Изменение	`talkbar_change`	Выкл.	`contentChanges`

`contacts.list`

Выводит людей рабочего пространства: в скольких сессиях говорил каждый и когда началась последняя из них.

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

Аргументы

projectId

string

Только люди этого проекта.

query

string

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

includeArchived

boolean

Показывать и людей из архива. По умолчанию false.

limit

integer

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

Возвращает: {contacts: [{contactId, name, email, role, organizationId, archived, sessionCount, lastMetAtMs}]}.

sessionCount и lastMetAtMs считаются по тем же сессиям, что выводит contacts.sessions (человек говорил в них; сессии в корзине не учитываются). У человека, которого ни разу не было слышно, это 0 и null.

{"tool": "contacts.list", "args": {"query": "dana"}}

`contacts.get`

Читает данные одного человека.

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

Аргументы

contactIdrequired

string

Человек из contacts.list.

Возвращает: {contactId, name, email, phone, role, organizationId, relationshipTag, sentiment, notes, confirmed, lastContactAtMs, archived, createdAt, updatedAt}.

`contacts.sessions`

Выводит сессии, в которых говорил человек, начиная с новых: с именем, под которым он был в каждой из них, его временем разговора и долей в общем времени разговора.

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

Аргументы

contactIdrequired

string

Человек из contacts.list.

limit

integer

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

offset

integer

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

Возвращает: {contactId, sessions: [{sessionId, title, startedAtMs, endedAtMs, speaker, talkTimeMs, share, excludedFromAi, private}], hasMore, nextOffset}. share — доля от общего времени разговора всех участников, от 0 до 1.

Чтобы прочитать, что сказал человек, передайте speaker в фильтр speaker операции sessions.transcript.

{"tool": "contacts.sessions", "args": {"contactId": "ct_77", "limit": 10}}

`contacts.create`

Добавляет человека.

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

Аргументы

namerequired

string

Имя человека. Не может быть пустым.

string

Email. В нём должен быть ровно один символ @ с текстом до и после него и не должно быть пробелов; домен не проверяется.

phone

string

Номер телефона.

role

string

Роль или должность.

relationshipTag

string

Короткая метка о том, откуда вы знакомы.

notes

string

Заметки обычным текстом.

Возвращает: человека в том виде, в каком его возвращает contacts.get.

{"tool": "contacts.create", "args": {"name": "Dana Lee", "email": "[email protected]", "role": "CFO"}}

`contacts.update`

Изменяет имя, email, телефон, роль, метку отношений или заметки человека.

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

Аргументы

contactIdrequired

string

Человек из contacts.list.

name

string

Новое имя. Не может быть пустым.

string | null

Email, с той же проверкой, что и в contacts.create. null или пустая строка очищают его.

phone

string | null

Номер телефона. null очищает его.

role

string | null

Роль или должность. null очищает её.

relationshipTag

string | null

Короткая метка о том, откуда вы знакомы. null очищает её.

notes

string | null

Заметки обычным текстом; они заменяют заметки с форматированием. null очищает их.

Возвращает: человека в том виде, в каком его возвращает contacts.get.

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

`contacts.archive`

Перемещает человека в архив. Его история сохраняется, и его по-прежнему можно изменять.

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

Аргументы

contactIdrequired

string

Человек из contacts.list.

Возвращает: строку человека из списка (contactId, name, email, role, organizationId, archived).

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

`contacts.unarchive`

Возвращает человека из архива.

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

Аргументы

contactIdrequired

string

Человек из contacts.list.

Возвращает: строку человека из списка, как contacts.archive.

`organizations.list`

Выводит компании рабочего пространства.

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

Аргументы

projectId

string

Только компании этого проекта.

query

string

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

includeArchived

boolean

Показывать и компании из архива. По умолчанию false.

limit

integer

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

Возвращает: {organizations: [{organizationId, name, relationship, website, pinned, archived}]}.

`organizations.get`

Читает данные одной компании, в том числе из архива.

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

Аргументы

organizationIdrequired

string

Компания из organizations.list.

Возвращает: строку из списка, а также notes, createdAt и updatedAt.

`organizations.create`

Добавляет компанию.

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

Аргументы

namerequired

string

Название компании. Не может быть пустым.

relationship

string

Одно из значений: client, vendor, partner, prospect, internal, investor, advisor, candidate_company, other. По умолчанию other.

website

string

Произвольный текст, как в приложении (northwind.example подойдёт). Пустое значение означает, что сайта нет. Ссылки javascript:, vbscript: и data: отклоняются.

notes

string

Заметки обычным текстом.

Возвращает: компанию в том виде, в каком её возвращает organizations.get.

{"tool": "organizations.create", "args": {"name": "Northwind", "relationship": "client", "website": "northwind.example"}}

`organizations.update`

Изменяет название, отношения, сайт или заметки компании.

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

Аргументы

organizationIdrequired

string

Компания из organizations.list.

name

string

Новое название. Не может быть пустым.

relationship

string

Одно из значений: client, vendor, partner, prospect, internal, investor, advisor, candidate_company, other.

website

string | null

Те же правила, что и в organizations.create. null очищает его.

notes

string | null

Заметки обычным текстом. null очищает их.

Возвращает: компанию в том виде, в каком её возвращает organizations.get.

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

`organizations.archive`

Перемещает компанию в архив. Её история сохраняется.

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

Аргументы

organizationIdrequired

string

Компания из organizations.list.

Возвращает: строку компании из списка.

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

`organizations.unarchive`

Возвращает компанию из архива.

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

Аргументы

organizationIdrequired

string

Компания из organizations.list.

Возвращает: строку компании из списка.

См. также

База знаний

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

Проекты и заметки

Операции MCP и CLI, чтобы показывать, читать, создавать, изменять, распределять, закреплять, перемещать в корзину и восстанавливать проекты и заметки.

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