# 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.

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](/docs/teams/audit-log), tal como as restantes ações de Dvina.

## Conteúdo relacionado

- [Usar Dvina a partir de outras aplicações com MCP](/docs/dvina-mcp/overview)
- [Tarefas](/docs/use-dvina/features/tasks)
- [Visão geral dos conectores](/docs/connectors/overview)