Étendre le code Genie avec des compétences d'agents

Genie Code est fourni avec des compétences intégrées préconfigurées pour les flux de travail de Azure Databricks courants, tels que l’écriture de code dans Azure Databricks notebooks, l’exploration des données dans Unity Catalog, la création de tableaux de bord, la création de pipelines et l’utilisation de MLflow. Vous pouvez également créer vos propres compétences pour étendre Génie Code en mode Agent avec des fonctionnalités spécialisées pour vos tâches spécifiques au domaine. Cette page explique comment créer et optimiser les compétences.

Qu’est-ce que les compétences ?

Créez des compétences pour étendre Genie Code avec des fonctionnalités spécialisées. Les compétences suivent la norme ouverte des compétences de l’agent. Connaissances et flux de travail spécifiques au domaine du package de compétences que Genie Code peut charger lorsqu’il est pertinent d’effectuer des tâches spécifiques. Les compétences peuvent inclure des conseils, des bonnes pratiques, du code réutilisable et des scripts exécutables.

Les compétences doivent être adaptées aux tâches spécifiques au domaine. Avec des compétences, vous pouvez fournir un contexte plus riche (comme des scripts, des exemples et d'autres ressources) pour une tâche que vous ne pouvez le faire 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 approprié. En mode Agent, Genie Code charge automatiquement les compétences en cas de pertinence, en fonction de votre demande et de la description de la compétence. Vous pouvez également appeler manuellement des compétences @ en les mentionnant. Cela gère une fenêtre de contexte efficace et réduit la nécessité de fournir le même contexte dans plusieurs conversations.

Il existe deux types de compétences :

  • Compétences de l’espace de travail : disponibles pour tout le monde dans l’espace de travail. Les administrateurs d’espace de travail peuvent créer des compétences d’espace de travail et accorder à d’autres utilisateurs l’accès au dossier des compétences pour en ajouter d’autres. Utilisez des compétences d’espace de travail pour les flux de travail qui sont largement utiles dans votre équipe, telles que les flux de travail Machine Learning ou les processus spécifiques au domaine.
  • Compétences utilisateur : disponible uniquement pour vous. Utilisez des compétences utilisateur pour les flux de travail personnels qui ne sont pas pertinents pour d’autres membres de l’espace de travail.

Note

Les compétences sont uniquement prises en charge en mode Agent de code Genie.

Créer une compétence

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

  • Compétences de l’espace de travail : Workspace/.assistant/skills/
  • Compétences utilisateur : /Users/{username}/.assistant/skills/

Pour créer une compétence :

  1. Créez un dossier de compétences au chemin d’accès approprié pour votre type de compétence.

    Après la création, vous pouvez accéder rapidement à votre dossier de compétences dans le panneau Génie Code. Cliquez sur l'icône Engrenage. Paramètres, puis cliquez sur Flèche dans l'icône. Ouvrir le dossier des compétences.

  2. Créez un dossier dédié pour votre compétence dans le dossier 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 SKILL.md fichier. Ce fichier est requis et définit la compétence. Les compétences suivent les spécifications des compétences de l’agent.

  4. Ajoutez l'en-tête 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 relatives aux compétences au format Markdown après l'en-tête. Il est recommandé d’inclure les sections suivantes :

    • Instructions pas à pas : instructions procédurales claires
    • Exemples : Exemples d’entrées et sorties attendues
    • Cas de périphérie : variantes et exceptions courantes

  6. (Facultatif) Pour des 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 à référencer, comme les meilleures pratiques et les modèles.

    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 d'apprentissage automatique de l'environnement de travail et une compétence de workflow personnel peuvent suivre 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 récupère automatiquement vos compétences la prochaine fois que vous l’utilisez en mode Agent. Vous pouvez également @ mentionner des compétences pour vous assurer que Genie Code les utilise.

Bonnes pratiques

Suivez ces instructions pour écrire des compétences efficaces :

  • Choisissez le type de compétence approprié. Utilisez des compétences d’espace de travail pour les flux de travail qui bénéficient à de nombreux utilisateurs, tels que des pipelines de Machine Learning partagés ou des processus spécifiques au domaine. Utilisez des compétences utilisateur pour les flux de travail personnels qui ne sont pas pertinents pour d’autres personnes.
  • Concentrez-vous sur les compétences. Les compétences fonctionnent mieux lorsqu’elles se concentrent sur une tâche ou un flux de travail unique. L’étendue étroite facilite la reconnaissance par Genie Code lorsqu'une compétence est applicable.
  • Utilisez des noms et des descriptions clairs. Un nom concis et descriptif ainsi qu'un résumé aident Genie Code à associer la bonne compétence à la bonne demande.
  • Soyez explicite et basé sur des exemples. Décrivez les flux de travail pas à pas et incluez des exemples concrets ou des modèles que Génie Code peut réutiliser.
  • Évitez le contexte inutile. Incluez uniquement les informations requises pour la tâche. Des détails supplémentaires peuvent rendre les compétences plus difficiles à appliquer de manière fiable.
  • Répéter dans le temps. Traitez les compétences comme des flux de travail vivants. Les petites mises à jour basées sur l’utilisation réelle peuvent améliorer considérablement les résultats.
  • Séparez les instructions de l’automatisation. Utilisez Markdown pour expliquer les intentions et les meilleures pratiques et les scripts pour les actions reproductibles. La conservation de ces préoccupations distinctes facilite la maintenance et la réutilisation des compétences.
  • Gérez les versions de vos compétences. Sauvegardez votre dossier de compétences avec les dossiers Git Databricks pour suivre les modifications, collaborer avec vos collègues et revenir en arrière si nécessaire.

Voir également

  • Last updated on