# Các công cụ Ghi nhớ

> Lưu văn bản hoặc liên kết, liệt kê những gì bạn đã lưu và quên mục đã lưu từ ứng dụng khách MCP hoặc bằng lệnh dvina.

Với các công cụ MCP của Dvina hoặc lệnh `dvina`, một ứng dụng khác có thể ghi nhớ nội dung giúp bạn, giống như khi bạn chọn **Lưu** trong Dvina. Nội dung được lưu là của bạn: nội dung đó xuất hiện trong mục **Đã lưu** trên Bảng tin của bạn, Dvina tìm được khi bạn hỏi và có thể dùng nội dung đó để nhắc lại khi cần. Để tìm hiểu về tính năng Ghi nhớ, hãy xem [Ghi nhớ](/docs/use-dvina/features/keep-in-mind).

## Các công cụ

| Công cụ MCP   | Lệnh          | Chức năng                                                    | Hỏi trước |
| ---------- | ---------------- | --------------------------------------------------------------- | ---------- |
| `kept_add` | `dvina kept add` | Lưu văn bản hoặc liên kết.                                          | Không         |
| `kept_ls`  | `dvina kept ls`  | Liệt kê những gì bạn đã lưu, mới nhất trước, hoặc chỉ những mục khớp với một từ. | Không         |
| `kept_rm`  | `dvina kept rm`  | Quên một mục bạn đã lưu. Mục đó được chuyển vào **Đã xóa gần đây**.   | Có        |

## Lưu văn bản hoặc liên kết

`kept_add` lưu văn bản, liên kết hoặc văn bản kèm liên kết nguồn. Cung cấp ít nhất `text` hoặc `url`.

| Đầu vào       | Ý nghĩa                                                               | Giới hạn            |
| ----------- | ------------------------------------------------------------------------ | ---------------- |
| `text`      | Văn bản cần lưu.                                                       | 5,000 ký tự |
| `url`       | Trang hoặc liên kết nguồn của văn bản, hoặc liên kết cần lưu. Chỉ hỗ trợ http(s). | 2,048 ký tự |
| `title`     | Tiêu đề của nguồn, chẳng hạn như tiêu đề trang hoặc tài liệu.     | 500 ký tự   |
| `sourceApp` | Ứng dụng nguồn, chẳng hạn như tên ứng dụng khách MCP của bạn.                 | 200 ký tự   |

Công cụ trả về `id`, `kind` (`text` hoặc `link`) và `title` của mục đã lưu.

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

Lưu lại cùng một văn bản từ cùng một nguồn sẽ không tạo thêm mục thứ hai.

## Liệt kê những gì bạn đã lưu

`kept_ls` liệt kê các mục bạn đã lưu, mới nhất trước.

| Đầu vào    | Ý nghĩa                                        |
| -------- | ------------------------------------------------- |
| `query`  | Chỉ lấy những mục có văn bản, tiêu đề hoặc liên kết chứa nội dung này. |
| `limit`  | Số mục cần trả về, tối đa 100. Mặc định là 20. |
| `cursor` | Vị trí kết thúc của trang trước, dùng để lấy trang tiếp theo.  |

Mỗi mục có `id`, `kind` (`text`, `image` hoặc `link`), `title`, `text`, `url`, `sourceType` (nơi mục được lưu, chẳng hạn như `chat` hoặc `mcp`), `sourceApp` và `createdAt`. Khi còn mục khác, kết quả có `nextCursor`; khi dùng lệnh, danh sách kết thúc bằng `next: --cursor <c>`.

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

## Quên một mục bạn đã lưu

`kept_rm` quên một mục đã lưu dựa trên `id` của mục đó. Giống như các thay đổi khác, công cụ sẽ hỏi bạn trước: Dvina hiển thị tiêu đề của mục để bạn chấp thuận hoặc từ chối. Khi bạn chấp thuận, mục đó được chuyển vào **Đã xóa gần đây**, nơi bạn có thể khôi phục mục trong vòng 30 ngày.

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

## Những điều cần biết

- Các công cụ hoạt động thay mặt bạn, trên các mục bạn đã lưu, trong phạm vi quyền mà vai trò của bạn cho phép.
- Nội dung do ứng dụng khách lưu được xử lý theo các quy tắc bảo vệ dữ liệu của công ty bạn, giống như trong ứng dụng. Nếu một quy tắc không cho phép, nội dung sẽ không được lưu và ứng dụng khách sẽ nhận được lý do.
- Các công cụ này chưa hỗ trợ lưu hình ảnh. Hãy lưu hình ảnh trong Dvina hoặc từ bảng chia sẻ trên điện thoại của bạn.

## Nội dung liên quan

- [Ghi nhớ](/docs/use-dvina/features/keep-in-mind)
- [Sử dụng Dvina từ các ứng dụng khác với MCP](/docs/dvina-mcp/overview)
- [Sử dụng lệnh dvina](/docs/dvina-mcp/cli)