Personnaliser Genie Code avec des instructions personnalisées

Personnalisez Genie Code avec les instructions utilisateur et de Workspace qui partagent les préférences, les conventions de codage, le contexte de rôle et les directives. Genie Code applique ces instructions à chaque réponse, y compris les suggestions en ligne et Suggest Fix. Quick Fix et Autocomplete sont les exceptions.

Par exemple, les instructions peuvent inclure :

• Informations sur vos préférences, telles que les bibliothèques que vous préférez utiliser lors de l'écriture de code.
• Contexte vous concernant, tel que votre nom et votre rôle.
• Conventions de codage à suivre.
• Lignes directrices à suivre.
• Instructions sur la manière dont Genie Code doit répondre, par exemple en utilisant un ton décontracté.

À l'exception de Correctif rapide et de la saisie semi-automatique, Genie Code applique des instructions à chaque réponse qu'il génère, y compris les suggestions intégrées, le chat et Suggérer une correction.

En plus des instructions de l’utilisateur et du Workspace, Genie Code découvre et lit automatiquement les fichiers AGENTS.md et CLAUDE.md dans votre Workspace. Lorsque vous ouvrez un Notebook ou un fichier, Genie Code parcourt l'arborescence des répertoires et injecte le contenu de tous les fichiers d'instructions qu'il trouve dans son contexte. Aucune configuration n’est requise.

Genie Code prend en charge deux types d'instructions : les instructions utilisateur et les instructions de Workspace. Sauf indication contraire, Genie Code privilégie généralement les instructions du Workspace aux instructions utilisateur.

Ajouter des instructions utilisateur

Les instructions utilisateur vous permettent de fournir des instructions au niveau du système à Genie Code. C'est un moyen persistant de partager le contexte, les préférences ou les méthodes de création préférées. Ces instructions vous sont spécifiques et ne sont appliquées qu'à vos interactions avec Genie Code.

Pour ajouter des instructions utilisateur :

1. Ouvrez le volet Genie Code en cliquant sur dans le coin supérieur droit de votre Workspace.

2. Dans le volet Genie Code, cliquez sur pour ouvrir les paramètres de Genie Code.

   

3. Sous Instructions utilisateur , cliquez sur Ajouter un fichier d'instructions . Cela crée un fichier .assistant_instructions.md dans votre répertoire Workspace utilisateur default (/Users/<your-username-or-email>) et l'ouvre dans un nouveau tab de fichier.

   Si vous avez déjà créé un fichier d'instructions, cliquez sur Ouvrir le fichier d'instructions pour ouvrir le fichier.

4. Modifiez le fichier .assistant_instructions.md pour ajouter vos instructions personnalisées. Databricks recommande d'ajouter vos instructions en texte anglais simple, en séparant chaque instruction par une nouvelle puce ou un nouveau paragraphe. Consultez les bonnes pratiques pour les instructions Genie Code.

Genie Code reprend automatiquement les instructions la prochaine fois que vous interagirez avec lui.

Vous pouvez également utiliser Genie Code pour ajouter des instructions pour vous. Depuis le volet Genie Code, demandez à Genie Code de se souvenir de quelque chose.

Ajouter et afficher les instructions du workspace

remarque

Seuls les administrateurs de Workspace peuvent ajouter ou modifier les instructions de Workspace.

Les instructions du Workspace sont configurées par votre administrateur de Workspace et fournissent plus de contexte à Genie Code pour l’aider à suivre les consignes et à fonctionner plus efficacement dans votre Workspace.

Si votre workspace ne dispose pas encore d'instructions de workspace, un administrateur de workspace peut créer le fichier d'instructions en suivant ces étapes :

1. Dans le répertoire Workspace/ du workspace, créez un fichier nommé .assistant_workspace_instructions.md.
2. Modifiez le fichier pour ajouter des instructions pour Genie Code qui doivent s’appliquer à l’ensemble du Workspace. Databricks recommande d'ajouter vos instructions dans un texte en anglais simple, en séparant chaque instruction par un point ou un paragraphe distinct. Consultez les meilleures pratiques pour les instructions Genie Code.

Genie Code récupère automatiquement les nouvelles instructions du Workspace la prochaine fois qu'un utilisateur interagit avec lui.

Pour afficher ou modifier les instructions du Workspace :

1. Ouvrez le volet Genie Code en cliquant sur dans le coin supérieur droit de votre Workspace.

2. Dans le volet Genie Code, cliquez sur pour ouvrir les paramètres de Genie Code.

3. Sous Instructions du Workspace , cliquez sur Afficher le fichier . Ceci ouvre le fichier .assistant_workspace_instructions.md dans un nouveau tab.

4. Si vous êtes un administrateur Workspace, vous pouvez modifier le fichier et ajouter des instructions qui s'appliquent au comportement de Genie Code dans tout le Workspace. Consultez Bonnes pratiques pour les instructions Genie Code pour plus d'information sur l'ajout d'instructions.

   Si vous n'êtes pas administrateur, vous pouvez toujours consulter le fichier pour comprendre les instructions que suit Genie Code en plus des instructions utilisateur que vous auriez pu fournir.

   

Bonnes pratiques pour les instructions Genie Code

Il est important de prendre en compte les limites potentielles de Genie Code lorsque vous fournissez des instructions. Voici quelques lignes directrices générales et conseils pour la rédaction d'instructions afin d'optimiser votre expérience et de tirer le meilleur parti de cette fonctionnalité.

• Écrire des instructions claires et spécifiques : Soyez explicite et sans ambiguïté lorsque vous rédigez vos instructions.
• Gardez les instructions en dessous de 20 000 caractères : les fichiers d'instructions sont limités à 20 000 caractères. Genie Code n'utilise pas d'instructions au-delà de cette limite. Soyez concis et donnez la priorité aux instructions importantes.
• Utilisez des en-têtes et des délimiteurs pour la structure : Les instructions sont dans des fichiers Markdown. Utilisez le formatage Markdown dans vos instructions pour fournir une structure. Utilisez des puces comme délimiteurs pour séparer les instructions distinctes. Utilisez des titres pour regrouper un ensemble d'instructions. Par exemple, vous pourriez avoir une section intitulée « conventions de code Python » qui inclut une liste à puces de lignes directrices spécifiques à Python que Genie Code doit suivre lors de l'utilisation de code Python.
• Portée : Genie Code applique les instructions à chaque réponse qu'il génère lorsque vous interagissez avec lui en utilisant Inline Genie Code, le chat général, la suggestion de correctifs et les fonctionnalités similaires. Cependant, Genie Code ne prend pas en compte les instructions pour la Correction rapide et la Complétion automatique. Gardez les instructions globalement pertinentes pour les différentes fonctions de Genie Code afin d'éviter tout comportement indésirable.
• Fournissez du contexte et des références : bien que Genie Code utilise le contexte environnant comme le code de notebook et les métadonnées de table, il ne récupère pas encore de manière proactive des informations supplémentaires basées sur les instructions. Pour garantir des réponses utiles, incluez les détails importants directement dans les instructions, tels que le moment d'utiliser une table ou une fonction particulière.