# Käytä dvina-komentoa

> Lue, mitä dvina-komento tekee, kun Dvina suorittaa koodia puolestasi, mitä komentoja siihen kuuluu ja mitkä niistä pyytävät hyväksyntääsi.

Kun Dvina suorittaa koodia tai komentoja puolestasi, sillä on käytössään oma komento: `dvina`. Sen avulla skripti tai muutama peräkkäinen vaihe voi tehdä hakuja Dvinastasi, lukea ja lisätä dokumentteja, muistia ja tehtäviä sekä tarkistaa, kenellä on pääsy kohteeseen – sinun nimissäsi.

Sinun ei tarvitse asentaa mitään tai kirjautua sisään. Dvina käyttää komentoa, kun pyyntösi sitä edellyttää. Voit myös pyytää sitä esimerkiksi näin: ”Käytä dvina-komentoa tehtävieni listaamiseen ja kirjoita niistä yhteenveto muistiinpanoksi.”

## Näin se toimii

- `dvina` toimii omassa Dvinassasi sinun nimissäsi, roolisi sallimilla oikeuksilla ja tavallisten käyttörajojesi puitteissa.
- Sen käyttöoikeus kestää vain sen ajan, kun Dvina käsittelee pyyntöäsi. Kun vastaus päättyy, komento ei enää pääse Dvinaasi.
- Se lukee tiedoston tai kansion vain, jos se on nimetty komennossa, kuten ladattava tiedosto.

## Komennot

Komennot on jaettu ryhmiin: `dvina <group> <command>`, jonka jälkeen tulevat komennon argumentit ja valitsimet.

| Ryhmä      | Komennot                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: hae keskusteluistasi, dokumenteistasi, muististasi ja maailmastasi kerralla.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: listaa, lue, lisää tai muuta muistitiedostojasi.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: aiheesi, mitä Dvina tietää jostakin ja Feed.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: Libraryn dokumentit ja kansiot. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: listaa, lue, luo tai kirjoita uudelleen canvas-sivuja.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: taustatehtäväsi.                                                        |
| `goals`    | `show`, `start`: tehtävät, jotka edistävät tavoitetta.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: ajastetut viestit ja muistutukset, kertaluonteisina tai toistuvina.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: agenttisi.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: taitosi.                                                                                |
| `projects` | `ls`, `show`: projektisi.                                                                                             |
| `settings` | `get`, `set`: asetuksesi, kuten muistin ottaminen käyttöön tai poistaminen käytöstä.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: kenellä on pääsy kohteeseen, mitä muut ovat jakaneet kanssasi sekä käyttöoikeuksien antaminen tai poistaminen.  |

`dvina` ei voi poistaa mitään pysyvästi, avata julkisia linkkejä, yhdistää sovelluksia tai katkaista niiden yhteyksiä eikä muuttaa ylläpito- tai laskutusasetuksia.

### Ohje ja tuloste

- `dvina --help` listaa ryhmät, `dvina <group> --help` listaa ryhmän komennot ja `dvina <group> <command> --help` listaa komennon argumentit ja valitsimet.
- Tuloste on lyhyttä tekstiä. Lisää `--json`, jos haluat JSON-muotoisen tulosteen. Jos haluat vain tietyt kentät, lisää `--fields` ja pilkuilla erotettu luettelo, kuten `--fields id,title`.
- Pitkän luettelon lopussa on `next: --cursor <c>`. Suorita komento uudelleen kyseisellä `--cursor`-valitsimella, niin saat seuraavan sivun.
- Jos haluat lukea arvon tiedostosta, lisää sen valitsimeen `-file`, kuten `--content-file notes.md`. `dvina docs upload <file>` lataa tiedoston, ja `dvina skills add <folder>` lisää taitokansion ja sen SKILL.md-tiedoston.

### Paluukoodit

| Koodi | Merkitys                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Valmis.                                                                         |
| `1`  | Jokin muu meni pieleen.                                                    |
| `2`  | Komento on virheellinen. Tarkista sen `--help`.                                     |
| `3`  | Ei löytynyt.                                                                    |
| `4`  | Estetty: käyttöoikeutesi, yrityksesi säännöt tai tietosuoja eivät salli toimintoa. |
| `5`  | Tarvitsee hyväksyntäsi.                                                       |
| `6`  | Olet saavuttanut käyttörajasi.                                              |

## Hyväksy muutokset

- Komennot, jotka lukevat tietoja, suoritetaan kysymättä.
- Komennot, jotka lisäävät jotakin uutta, kuten `docs create`, `memory add` tai `tasks start`, suoritetaan kysymättä. Ne eivät koskaan muuta olemassa olevaa sisältöä.
- Komennot, jotka muuttavat tai poistavat jotakin, pyytävät ensin hyväksyntäsi: siirtäminen, uudelleennimeäminen, roskakoriin siirtäminen, muistiinpanon tai muistitiedoston korvaaminen, canvas-sivun uudelleenkirjoittaminen, agentin tai taidon muuttaminen, tehtävän pysäyttäminen, ajastetun viestin peruuttaminen ja jakaminen. Dvina näyttää keskustelussa hyväksyntäkortin, jossa on sen laatima yhteenveto muutoksesta, ja pyytää hyväksyntää joka kerta. Jos hylkäät pyynnön, mikään ei muutu.

Kaikki, mitä `dvina` lisää tai muuttaa, käsitellään yrityksesi tietosuojasääntöjen mukaisesti ja kirjataan [tapahtumalokiisi](/docs/teams/audit-log), kuten Dvinan muutkin toiminnot.

## Aiheeseen liittyvää

- [Käytä Dvinaa muista sovelluksista MCP:n avulla](/docs/dvina-mcp/overview)
- [Tehtävät](/docs/use-dvina/features/tasks)
- [Yleiskatsaus liittimiin](/docs/connectors/overview)