Dvina MCP

Usar o comando dvina

Saiba o que faz o comando dvina quando Dvina executa código por si, que comandos inclui e quais pedem a sua aprovação.

Ver em Markdown

Quando Dvina executa código ou comandos por si, dispõe de um comando próprio: dvina. Com este comando, um script ou uma sequência de passos pode pesquisar no seu Dvina, ler e adicionar documentos, memória e tarefas, e verificar quem tem acesso a um item, em seu nome.

Não precisa de instalar nada nem de iniciar sessão. Dvina usa o comando quando o seu pedido o exige, e também pode pedir que o use, por exemplo: "Usa dvina para listar as minhas tarefas e escrever um resumo numa nota."

Como funciona

  • dvina funciona 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 no seu pedido. Quando a resposta termina, o comando deixa de ter acesso ao seu Dvina.
  • Só lê um ficheiro ou uma pasta quando um comando o indica, como um ficheiro a carregar.

Comandos

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

Grupo Comandos
search dvina search <query>: pesquisar nas suas conversas, documentos, memória e mundo de uma só vez.
memory ls, show, add, edit: listar, ler, adicionar ou alterar os seus ficheiros de memória.
world topics, topic, recall, feed: os seus tópicos, o que Dvina sabe sobre um assunto e o seu Feed.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: os documentos e as pastas da sua Library.
canvas ls, show, create, write-page: listar, ler, criar ou reescrever páginas de canvas.
tasks ls, show, start, continue, stop: as suas tarefas em segundo plano.
goals show, start: tarefas que trabalham para atingir um objetivo.
schedule ls, add, cancel: mensagens e lembretes agendados, únicos ou recorrentes.
agents ls, show, create, update: os seus agentes.
skills ls, show, add, edit: as suas competências.
projects ls, show: os seus projetos.
settings get, set: as 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 partilharam consigo e conceder ou remover acesso.

dvina não pode eliminar nada de forma definitiva, abrir ligações públicas, ligar ou desligar aplicações, nem alterar definições de administração ou faturação.

Ajuda e resultados

  • 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.
  • Os resultados são apresentados em 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 novamente o comando com esse --cursor para obter a página seguinte.
  • Para ler um valor de um ficheiro, acrescente -file à respetiva opção, como em --content-file notes.md. dvina docs upload <file> carrega um ficheiro e dvina skills add <folder> adiciona uma pasta de competência com o respetivo SKILL.md.

Códigos de saída

Código Significado
0 Concluído.
1 Ocorreu outro erro.
2 O comando está incorreto. Consulte a respetiva ajuda com --help.
3 Não encontrado.
4 Recusado: as suas permissões de acesso, as regras da sua empresa ou a proteção de dados não o permitem.
5 É necessária a sua aprovação.
6 Atingiu o seu limite de utilização.

Aprovar alterações

  • Os comandos de leitura são executados sem pedir aprovação.
  • Os comandos que adicionam algo novo, como docs create, memory add ou tasks start, são executados sem pedir aprovação. Nunca alteram o que já existe.
  • Os comandos que alteram ou removem algo pedem primeiro a sua aprovação: mover, mudar o nome, mover para o lixo, substituir uma nota ou um ficheiro de memória, reescrever uma página de canvas, alterar um agente ou uma competência, parar uma tarefa, cancelar uma mensagem agendada e partilhar. Dvina apresenta um cartão de aprovação na conversa com o seu próprio resumo da alteração e pede aprovação sempre. Se rejeitar, nada muda.

Tudo o que dvina adiciona ou altera passa pelas regras de proteção de dados da sua empresa e fica registado no seu registo de auditoria, tal como as restantes ações de Dvina.