# Utiliser la commande dvina > Découvrez à quoi sert la commande dvina quand Dvina exécute du code pour vous, les commandes disponibles et celles qui demandent votre approbation. Quand Dvina exécute du code ou des commandes pour vous, il dispose de sa propre commande : `dvina`. Elle permet à un script ou à une suite d’étapes d’effectuer des recherches dans votre Dvina, de lire et d’ajouter des documents, des fichiers de mémoire et des tâches, et de vérifier qui a accès à un élément, en votre nom. Vous n’avez rien à installer et aucune connexion à effectuer. Dvina utilise la commande lorsque votre demande le nécessite. Vous pouvez aussi lui demander de l’utiliser, par exemple : « Utilise dvina pour lister mes tâches et rédiger un résumé sous forme de note. » ## Fonctionnement - `dvina` agit sur votre propre Dvina, en votre nom, avec les autorisations de votre rôle et dans vos limites habituelles. - Son accès ne dure que le temps pendant lequel Dvina traite votre demande. Une fois la réponse terminée, la commande ne peut plus accéder à votre Dvina. - Il ne lit un fichier ou un dossier que lorsqu’une commande le désigne, par exemple un fichier à importer. ## Commandes Les commandes sont organisées en groupes : `dvina `, suivi des arguments et des options de la commande. | Groupe | Commandes | | ---------- | ------------------------------------------------------------------------------------------------------------------------ | | `search` | `dvina search ` : rechercher dans vos conversations, vos documents, votre mémoire et votre monde à la fois. | | `memory` | `ls`, `show`, `add`, `edit` : lister, lire, ajouter ou modifier vos fichiers de mémoire. | | `world` | `topics`, `topic`, `recall`, `feed` : vos sujets, ce que Dvina sait sur un sujet et votre fil. | | `docs` | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm` : les documents et dossiers de votre bibliothèque. | | `canvas` | `ls`, `show`, `create`, `write-page` : lister, lire, créer ou réécrire des pages de canevas. | | `tasks` | `ls`, `show`, `start`, `continue`, `stop` : vos tâches en arrière-plan. | | `goals` | `show`, `start` : les tâches qui visent un objectif. | | `schedule` | `ls`, `add`, `cancel` : les messages et rappels programmés, ponctuels ou récurrents. | | `agents` | `ls`, `show`, `create`, `update` : vos agents. | | `skills` | `ls`, `show`, `add`, `edit` : vos compétences. | | `projects` | `ls`, `show` : vos projets. | | `settings` | `get`, `set` : vos préférences, comme l’activation ou la désactivation de la mémoire. | | `share` | `state`, `with-me`, `add`, `rm` : qui a accès à un élément, ce que d’autres ont partagé avec vous, et l’octroi ou le retrait d’un accès. | `dvina` ne peut pas supprimer définitivement des éléments, ouvrir des liens publics, connecter ou déconnecter des applications, ni modifier les paramètres d’administration ou de facturation. ### Aide et résultats - `dvina --help` liste les groupes, `dvina --help` liste les commandes d’un groupe, et `dvina --help` liste les arguments et les options d’une commande. - Les résultats sont présentés sous forme de texte court. Ajoutez `--json` pour obtenir du JSON, ou `--fields` suivi d’une liste séparée par des virgules, comme `--fields id,title`, pour ne conserver que certains champs. - Une longue liste se termine par `next: --cursor `. Exécutez à nouveau la commande avec ce `--cursor` pour obtenir la page suivante. - Pour lire une valeur depuis un fichier, ajoutez `-file` à son option, comme `--content-file notes.md`. `dvina docs upload ` importe un fichier, et `dvina skills add ` ajoute un dossier de compétence avec son fichier SKILL.md. ### Codes de sortie | Code | Signification | | ---- | ----------------------------------------------------------------------------- | | `0` | Terminé. | | `1` | Une autre erreur s’est produite. | | `2` | La commande est incorrecte. Consultez son aide avec `--help`. | | `3` | Introuvable. | | `4` | Refusé : vos droits d’accès, les règles de votre entreprise ou la protection des données ne le permettent pas. | | `5` | Votre approbation est nécessaire. | | `6` | Vous avez atteint votre limite d’utilisation. | ## Approuver les modifications - Les commandes de lecture s’exécutent sans vous demander votre accord. - Les commandes qui ajoutent un nouvel élément, comme `docs create`, `memory add` ou `tasks start`, s’exécutent sans vous demander votre accord. Elles ne modifient jamais les éléments existants. - Les commandes qui modifient ou suppriment un élément vous demandent d’abord votre accord : déplacer, renommer, mettre à la corbeille, remplacer une note ou un fichier de mémoire, réécrire une page de canevas, modifier un agent ou une compétence, arrêter une tâche, annuler un message programmé et partager. Dvina affiche dans la conversation une carte d’approbation avec son propre résumé de la modification et vous demande votre accord à chaque fois. Si vous refusez, rien ne change. Tout ce que `dvina` ajoute ou modifie est soumis aux règles de protection des données de votre entreprise et consigné dans votre [journal d’audit](/docs/teams/audit-log), comme les autres actions de Dvina. ## Voir aussi - [Utiliser Dvina depuis d’autres applications avec MCP](/docs/dvina-mcp/overview) - [Tâches](/docs/use-dvina/features/tasks) - [Présentation des connecteurs](/docs/connectors/overview)