Aller au contenu principal
Dernière mise à jour le

Étendre Genie Code avec les compétences d'agent.

Genie Code est livré avec des compétences intégrées pour les workflows Databricks courants : écrire du code dans des Notebooks, explorer des données dans Unity Catalog, créer des tableaux de bord, créer des pipelines et travailler avec MLflow. Créez des compétences personnalisées pour étendre Genie Code avec des capacités spécialisées pour les tâches spécifiques au domaine de votre équipe. Cette page explique comment les créer et les optimiser.

Que sont les compétences ?​

Créez des compétences pour étendre Genie Code avec des capacités spécialisées. Les compétences suivent la norme ouverte des Compétences d'agent. Les compétences regroupent les connaissances et les workflows spécifiques au domaine que Genie Code peut charger lorsqu'ils sont pertinents pour effectuer des tâches spécifiques. Les compétences peuvent inclure des conseils, des meilleures pratiques, du code réutilisable et des scripts exécutables.

Les compétences doivent être adaptées à des tâches spécifiques à un domaine. Avec les compétences, vous pouvez fournir un contexte plus riche (tel que des scripts, des exemples et d'autres ressources) pour une tâche que vous ne le pouvez avec des instructions. Contrairement aux instructions personnalisées, qui sont appliquées globalement, les compétences sont chargées automatiquement et uniquement dans le contexte pertinent. Genie Code charge automatiquement les compétences lorsqu'elles sont pertinentes, en fonction de votre demande et de la description de la compétence. Vous pouvez également invoquer manuellement des compétences en @ les mentionnant. Cela permet de maintenir une fenêtre de contexte efficace et réduit la nécessité de fournir le même contexte à travers plusieurs discussions.

On distingue deux types de compétences :

  • Compétences du Workspace : Disponibles pour tous les utilisateurs du Workspace. Les administrateurs de Workspace peuvent créer des compétences de Workspace et accorder aux autres l'accès au dossier de compétences pour en ajouter davantage. Utilisez les compétences Workspace pour faire respecter les normes à l'échelle de l'organisation, fournir un résultat cohérent à tous les utilisateurs (par exemple, une compétence de gestion des PII qui masque les colonnes sensibles) ou servir différentes équipes (par exemple, des templates de pipeline pour les data engineers et des playbooks de formation de modèles pour les utilisateurs de la plateforme ML).
  • **Compétences utilisateur** : Disponible uniquement pour vous. Utilisez les compétences de l'utilisateur pour les préférences personnelles telles que les bibliothèques préférées, le style de codage, ou le rôle et le contexte de base. Les compétences utilisateur sont également utiles pour prototyper une compétence avant de la promouvoir au niveau du workspace.

Créer une compétence​

Les compétences résident dans un répertoire .assistant/skills/. Chaque compétence doit avoir son propre dossier et un fichier SKILL.md dans ce dossier. L'emplacement dépend du type de compétence :

  • Compétences Workspace : Workspace/.assistant/skills/
  • Compétences utilisateur : /Users/{username}/.assistant/skills/

Pour créer une nouvelle compétence :

  1. Créez un nouveau dossier de compétences au chemin approprié pour votre type de compétence.

    Après la création, vous pouvez accéder rapidement à votre dossier de compétences dans le volet Genie Code. Cliquez sur Icône d'engrenage. Paramètres , puis sur Flèche dans l'icône. Ouvrir le dossier des compétences .

  2. Créez un dossier dédié pour votre compétence à l’intérieur du dossier des compétences. Chaque compétence doit avoir son propre dossier. Par exemple :

    Workspace/.assistant/skills/
    └── ml-workflows/
        └── SKILL.md

    /Users/{username}/.assistant/skills/
    └── personal-workflows/
        └── SKILL.md

  3. Dans votre dossier de compétences, créez un fichier SKILL.md. Ce fichier est requis et définit la compétence. Les compétences suivent les spécifications des compétences d'agent.

  4. Ajouter le frontmatter requis pour votre compétence :

    ---
    name: skill-name
    description: A description of what this skill does and when to use it.
    ---

  5. Ajoutez les instructions de compétence au format Markdown après l'en-tête. Il est recommandé d'inclure les sections suivantes :

    • Instructions étape par étape : Directives procédurales claires
    • Exemples : exemples d'entrées et sorties attendues
    • Cas limites : variations et exceptions courantes

  6. (Facultatif) Pour les compétences plus complexes, vous pouvez fournir et référencer des Ressources supplémentaires :

    • Scripts contenant du code exécutable que l'agent peut exécuter.
    • Fichiers contenant une documentation supplémentaire à consulter, tels que les meilleures pratiques et les Template.

    Lorsque vous référencez d'autres fichiers, utilisez des chemins relatifs à partir de la compétence racine.

    Par exemple, une compétence de workflow de Machine Learning de Workspace et une compétence de workflow personnelle peuvent avoir la structure suivante :

    Workspace/.assistant/skills/
    ├── ml-workflows/
       ├── SKILL.md                # Workflow overview and best practices
       ├── training-patterns.md    # Standard ML training patterns
       └── scripts/
             └── model-deploy.py   # Model deployment automation

    /Users/{username}/.assistant/skills/
    ├── personal-workflows/
       ├── SKILL.md                # Workflow overview and best practices
       ├── etl-patterns.md         # Personal ETL best practices
       ├── dashboard-templates.md   # Reusable dashboard patterns
       └── scripts/
             └── pipeline-setup.sh   # Environment setup scripts

Genie Code détecte automatiquement vos compétences la prochaine fois que vous l'utiliserez. Vous pouvez également @ mentionner des compétences pour vous assurer que Genie Code les utilise.

Lorsque vous modifiez une compétence existante, start un nouveau fil de discussion pour appliquer vos modifications. Les modifications ne prennent pas effet dans les fils de discussion actifs. Si une compétence semble toujours obsolète, comme l'affichage d'un ancien comportement ou d'une description obsolète, refresh la tab du navigateur en profondeur pour effacer les métadonnées de compétence mises en cache.

Bonnes pratiques​

Suivez ces lignes directrices pour rédiger des compétences efficaces :

  • Choisissez le type de compétence approprié. Utilisez les compétences de workspace pour codifier des normes partagées (telles que la gestion des PII, les conventions de nommage ou les templates spécifiques à l'équipe) afin que chaque utilisateur obtienne un résultat cohérent. Utilisez les compétences utilisateur pour les préférences personnelles et pour prototyper une compétence avant de la promouvoir au workspace.
  • Maintenez les compétences ciblées. Les compétences fonctionnent mieux lorsqu'elles se concentrent sur une tâche ou un workflow unique. Un champ d'application étroit permet à Genie Code de reconnaître plus facilement quand une compétence s'applique.
  • Utilisez des noms et des descriptions clairs. Un nom et un résumé concis et descriptifs aident Genie Code à faire correspondre la bonne compétence à la bonne requête.
  • Soyez explicite et axé sur les exemples. Décrivez les workflows étape par étape et incluez des exemples ou des modèles concrets que Genie Code peut réutiliser.
  • Évitez le contexte inutile. N'incluez que les informations requises pour la tâche. Les détails supplémentaires peuvent rendre les compétences plus difficiles à appliquer de manière fiable.
  • Itérer au fil du temps. Traitez les compétences comme des workflows vivants. De petites mises à jour basées sur une utilisation réelle peuvent améliorer considérablement les résultats.
  • Créez des compétences avec Genie Code. Utilisez Genie Code pour rédiger et affiner des skills. Testez de nouvelles compétences ou des compétences mises à jour sur des tâches représentatives pour trouver où l'agent a des difficultés, puis mettez à jour les instructions pour combler ces lacunes.
  • Séparez les directives de l'automatisation. Utilisez le markdown pour expliquer l'intention et les meilleures pratiques, et des scripts pour les actions répétables. Maintenir ces préoccupations distinctes facilite l'entretien et la réutilisation des compétences.
  • Gérez la version de vos compétences. Sauvegardez votre dossier de compétences avec les dossiers Git de Databricks pour suivre les changements, collaborer avec vos coéquipiers et revenir en arrière si nécessaire.

Ressources supplémentaires​

Sur cette page