Dvina MCP

Use o comando dvina

Saiba o que o comando dvina faz quando Dvina executa código para você, quais comandos estão disponíveis e quais pedem sua aprovação.

Ver em Markdown

Quando Dvina executa código ou comandos para você, conta com um comando próprio: dvina. Com ele, um script ou uma sequência de etapas pode pesquisar no seu Dvina, ler e adicionar documentos, memória e tarefas, além de verificar quem tem acesso a um item, em seu nome.

Você não precisa instalar nada nem iniciar sessão. Dvina usa o comando quando sua solicitação exige, e você também pode pedir, por exemplo: "Use dvina para listar minhas tarefas e escrever um resumo em uma nota."

Como funciona

  • dvina atua no seu próprio Dvina, em seu nome, com as permissões da sua função e dentro dos seus limites habituais.
  • O acesso dura apenas enquanto Dvina trabalha na sua solicitação. Quando a resposta termina, o comando não pode mais acessar seu Dvina.
  • Ele só lê um arquivo ou uma pasta quando um comando especifica esse arquivo ou pasta, como um arquivo para enviar.

Comandos

Os comandos são organizados em grupos: dvina <group> <command>, seguido dos argumentos e das opções do comando.

Grupo Comandos
search dvina search <query>: pesquise nas suas conversas, documentos, memória e mundo de uma só vez.
memory ls, show, add, edit: liste, leia, adicione ou altere seus arquivos de memória.
world topics, topic, recall, feed: seus tópicos, o que Dvina sabe sobre algo e seu Feed.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: documentos e pastas da sua Biblioteca.
canvas ls, show, create, write-page: liste, leia, crie ou reescreva páginas do canvas.
tasks ls, show, start, continue, stop: suas tarefas em segundo plano.
goals show, start: tarefas que trabalham para alcançar um objetivo.
schedule ls, add, cancel: mensagens e lembretes agendados, únicos ou recorrentes.
agents ls, show, create, update: seus agentes.
skills ls, show, add, edit: suas habilidades.
projects ls, show: seus projetos.
settings get, set: suas preferências, como ativar ou desativar a memória.
share state, with-me, add, rm: quem tem acesso a um item, o que outras pessoas compartilharam com você e como conceder ou remover acesso.

dvina não pode excluir nada permanentemente, abrir links públicos, conectar ou desconectar apps nem alterar configurações de administração ou cobrança.

Ajuda e saída

  • dvina --help lista os grupos, dvina <group> --help lista os comandos de um grupo e dvina <group> <command> --help lista os argumentos e as opções de um comando.
  • A saída é um texto curto. Adicione --json para obter JSON ou --fields com uma lista separada por vírgulas, como --fields id,title, para manter apenas alguns campos.
  • Uma lista longa termina com next: --cursor <c>. Execute o comando novamente com esse --cursor para obter a próxima página.
  • Para ler um valor de um arquivo, adicione -file à opção correspondente, como em --content-file notes.md. dvina docs upload <file> envia um arquivo, e dvina skills add <folder> adiciona uma pasta de habilidade com seu SKILL.md.

Códigos de saída

Código Significado
0 Concluído.
1 Algo mais deu errado.
2 O comando está incorreto. Consulte seu --help.
3 Não encontrado.
4 Recusado: suas permissões de acesso, as regras da sua empresa ou a proteção de dados não permitem a ação.
5 Precisa da sua aprovação.
6 Você atingiu seu limite de uso.

Aprove alterações

  • Comandos de leitura são executados sem pedir aprovação.
  • Comandos que adicionam algo novo, como docs create, memory add ou tasks start, são executados sem pedir aprovação. Eles nunca alteram o que já existe.
  • Comandos que alteram ou removem algo pedem sua aprovação primeiro: mover, renomear, mover para a lixeira, substituir uma nota ou um arquivo de memória, reescrever uma página do canvas, alterar um agente ou uma habilidade, parar uma tarefa, cancelar uma mensagem agendada e compartilhar. Dvina mostra um cartão de aprovação na conversa com um resumo da alteração feito pelo próprio Dvina e pede aprovação todas as vezes. Se você rejeitar, nada muda.

Tudo o que dvina adiciona ou altera passa pelas regras de proteção de dados da sua empresa e é registrado no seu log de auditoria, assim como as outras ações de Dvina.