Dvina MCP

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.

Voir en Markdown

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 <group> <command>, suivi des arguments et des options de la commande.

Groupe Commandes
search dvina search <query> : 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 <group> --help liste les commandes d’un groupe, et dvina <group> <command> --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 <c>. 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 <file> importe un fichier, et dvina skills add <folder> 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, comme les autres actions de Dvina.