# Folosește comanda dvina

> Află ce face comanda dvina când Dvina rulează cod pentru tine, ce comenzi include și care dintre ele îți cer aprobarea.

Când Dvina rulează cod sau comenzi pentru tine, are la dispoziție propria comandă: `dvina`. Cu ajutorul ei, un script sau o serie de pași poate căuta în Dvina, poate citi și adăuga documente, fișiere de memorie și sarcini și poate verifica cine are acces la un element, în numele tău.

Nu trebuie să instalezi nimic sau să te autentifici. Dvina folosește comanda când cererea ta o impune, dar poți cere și tu să o folosească, de exemplu: „Folosește dvina ca să listezi sarcinile mele și să scrii un rezumat sub formă de notă.”

## Cum funcționează

- `dvina` lucrează în Dvina ta, în numele tău, cu permisiunile rolului tău și în limitele tale obișnuite.
- Accesul său durează doar cât timp Dvina lucrează la cererea ta. După încheierea răspunsului, comanda nu mai poate accesa Dvina ta.
- Citește un fișier sau un dosar doar dacă o comandă îl specifică, de exemplu un fișier de încărcat.

## Comenzi

Comenzile sunt organizate în grupuri: `dvina <group> <command>`, urmate de argumentele și opțiunile comenzii.

| Grup       | Comenzi                                                                                                                  |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: caută simultan în conversațiile, documentele, memoria și lumea ta.                                 |
| `memory`   | `ls`, `show`, `add`, `edit`: listează, citește, adaugă sau modifică fișierele tale de memorie.                               |
| `world`    | `topics`, `topic`, `recall`, `feed`: subiectele tale, ce știe Dvina despre ceva și Feed-ul tău.                             |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: documentele și dosarele din Library.      |
| `canvas`   | `ls`, `show`, `create`, `write-page`: listează, citește, creează sau rescrie pagini canvas.                                 |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: sarcinile tale din fundal.                                                       |
| `goals`    | `show`, `start`: sarcini care urmăresc atingerea unui obiectiv.                                                            |
| `schedule` | `ls`, `add`, `cancel`: mesaje și mementouri programate, unice sau recurente.                                                |
| `agents`   | `ls`, `show`, `create`, `update`: agenții tăi.                                                                             |
| `skills`   | `ls`, `show`, `add`, `edit`: abilitățile tale.                                                                             |
| `projects` | `ls`, `show`: proiectele tale.                                                                                           |
| `settings` | `get`, `set`: preferințele tale, cum ar fi activarea sau dezactivarea memoriei.                                            |
| `share`    | `state`, `with-me`, `add`, `rm`: cine are acces la un element, ce au partajat alții cu tine și acordarea sau retragerea accesului. |

`dvina` nu poate șterge nimic definitiv, deschide linkuri publice, conecta sau deconecta aplicații ori modifica setările de administrare sau facturare.

### Ajutor și rezultate

- `dvina --help` listează grupurile, `dvina <group> --help` listează comenzile unui grup, iar `dvina <group> <command> --help` listează argumentele și opțiunile unei comenzi.
- Rezultatele sunt afișate ca text scurt. Adaugă `--json` pentru formatul JSON sau `--fields` cu o listă separată prin virgule, de exemplu `--fields id,title`, pentru a păstra doar anumite câmpuri.
- O listă lungă se încheie cu `next: --cursor <c>`. Rulează din nou comanda cu acel `--cursor` pentru a obține pagina următoare.
- Pentru a citi o valoare dintr-un fișier, adaugă `-file` la opțiunea corespunzătoare, de exemplu `--content-file notes.md`. `dvina docs upload <file>` încarcă un fișier, iar `dvina skills add <folder>` adaugă un dosar de abilitate împreună cu fișierul său SKILL.md.

### Coduri de ieșire

| Cod  | Semnificație                                                                  |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Finalizat.                                                                    |
| `1`  | A apărut o altă eroare.                                                        |
| `2`  | Comanda este greșită. Consultă `--help` pentru acea comandă.                    |
| `3`  | Nu a fost găsit.                                                              |
| `4`  | Refuzat: drepturile tale de acces, regulile companiei sau protecția datelor nu permit acest lucru. |
| `5`  | Este necesară aprobarea ta.                                                   |
| `6`  | Ai atins limita de utilizare.                                                 |

## Aprobă modificările

- Comenzile de citire rulează fără să îți ceară aprobarea.
- Comenzile care adaugă ceva nou, precum `docs create`, `memory add` sau `tasks start`, rulează fără să îți ceară aprobarea. Nu modifică niciodată ceea ce există deja.
- Comenzile care modifică sau elimină ceva îți cer mai întâi aprobarea: mutarea, redenumirea, mutarea în coșul de gunoi, înlocuirea unei note sau a unui fișier de memorie, rescrierea unei pagini canvas, modificarea unui agent sau a unei abilități, oprirea unei sarcini, anularea unui mesaj programat și partajarea. Dvina afișează în conversație un card de aprobare cu propriul rezumat al modificării și îți cere aprobarea de fiecare dată. Dacă refuzi, nu se schimbă nimic.

Tot ce adaugă sau modifică `dvina` trece prin regulile de protecție a datelor ale companiei tale și este înregistrat în [jurnalul de audit](/docs/teams/audit-log), la fel ca celelalte acțiuni ale Dvina.

## Articole conexe

- [Folosește Dvina din alte aplicații cu MCP](/docs/dvina-mcp/overview)
- [Sarcini](/docs/use-dvina/features/tasks)
- [Prezentarea conectorilor](/docs/connectors/overview)