Чаты и документы
Операции с чатами читают и упорядочивают ваши чаты «Спросить TalkBar»; отправить сообщение в чат ассистент не может. Операции с документами выводят документы, читают извлечённый из них текст, переименовывают, закрепляют и привязывают документы к проектам. Каждая операция также принимает необязательный workspaceId. Общие правила описаны в разделе Как читать этот справочник.
| Операция | Тип | Инструмент | По умолчанию | Группа |
|---|---|---|---|---|
chats.list | Чтение | talkbar_read | Вкл. | content |
chats.get | Чтение | talkbar_read | Вкл. | content |
chats.trash.list | Чтение | talkbar_read | Вкл. | content |
chats.update | Изменение | talkbar_change | Выкл. | contentChanges |
chats.trash | Изменение | talkbar_delete | Выкл. | contentChanges |
chats.restore | Изменение | talkbar_change | Выкл. | contentChanges |
documents.list | Чтение | talkbar_read | Вкл. | content |
documents.get | Чтение | talkbar_read | Вкл. | content |
documents.read | Чтение | talkbar_read | Вкл. | content |
documents.update | Изменение | talkbar_change | Выкл. | contentChanges |
chats.list
Постранично выводит чаты с ИИ («Спросить TalkBar») рабочего пространства: сначала закреплённые, затем по времени последней активности. Сообщения не возвращаются.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content
Аргументы
Только чаты, привязанные к этому проекту.
Слова для поиска в названии чата или его сообщениях. Должно встретиться каждое слово; регистр и диакритические знаки не учитываются.
active (по умолчанию), pinned или trash.
Сколько вернуть: от 1 до 100. По умолчанию 40.
Значение nextCursor из предыдущей страницы. Не может быть пустым.
Возвращает: {items, nextCursor, totalCount}. У каждого элемента есть chatId, title, snippet, groundingMode, projectId, pinned, createdAt, updatedAt, lastMessageAtMs, trashedAtMs и currentTurnStatus.
{"tool": "chats.list", "args": {"search": "pricing"}}
chats.get
Читает один чат и его последние сообщения: ваши вопросы и ответы на них, с источниками и названиями навыков.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content
Аргументы
Чат из chats.list.
Сколько последних сообщений вернуть: от 1 до 200. По умолчанию 20.
nextBeforeSequence из предыдущего вызова — чтобы получить более старые сообщения.
Возвращает: чат (как в chats.list, а также workspaceId и replyLanguage), messages, hasMoreMessages и nextBeforeSequence. У каждого сообщения есть messageId, role, content, createdAt, sources ([{n, label, sourceType, sourceId, sessionId, documentId, atMs, locator, snippet, href}]) и skill.
- Чат в корзине тоже можно прочитать; у него заполнено поле
trashedAtMs.
{"tool": "chats.get", "args": {"chatId": "chat_12", "limit": 50}}
chats.trash.list
Выводит чаты в корзине.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content
Аргументы
Сколько вернуть: от 1 до 200. По умолчанию 50.
Возвращает: {chats: [{chatId, title, trashedAt}]}.
chats.update
Переименовывает чат, закрепляет его или привязывает к проекту.
Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Выкл. · группа политики contentChanges
Аргументы
Чат из chats.list.
Новое название. Может быть пустым, как в приложении.
true закрепляет, false открепляет.
Проект или null, чтобы убрать чат из проекта.
Возвращает: {chatId, title, pinned, projectId}.
- Укажите хотя бы одно поле. Чат в корзине изменить нельзя: сначала восстановите его.
chats.trash
Перемещает чат в корзину. Его можно восстановить.
Изменение · выполняется через talkbar_delete · переключатель MCP по умолчанию Выкл. · группа политики contentChanges
Аргументы
Чат из chats.list.
Возвращает: {chatId, trashed: true}. Перемещение в корзину чата, который уже там, тоже завершается успешно.
- Выполняется через
talkbar_delete: требует вашего подтверждения, если ваше ИИ-приложение умеет его запрашивать; запросы приложений, которые не умеют, отклоняются, если не включён параметр Разрешить удаление без подтверждения.
chats.restore
Восстанавливает чат из корзины.
Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Выкл. · группа политики contentChanges
Аргументы
Чат из chats.list.
Возвращает: {chatId, title, pinned, projectId}. Восстановление чата, которого нет в корзине, возвращает тот же ответ.
documents.list
Выводит документы рабочего пространства.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content
Аргументы
Только документы, привязанные к этому проекту.
Поиск по названию документа без учёта регистра.
Только документы, добавленные в эту сессию (их выводит sessions.documents).
Сколько вернуть: от 1 до 200. По умолчанию 50.
Возвращает: {documents: [{documentId, title, fileType, status, pinned, projectId, updatedAt}]}.
{"tool": "documents.list", "args": {"projectId": "proj_456"}}
documents.get
Читает данные одного документа и короткий фрагмент для предпросмотра.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content
Аргументы
Документ из documents.list или sessions.documents.
Возвращает: строку из списка, а также sizeBytes, sourceKind, indexProgress, preview и createdAt.
documents.read
Читает извлечённый из документа текст по страницам.
Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content
Аргументы
Документ из documents.list или sessions.documents.
nextOffset из предыдущей страницы, в символах. Смещение за концом текста отклоняется.
Размер страницы в символах: от 1 000 до 200 000. По умолчанию 20000.
Возвращает: {documentId, title, status, totalChars, offset, nextOffset, truncated, text}.
- Если текст из документа ещё не извлечён или документ больше недоступен, операция завершается ошибкой с понятным сообщением.
{"tool": "documents.read", "args": {"documentId": "doc_8", "maxChars": 40000}}
documents.update
Переименовывает документ, закрепляет его или привязывает к проекту.
Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Выкл. · группа политики contentChanges
Аргументы
Документ из documents.list или sessions.documents.
Новое название. Не может быть пустым.
true закрепляет, false открепляет.
Проект или null, чтобы убрать документ из проекта. Проект не должен быть в корзине.
Возвращает: строку документа из списка.
- Укажите хотя бы одно поле. Добавление, удаление и повторная индексация документов доступны только в приложении.