Dvina MCP

Usa il comando dvina

Scopri cosa fa il comando dvina quando Dvina esegue codice per te, quali comandi include e quali richiedono la tua approvazione.

Vedi in Markdown

Quando Dvina esegue codice o comandi per te, dispone di un comando dedicato: dvina. Con questo comando, uno script o una sequenza di passaggi può cercare nel tuo Dvina, leggere e aggiungere documenti, memoria e attività e verificare chi ha accesso a un elemento, agendo a tuo nome.

Non devi installare nulla né accedere a un account. Dvina usa il comando quando la tua richiesta lo richiede, ma puoi anche chiederlo esplicitamente, ad esempio: "Usa dvina per elencare le mie attività e scrivere un riepilogo come nota."

Come funziona

  • dvina opera nel tuo Dvina, a tuo nome, con le autorizzazioni del tuo ruolo e nei tuoi limiti abituali.
  • L'accesso dura solo mentre Dvina lavora alla tua richiesta. Al termine della risposta, il comando non può più accedere al tuo Dvina.
  • Legge un file o una cartella solo quando un comando li indica esplicitamente, ad esempio un file da caricare.

Comandi

I comandi sono organizzati in gruppi: dvina <group> <command>, seguito dagli argomenti e dalle opzioni del comando.

Gruppo Comandi
search dvina search <query>: cerca contemporaneamente nelle tue chat, nei documenti, nella memoria e nel mondo.
memory ls, show, add, edit: elenca, leggi, aggiungi o modifica i tuoi file di memoria.
world topics, topic, recall, feed: i tuoi argomenti, ciò che Dvina sa su qualcosa e il tuo Feed.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: i documenti e le cartelle della tua Library.
canvas ls, show, create, write-page: elenca, leggi, crea o riscrivi le pagine dei canvas.
tasks ls, show, start, continue, stop: le tue attività in background.
goals show, start: attività che lavorano per raggiungere un obiettivo.
schedule ls, add, cancel: messaggi e promemoria programmati, singoli o ricorrenti.
agents ls, show, create, update: i tuoi agenti.
skills ls, show, add, edit: le tue skill.
projects ls, show: i tuoi progetti.
settings get, set: le tue preferenze, come attivare o disattivare la memoria.
share state, with-me, add, rm: chi ha accesso a un elemento, cosa altri hanno condiviso con te e come concedere o revocare l'accesso.

dvina non può eliminare nulla definitivamente, aprire link pubblici, connettere o disconnettere app, né modificare le impostazioni di amministrazione o fatturazione.

Guida e output

  • dvina --help elenca i gruppi, dvina <group> --help elenca i comandi di un gruppo e dvina <group> <command> --help elenca gli argomenti e le opzioni di un comando.
  • L'output è un testo breve. Aggiungi --json per ottenere JSON, oppure --fields con un elenco separato da virgole, come --fields id,title, per mantenere solo alcuni campi.
  • Un elenco lungo termina con next: --cursor <c>. Esegui di nuovo il comando con quel --cursor per ottenere la pagina successiva.
  • Per leggere un valore da un file, aggiungi -file alla relativa opzione, come in --content-file notes.md. dvina docs upload <file> carica un file e dvina skills add <folder> aggiunge una cartella di skill con il suo SKILL.md.

Codici di uscita

Codice Significato
0 Operazione completata.
1 Si è verificato un altro errore.
2 Il comando non è corretto. Consulta il suo --help.
3 Non trovato.
4 Operazione rifiutata: le tue autorizzazioni, le regole aziendali o la protezione dei dati non la consentono.
5 È necessaria la tua approvazione.
6 Hai raggiunto il limite di utilizzo.

Approva le modifiche

  • I comandi di lettura vengono eseguiti senza chiedere conferma.
  • I comandi che aggiungono qualcosa di nuovo, come docs create, memory add o tasks start, vengono eseguiti senza chiedere conferma. Non modificano mai ciò che esiste già.
  • I comandi che modificano o rimuovono qualcosa chiedono prima la tua approvazione: spostare, rinominare, spostare nel cestino, sostituire una nota o un file di memoria, riscrivere una pagina di canvas, modificare un agente o una skill, interrompere un'attività, annullare un messaggio programmato e condividere. Dvina mostra nella chat una scheda di approvazione con un proprio riepilogo della modifica e chiede l'approvazione ogni volta. Se la rifiuti, non cambia nulla.

Ciò che dvina aggiunge o modifica è soggetto alle regole aziendali per la protezione dei dati e viene registrato nel tuo registro di controllo, come le altre azioni di Dvina.