# Bruk dvina-kommandoen

> Finn ut hva dvina-kommandoen gjør når Dvina kjører kode for deg, hvilke kommandoer den har, og hvilke som ber om godkjenning.

Når Dvina kjører kode eller kommandoer for deg, har den sin egen kommando: `dvina`. Med den kan et skript eller flere trinn etter hverandre søke i din Dvina, lese og legge til dokumenter, minner og oppgaver, og sjekke hvem som har tilgang til et element – på dine vegne.

Du trenger ikke å installere noe eller logge inn. Dvina bruker kommandoen når forespørselen din krever det, og du kan også be om det, for eksempel: «Bruk dvina til å liste opp oppgavene mine og skrive et sammendrag som et notat.»

## Slik fungerer det

- `dvina` fungerer i din egen Dvina, på dine vegne, med tillatelsene rollen din gir og innenfor de vanlige grensene dine.
- Tilgangen varer bare mens Dvina jobber med forespørselen din. Når svaret er ferdig, har kommandoen ikke lenger tilgang til din Dvina.
- Den leser bare en fil eller mappe når en kommando angir den, for eksempel en fil som skal lastes opp.

## Kommandoer

Kommandoene er delt inn i grupper: `dvina <group> <command>`, etterfulgt av kommandoens argumenter og flagg.

| Gruppe     | Kommandoer                                                                                                               |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: søk i samtalene, dokumentene, minnene og verdenen din samtidig.                                  |
| `memory`   | `ls`, `show`, `add`, `edit`: list opp, les, legg til eller endre minnefilene dine.                                        |
| `world`    | `topics`, `topic`, `recall`, `feed`: emnene dine, det Dvina vet om noe, og din Feed.                                     |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: dokumentene og mappene dine i Library. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: list opp, les, opprett eller skriv om canvas-sider.                                 |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: bakgrunnsoppgavene dine.                                                      |
| `goals`    | `show`, `start`: oppgaver som jobber mot et mål.                                                                         |
| `schedule` | `ls`, `add`, `cancel`: planlagte meldinger og påminnelser, én gang eller gjentakende.                                    |
| `agents`   | `ls`, `show`, `create`, `update`: agentene dine.                                                                         |
| `skills`   | `ls`, `show`, `add`, `edit`: ferdighetene dine.                                                                          |
| `projects` | `ls`, `show`: prosjektene dine.                                                                                         |
| `settings` | `get`, `set`: innstillingene dine, som å slå minnet på eller av.                                                         |
| `share`    | `state`, `with-me`, `add`, `rm`: hvem som har tilgang til et element, hva andre har delt med deg, og å gi eller fjerne tilgang. |

`dvina` kan ikke slette noe permanent, åpne offentlige lenker, koble til eller fra apper eller endre administrator- eller faktureringsinnstillinger.

### Hjelp og utdata

- `dvina --help` viser gruppene, `dvina <group> --help` viser kommandoene i en gruppe, og `dvina <group> <command> --help` viser argumentene og flaggene for en kommando.
- Utdataene er kort tekst. Legg til `--json` for JSON, eller `--fields` med en kommaseparert liste, som `--fields id,title`, for å beholde bare noen av feltene.
- En lang liste slutter med `next: --cursor <c>`. Kjør kommandoen på nytt med denne `--cursor` for å hente neste side.
- For å lese en verdi fra en fil legger du til `-file` i flagget, som i `--content-file notes.md`. `dvina docs upload <file>` laster opp en fil, og `dvina skills add <folder>` legger til en ferdighetsmappe med tilhørende SKILL.md.

### Avslutningskoder

| Kode | Betydning                                                                     |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Ferdig.                                                                       |
| `1`  | Noe annet gikk galt.                                                          |
| `2`  | Kommandoen er feil. Sjekk `--help` for kommandoen.                              |
| `3`  | Ikke funnet.                                                                  |
| `4`  | Avvist: tilgangen din, bedriftens regler eller databeskyttelsen tillater det ikke. |
| `5`  | Krever din godkjenning.                                                        |
| `6`  | Du har nådd bruksgrensen din.                                                  |

## Godkjenn endringer

- Kommandoer som leser, kjøres uten å spørre.
- Kommandoer som legger til noe nytt, som `docs create`, `memory add` eller `tasks start`, kjøres uten å spørre. De endrer aldri det som allerede finnes.
- Kommandoer som endrer eller fjerner noe, spør deg først: flytting, endring av navn, flytting til papirkurven, erstatning av et notat eller en minnefil, omskriving av en canvas-side, endring av en agent eller ferdighet, stopp av en oppgave, avbestilling av en planlagt melding og deling. Dvina viser et godkjenningskort i samtalen med sitt eget sammendrag av endringen, og spør hver gang. Hvis du avslår, endres ingenting.

Det `dvina` legger til eller endrer, går gjennom bedriftens regler for databeskyttelse og registreres i [revisjonsloggen](/docs/teams/audit-log), på samme måte som Dvinas andre handlinger.

## Relatert

- [Bruk Dvina fra andre apper med MCP](/docs/dvina-mcp/overview)
- [Oppgaver](/docs/use-dvina/features/tasks)
- [Oversikt over koblinger](/docs/connectors/overview)
