# Инструменты «Запомнить»

> Сохраняйте текст или ссылки, просматривайте сохранённое и удаляйте его из памяти через MCP-клиент или команду dvina.

С помощью MCP-инструментов Dvina или команды `dvina` другое приложение может сохранить что-то в памяти для вас — так же, как если бы вы выбрали **Сохранить** в Dvina. Всё сохранённое принадлежит вам: оно появляется в разделе **Сохранённое** вашей ленты, Dvina находит его по вашему запросу и может использовать, чтобы напомнить о нём в нужный момент. Подробнее о самой функции см. в разделе [Запомнить](/docs/use-dvina/features/keep-in-mind).

## Инструменты

| MCP-инструмент   | Команда          | Что делает                                                    | Запрашивает подтверждение |
| ---------- | ---------------- | --------------------------------------------------------------- | ---------- |
| `kept_add` | `dvina kept add` | Сохраняет текст или ссылку.                                          | Нет         |
| `kept_ls`  | `dvina kept ls`  | Показывает сохранённое, начиная с самого нового, или только записи с указанным словом. | Нет         |
| `kept_rm`  | `dvina kept rm`  | Удаляет сохранённую запись из памяти. Она перемещается в **Недавно удалённые**.   | Да        |

## Сохраните текст или ссылку

`kept_add` сохраняет текст, ссылку или текст вместе со ссылкой на его источник. Укажите хотя бы `text` или `url`.

| Параметр       | Описание                                                               | Ограничение            |
| ----------- | ------------------------------------------------------------------------ | ---------------- |
| `text`      | Текст, который нужно сохранить.                                                       | 5,000 символов |
| `url`       | Страница или ссылка, откуда взят текст, либо ссылка, которую нужно сохранить. Только http(s). | 2,048 символов |
| `title`     | Название источника, например страницы или документа.     | 500 символов   |
| `sourceApp` | Приложение-источник, например название вашего MCP-клиента.                 | 200 символов   |

Инструмент возвращает `id` сохранённой записи, её `kind` (`text` или `link`) и `title`.

```sh
dvina kept add "Bright & Co. includes permits and can start Nov 17." --url https://example.com/quote --title "Kitchen quote"
```

Повторное сохранение того же текста из того же источника не создаёт вторую запись.

## Просмотрите сохранённое

`kept_ls` показывает сохранённые записи, начиная с самых новых.

| Параметр    | Описание                                        |
| -------- | ------------------------------------------------- |
| `query`  | Только записи, в тексте, названии или ссылке которых есть указанное значение. |
| `limit`  | Количество возвращаемых записей, не более 100. По умолчанию — 20. |
| `cursor` | Место, где закончилась предыдущая страница, для получения следующей.  |

У каждой записи есть `id`, `kind` (`text`, `image` или `link`), `title`, `text`, `url`, `sourceType` (где она была сохранена, например `chat` или `mcp`), `sourceApp` и `createdAt`. Если есть ещё записи, результат содержит `nextCursor`; при использовании команды список заканчивается строкой `next: --cursor <c>`.

```sh
dvina kept ls --query permits --limit 5
```

## Удалите сохранённое из памяти

`kept_rm` удаляет из памяти одну сохранённую запись по её `id`. Как и другие изменения, это действие требует вашего подтверждения: Dvina показывает название записи, а вы подтверждаете или отклоняете действие. После подтверждения запись перемещается в **Недавно удалённые**, откуда её можно восстановить в течение 30 дней.

```sh
dvina kept rm <id>
```

## Что нужно учитывать

- Инструменты действуют от вашего имени и работают с вашими сохранёнными записями в пределах прав вашей роли.
- Данные, которые сохраняет клиент, проходят проверку по правилам защиты данных вашей компании, как и в приложении. Если правило запрещает сохранение, ничего не сохраняется, а клиент получает причину отказа.
- Эти инструменты не поддерживают сохранение изображений. Сохраняйте изображения в Dvina или через меню «Поделиться» на телефоне.

## См. также

- [Запоминание информации](/docs/use-dvina/features/keep-in-mind)
- [Используйте Dvina из других приложений через MCP](/docs/dvina-mcp/overview)
- [Используйте команду dvina](/docs/dvina-mcp/cli)
