# Задачи

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

Canonical URL: https://docs.talkbar.ru/mcp/operations/action-items


Операции с задачами работают с четырьмя видами элементов, которые отслеживает TalkBar: задачами, напоминаниями, вопросами и решениями. Элемент относится к сессии, проекту или разделу «Общее» и может указывать на момент сессии, из которого он появился. Каждая операция также принимает необязательный `workspaceId`. Общие правила описаны в разделе [Как читать этот справочник](/mcp/operations#как-читать-этот-справочник).

| Операция | Тип | Инструмент | По умолчанию | Группа |
| --- | --- | --- | --- | --- |
| [`action_items.list`](#action_itemslist) | Чтение | `talkbar_read` | Вкл. | `content` |
| [`action_items.get`](#action_itemsget) | Чтение | `talkbar_read` | Вкл. | `content` |
| [`action_items.create`](#action_itemscreate) | Изменение | `talkbar_change` | Выкл. | `contentChanges` |
| [`action_items.update`](#action_itemsupdate) | Изменение | `talkbar_change` | Выкл. | `contentChanges` |
| [`action_items.set_status`](#action_itemsset_status) | Изменение | `talkbar_change` | Выкл. | `contentChanges` |
| [`action_items.remove`](#action_itemsremove) | Изменение | `talkbar_delete` | Выкл. | `contentChanges` |

## Статусы по типам

| Тип | Статусы |
| --- | --- |
| `task` | `open`, `done` |
| `follow_up` | `open`, `done` |
| `question` | `open`, `answered` |
| `decision` | `active`, `superseded` |

## `action_items.list`

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

**Чтение** · выполняется через [`talkbar_read`](/mcp/tools#talkbar_read) · переключатель MCP по умолчанию **Вкл.** · группа политики `content`

**Аргументы**


**sessionId** (string)

  Только элементы этой сессии. Если он указан, `projectId`, `seriesId`, `generalOnly` и `includeStopped` игнорируются.

**projectId** (string)

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

**seriesId** (string)

  Только элементы этой серии.

**generalOnly** (boolean)

  Только элементы раздела «Общее» (не привязанные к проекту). Нельзя сочетать с `projectId` или `seriesId`.

**itemTypes** (string[])

  Только эти типы: `task`, `follow_up`, `question`, `decision`.

**statuses** (string[])

  Только эти статусы: `open`, `done`, `answered`, `active`, `superseded`.

**contactIds** (string[])

  Только элементы, назначенные этим людям.

**text** (string)

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

**includeStopped** (boolean)

  Показывать также перенесённые элементы, перенос которых остановлен.

**limit** (integer)

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



**Возвращает:** `{items: [{itemId, itemType, label, title, status, dueAtMs, sessionId, sessionTitle, projectId, assignees, anchor, updatedAt}]}`. `anchor` (`{turnId, pointId, atMs}` или `null`) — момент, к которому привязан элемент.

- Завершённые элементы (выполненные, получившие ответ, заменённые) идут в конце. Значения типа и статуса, не входящие в списки выше, ничему не соответствуют.

```json
{"tool": "action_items.list", "args": {"projectId": "proj_456", "statuses": ["open"]}}
```

## `action_items.get`

Читает одну задачу с подробностями, исполнителями, статусом и источниками.

**Чтение** · выполняется через [`talkbar_read`](/mcp/tools#talkbar_read) · переключатель MCP по умолчанию **Вкл.** · группа политики `content`

**Аргументы**


**itemId** (string, required)

  Задача из `action_items.list`.



**Возвращает:** `{itemId, itemType, labelId, label, title, details, status, dueAtMs, answer, sessionId, sessionTitle, projectId, assignees: [{name, contactId}], origin, sources, resolvedAtMs, createdAt, updatedAt}`. `sources` перечисляет цитаты и моменты, из которых появился элемент.

## `action_items.create`

Добавляет задачу в сессию, проект или раздел «Общее». Работает и во время записи, задача появляется сразу.

**Изменение** · выполняется через [`talkbar_change`](/mcp/tools#talkbar_change) · переключатель MCP по умолчанию **Выкл.** · группа политики `contentChanges`

**Аргументы**


**title** (string, required)

  Что нужно сделать. Не может быть пустым.

**sessionId** (string)

  Добавить в эту сессию. Без `projectId` элемент получает проект сессии.

**projectId** (string)

  Добавить в этот проект. Если не указан ни `sessionId`, ни `projectId`, элемент попадает в раздел «Общее».

**itemType** (string)

  Одно из значений: `task`, `follow_up`, `question`, `decision`. По умолчанию `task`.

**labelId** (string)

  Идентификатор метки элемента (например, «Идея» или «Препятствие»); `labelId` элемента показывает `action_items.get`. Каждая метка относится к одному типу элементов.

**details** (string)

  Подробности.

**status** (string)

  Одно из значений `open`, `done`, `answered`, `active`, `superseded`, допустимых для этого типа. По умолчанию `open` (`active` для решения).

**dueAtMs** (integer | null)

  Срок как время Unix в мс (только для задач и напоминаний). `null` — без срока.

**answer** (string)

  Ответ (только для вопросов).

**assignees** ((string | object)[])

  Для кого элемент: имена или объекты `{name, contactId}` с непустым `name`.

**turnId** (string)

  Реплика транскрипта (`sessions.transcript` с `format: "json"`). Привязывает элемент к моменту его сессии. Требует `sessionId`.

**chunkId** (string)

  Фрагмент текущего транскрипта (`sessions.transcript` с `format: "json"`). Привязывает элемент к моменту его сессии. Требует `sessionId`.

**pointId** (string)

  Пункт хронологии (`sessions.timeline`). Нельзя сочетать с `turnId` или `chunkId`. Привязывает элемент к моменту его сессии. Требует `sessionId`.

**atMs** (integer)

  Момент в мс от начала сессии. Вместе с репликой, фрагментом или пунктом он должен попадать внутрь них; во время записи он не может быть позже текущего момента. Привязывает элемент к моменту его сессии. Требует `sessionId`.

**quote** (string)

  Слова, к которым относится элемент. Если указан только он, находится та единственная реплика, в которой есть эти слова. Привязывает элемент к моменту его сессии. Требует `sessionId`.



**Возвращает:** элемент в том же виде, что и `action_items.get`; для сессии — также `sessionStatus` (и `warning`, если сессия была прервана или TalkBar не запущен).

- Идентификатор, которого нет в сессии, отклоняется с `invalid_arguments`.
- Срок у вопроса или решения, а также ответ у чего-либо, кроме вопроса, отклоняются.
- Элемент сохраняет и момент, и идентификаторы, поэтому приложение правильно размещает его и после улучшения транскрипта.

```json
{"tool": "action_items.create", "args": {"sessionId": "ses_123", "title": "Send revised quote", "itemType": "follow_up", "assignees": ["Dana Lee"], "quote": "send you a revised quote"}}
```

## `action_items.update`

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

**Изменение** · выполняется через [`talkbar_change`](/mcp/tools#talkbar_change) · переключатель MCP по умолчанию **Выкл.** · группа политики `contentChanges`

**Аргументы**


**itemId** (string, required)

  Задача из `action_items.list`.

**title** (string)

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

**details** (string | null)

  Подробности. `null` очищает их.

**itemType** (string)

  Одно из значений: `task`, `follow_up`, `question`, `decision`.

**labelId** (string)

  Идентификатор метки элемента (например, «Идея» или «Препятствие»); `labelId` элемента показывает `action_items.get`. Каждая метка относится к одному типу элементов.

**status** (string)

  Одно из значений `open`, `done`, `answered`, `active`, `superseded`, допустимых для этого типа.

**dueAtMs** (integer | null)

  Срок как время Unix в мс. `null` очищает его.

**answer** (string | null)

  Ответ (только для вопросов). `null` очищает его.

**assignees** ((string | object)[])

  Заменяет исполнителей: имена или объекты `{name, contactId}`.



**Возвращает:** элемент в том же виде, что и `action_items.get`.

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

## `action_items.set_status`

Завершает задачу или снова открывает её, при желании с ответом.

**Изменение** · выполняется через [`talkbar_change`](/mcp/tools#talkbar_change) · переключатель MCP по умолчанию **Выкл.** · группа политики `contentChanges`

**Аргументы**


**itemId** (string, required)

  Задача из `action_items.list`.

**status** (string, required)

  Новый статус. Задачи и напоминания: `open` или `done`. Вопросы: `open` или `answered`. Решения: `active` или `superseded`.

**answer** (string)

  Ответ, который нужно сохранить (для вопросов).



**Возвращает:** элемент в том же виде, что и `action_items.get`.

- Статус, недопустимый для этого типа, отклоняется с `invalid_arguments` и списком допустимых статусов.

```json
{"tool": "action_items.set_status", "args": {"itemId": "ai_42", "status": "done"}}
```

## `action_items.remove`

Убирает задачу с её доски так же, как приложение: задача, добавленная вами, удаляется, а задача из итогов скрывается.

**Изменение** · выполняется через [`talkbar_delete`](/mcp/tools#talkbar_delete) · переключатель MCP по умолчанию **Выкл.** · группа политики `contentChanges`

**Аргументы**


**itemId** (string, required)

  Задача из `action_items.list`.



**Возвращает:** `{removed: true, itemId, sessionId, projectId}`, а также `sessionStatus` для задачи сессии.

- У задач нет корзины: повторный вызов возвращает `not_found`.
- Выполняется через `talkbar_delete`: [требует вашего подтверждения](/mcp/access-and-permissions#подтверждение-удаления), если ваше ИИ-приложение умеет его запрашивать; запросы приложений, которые не умеют, отклоняются, если не включён параметр **Разрешить удаление без подтверждения**.

## См. также

- [Справочник операций](/mcp/operations)
- [Сессии](/mcp/operations/sessions)
- [Задачи в приложении](/knowledge/action-items)