# Pidä mielessä -työkalut

> Tallenna tekstiä tai linkki, luettele tallentamasi kohteet ja unohda kohteita MCP-asiakasohjelmasta tai dvina-komennolla.

Dvinan MCP-työkalujen tai `dvina`-komennon avulla toinen sovellus voi tallentaa asioita muistiin puolestasi, aivan kuten valitsemalla Dvinassa **Tallenna**. Tallennetut kohteet ovat omiasi: ne näkyvät syötteesi **Tallennetut**-osiossa, Dvina löytää ne, kun kysyt, ja ne voivat auttaa Dvinaa tuomaan asiat esiin silloin, kun niillä on merkitystä. Lisätietoja itse ominaisuudesta on sivulla [Pidä mielessä](/docs/use-dvina/features/keep-in-mind).

## Työkalut

| MCP-työkalu   | Komento          | Mitä se tekee                                                    | Kysyy ensin |
| ---------- | ---------------- | --------------------------------------------------------------- | ---------- |
| `kept_add` | `dvina kept add` | Tallentaa tekstiä tai linkin.                                          | Ei         |
| `kept_ls`  | `dvina kept ls`  | Luettelee tallentamasi kohteet uusimmasta alkaen tai vain ne, jotka vastaavat hakusanaa. | Ei         |
| `kept_rm`  | `dvina kept rm`  | Unohtaa tallentamasi kohteen. Se siirtyy **Äskettäin poistetut** -osioon.   | Kyllä        |

## Tallenna tekstiä tai linkki

`kept_add` tallentaa tekstiä, linkin tai tekstiä ja linkin, josta teksti on peräisin. Anna vähintään `text` tai `url`.

| Syöte       | Mitä se tarkoittaa                                                               | Enimmäispituus            |
| ----------- | ------------------------------------------------------------------------ | ---------------- |
| `text`      | Tallennettava teksti.                                                       | 5,000 merkkiä |
| `url`       | Sivu tai linkki, josta teksti on peräisin, tai tallennettava linkki. Vain http(s). | 2,048 merkkiä |
| `title`     | Lähteen otsikko, esimerkiksi sivun tai asiakirjan otsikko.     | 500 merkkiä   |
| `sourceApp` | Sovellus, josta kohde on peräisin, esimerkiksi MCP-asiakasohjelmasi nimi.                 | 200 merkkiä   |

Se palauttaa tallennetun kohteen `id`-tunnisteen, `kind`-tyypin (`text` tai `link`) ja `title`-otsikon.

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

Saman tekstin tallentaminen samasta lähteestä uudelleen ei luo toista kohdetta.

## Luettele tallentamasi kohteet

`kept_ls` luettelee tallentamasi kohteet uusimmasta alkaen.

| Syöte    | Mitä se tarkoittaa                                        |
| -------- | ------------------------------------------------- |
| `query`  | Vain kohteet, joiden teksti, otsikko tai linkki sisältää hakusanan. |
| `limit`  | Palautettavien kohteiden määrä, enintään 100. Oletus on 20. |
| `cursor` | Edellisen sivun päättymiskohta seuraavan sivun hakemista varten.  |

Jokaisella kohteella on `id`, `kind` (`text`, `image` tai `link`), `title`, `text`, `url`, `sourceType` (missä kohde tallennettiin, esimerkiksi `chat` tai `mcp`), `sourceApp` ja `createdAt`. Kun kohteita on lisää, tuloksessa on `nextCursor`; komentoa käytettäessä luettelo päättyy merkintään `next: --cursor <c>`.

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

## Unohda tallentamasi kohde

`kept_rm` unohtaa yhden tallennetun kohteen sen `id`-tunnisteen perusteella. Kuten muutkin muutokset, se pyytää ensin hyväksyntäsi: Dvina näyttää kohteen otsikon, ja voit hyväksyä tai hylätä muutoksen. Kun hyväksyt muutoksen, kohde siirtyy **Äskettäin poistetut** -osioon, josta voit palauttaa sen 30 päivän ajan.

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

## Huomioitavaa

- Työkalut toimivat sinun nimissäsi ja käsittelevät omia tallennettuja kohteitasi roolisi sallimissa rajoissa.
- Asiakasohjelman tallentamiin kohteisiin sovelletaan yrityksesi tietosuojasääntöjä samalla tavalla kuin sovelluksessa. Jos jokin sääntö estää tallentamisen, mitään ei tallenneta ja asiakasohjelma saa tiedon syystä.
- Näillä työkaluilla ei voi tallentaa kuvia. Tallenna kuvat Dvinassa tai puhelimesi jakovalikosta.

## Aiheeseen liittyvää

- [Pidä mielessä](/docs/use-dvina/features/keep-in-mind)
- [Käytä Dvinaa muista sovelluksista MCP:n avulla](/docs/dvina-mcp/overview)
- [Käytä dvina-komentoa](/docs/dvina-mcp/cli)