Agents

Connaissances, compétences et résultat

Donnez à un agent les sources qu’il consulte systématiquement et les compétences qu’il charge en premier, puis choisissez la forme de ses réponses et la destination de son travail.

Voir en Markdown

Sous l’instruction d’un agent, trois sections définissent chaque exécution : Connaissances détermine ce qu’il lit, Compétences lui indique comment effectuer le travail et Résultat définit ce qu’il vous remet.

Ajouter des connaissances

Les connaissances sont les sources que l’agent consulte systématiquement, comme une liste de prix, un guide de style, un dossier d’anciens contrats ou un site web.

  1. Ouvrez l’agent et accédez à Connaissances.
  2. Tapez / ou choisissez Ajouter une ressource (+), puis sélectionnez un fichier, un dossier, une page, une base de données ou une application. Pour ajouter un site web, choisissez Ajouter un site web et collez son adresse.
  3. Pour ajouter un fichier depuis votre ordinateur, collez-le dans le champ. Il est d’abord ajouté à votre Bibliothèque.

La section Connaissances accepte des fichiers, des dossiers, des pages, des données, des applications et des sites web, dans la limite de 20 sources. Pour retirer une source, supprimez sa pastille.

Ajouter des compétences

Une compétence apprend à Dvina comment effectuer un type de travail, comme examiner un NDA ou préparer une proposition. Un agent charge ses compétences en premier, avant de commencer.

  1. Ouvrez l’agent et accédez à Compétences.
  2. Tapez / ou choisissez Ajouter une ressource (+), puis sélectionnez une compétence.

Seules des compétences peuvent être ajoutées ici. Un agent peut en contenir jusqu’à 10.

Obtenir des compétences

Vos compétences se trouvent dans votre Fil, sous Compétences. Pour en obtenir une :

  • À partir des compétences officielles : Dans votre Fil, choisissez Ajouter du contexte, puis Compétence à partir d’un modèle. Sélectionnez une compétence pour voir Quand Dvina l’utilise, sa Licence, sa Source et ses Fichiers, puis choisissez Ajouter. Elle est ajoutée exactement telle que son créateur la publie, et vous pouvez modifier votre copie librement.
  • À partir d’un fichier : Dans votre Fil, choisissez Ajouter du contexte, puis Compétence, et sélectionnez un fichier SKILL.md ou une archive de compétences (un fichier .zip). Une archive doit contenir un dossier de compétence avec un fichier SKILL.md et peut inclure plusieurs compétences.
  • À partir d’un lien : Collez un lien vers une compétence dans une conversation et demandez à Dvina de l’ajouter. Il peut s’agir d’un dépôt, d’un dossier ou d’un SKILL.md sur GitHub, d’une page skills.sh ou d’un lien direct vers un fichier .zip ou SKILL.md. Dvina vous demande d’abord votre accord, en précisant le nom de la compétence et sa provenance.

Dans tous les cas, vous confirmez une fois avant tout ajout. Dvina indique la provenance de la compétence et, si elle contient des scripts, combien s’exécutent dans votre environnement isolé. Une compétence provenant de skills.sh dont l’éditeur n’est pas officiel porte la mention : Elle provient d’un éditeur de la communauté, et non d’un éditeur officiel. Si la compétence d’un fichier porte le même nom que l’une des vôtres, Dvina vous indique qu’elle remplace la vôtre.

Une compétence dont le SKILL.md ne contient pas de nom ou de description dans ses métadonnées frontmatter reste inactive jusqu’à ce que vous les ajoutiez. Pour modifier une compétence, ouvrez-la dans votre Fil et modifiez ses fichiers.

Choisir le résultat

Sous Résultat, choisissez la forme du travail de l’agent et sa destination.

  • Format de réponse : Un modèle que chaque réponse suit, comme « Verdict, Risques, Prochaine étape ». Décrivez-le en langage courant.
  • Écrire dans : Un document ou une page que chaque exécution met à jour. Tapez / pour le sélectionner. Chaque exécution enregistre une nouvelle version, et les précédentes restent dans son historique. Un agent écrit dans un seul document ou une seule page à la fois : si vous en sélectionnez un autre, il remplace le précédent.

Conseils

  • Indiquez la source de référence. Ajoutez le fichier que l’agent doit suivre, comme votre guide de gestion des contrats, plutôt que d’en expliquer le contenu dans l’instruction.
  • Gardez un seul document à jour. Utilisez Écrire dans pour les travaux qui s’enrichissent au fil du temps, comme un rapport hebdomadaire, afin de conserver toutes les versions au même endroit.
  • Les agents partagés affichent leurs sources. Les personnes avec qui vous partagez un agent voient ses connaissances, ses compétences et ses résultats dans son panneau. Une source qu’elles ne peuvent pas ouvrir porte la mention Aucun accès.