Créer et gérer des compétences

Les compétences sont des instructions personnalisées réutilisables qui aident l'assistant Gemini Enterprise à effectuer des tâches spécifiques, comme examiner des contrats juridiques ou rédiger des textes dans le ton de votre marque.

Remarque : Pour créer des compétences, votre administrateur doit activer la fonctionnalité de compétences. De même, pour partager des compétences, votre administrateur doit également activer le partage de compétences, qu'il peut configurer pour exiger un examen par l'administrateur ou autoriser le partage immédiat. Pour en savoir plus, consultez Gérer les compétences.

Chaque compétence est un package contenant un fichier de requête SKILL.md. Un package de compétences peut également inclure des scripts, des fichiers ou un contexte d'arrière-plan que l'assistant utilise pour effectuer une tâche. Par défaut, Gemini Enterprise active les compétences que vous créez.

Éditions compatibles

La possibilité de créer, d'importer ou d'utiliser des compétences dépend de l'édition Gemini Enterprise à laquelle vous êtes abonné :

• Standard, Plus et Paiement à l'usage : vous pouvez créer et importer des compétences personnalisées, et utiliser des compétences gérées par Google et des compétences créées par l'utilisateur qui ont été partagées avec vous.
• Frontline : vous pouvez parcourir, installer et utiliser les compétences gérées par Google et les compétences créées par les utilisateurs qui sont partagées avec vous. Vous ne pouvez pas créer ni importer de compétences personnalisées.

Présentation

Voici les principaux aspects des compétences :

• Norme ouverte : basée sur la norme ouverte des compétences, chaque compétence est définie par un fichier SKILL.md principal et peut être étendue avec des fichiers ou des scripts supplémentaires.
• Extension modulaire : les compétences vous permettent d'enseigner à un agent des tâches spécifiques à un domaine à l'aide d'instructions et d'un contexte personnalisés.
• Accès dynamique : Gemini Enterprise accède automatiquement à ces instructions spécialisées lorsqu'elles sont pertinentes pour votre question ou votre tâche.

Créer une compétence

Remarque : Vous ne pouvez pas créer de compétences avec l'édition Gemini Enterprise Frontline. Pour en savoir plus, consultez Éditions compatibles.

Pour créer une compétence dans l'application Web Gemini Enterprise, procédez comme suit :

1. Connectez-vous à l'application Web Gemini Enterprise.
2. Dans le menu de navigation, cliquez sur Compétences.
3. Cliquez sur l'icône Ajouter, puis sur Créer une compétence avec Gemini.
4. Saisissez un nom pour votre compétence.
5. Saisissez une description. Gemini Enterprise utilise la description pour déterminer si la compétence peut aider à répondre à un prompt ou à effectuer une tâche. Vous pouvez également ajouter des instructions de déclenchement à la description pour guider Gemini Enterprise.
6. Fournissez les instructions de la compétence en langage naturel dans la zone de chat ou le champ Instructions. Pour créer une compétence à l'aide d'un fichier SKILL.md existant avec un front matter Markdown ou YAML personnalisé, consultez Importer une compétence.
7. Cliquez sur Enregistrer. Gemini Enterprise active la nouvelle compétence par défaut.

Importer une compétence

Remarque : Vous ne pouvez pas importer de compétences avec l'édition Gemini Enterprise Frontline. Pour en savoir plus, consultez Éditions compatibles.

Pour ajouter des compétences existantes, importez-les sous forme de fichiers Markdown ou ZIP. Gemini Enterprise extrait automatiquement le nom et la description de la compétence du fichier SKILL.md.

Format de fichier et structure de répertoire des compétences

Un package de compétences se compose d'un fichier de prompt SKILL.md obligatoire et de sous-répertoires facultatifs pour les scripts, la documentation de référence et les éléments. Vous pouvez importer un fichier SKILL.md autonome ou une archive ZIP avec la structure de répertoires suivante :

my-skill/
├── SKILL.md              # Required: YAML frontmatter + Markdown instructions
├── scripts/              # Optional: executable helper scripts (Python, Bash)
├── references/           # Optional: supplementary context loaded as needed
└── assets/               # Optional: templates or images used in output

Fichier ou répertoire	Obligatoire	Description
SKILL.md	Oui	Contient les métadonnées YAML frontmatter de la compétence (telles que name et description), suivies des instructions Markdown qui guident l'assistant Gemini Enterprise.
scripts/	Non	Scripts d'assistance Python ou Bash exécutables pour les opérations déterministes ou répétées.
references/	Non	Contexte supplémentaire chargé à la demande, tel que des schémas, des aide-mémoire ou la documentation de référence de l'API.
assets/	Non	Fichiers utilisés dans la sortie (tels que des modèles ou des images) qui ne sont pas chargés directement dans le contexte du prompt de Gemini Enterprise.

Exigences concernant le frontmatter YAML

Le fichier SKILL.md doit commencer par un bloc YAML frontmatter valide entouré de délimiteurs --- au tout début du fichier, suivi du corps des instructions Markdown (limite stricte de 500 000 caractères ; les importations dépassant cette limite échouent).

Le frontmatter YAML accepte les champs suivants :

Champ	Obligatoire	Format et contraintes
name	Oui	Identifiant unique de la compétence (entre 1 et 64 caractères). Il ne doit contenir que des lettres minuscules (a-z), des chiffres (0-9) et des traits d'union (-). Il ne doit pas commencer ni se terminer par un trait d'union (-), ni contenir des traits d'union consécutifs (--). S'il est importé dans un dossier, la valeur name doit correspondre au nom du dossier parent.
description	Oui	Une description fonctionnelle (de 1 à 1 024 caractères) expliquant ce que fait la compétence et quand Gemini Enterprise doit l'appeler. Incluez des mots clés déclencheurs pour aider Gemini Enterprise à identifier quand la compétence est pertinente. Il s'agit d'une limite stricte. Si la description dépasse 1 024 caractères, l'importation de la compétence échoue avec l'erreur suivante : A field in your SKILL.md is too long. Shorten the name, description or the instructions.
license	Non	Licence de distribution de logiciels ou de contenus qui s'applique au package de compétences (jusqu'à 1 024 caractères), telle qu'un identifiant de licence SPDX Open Source (par exemple, Apache-2.0 ou MIT) ou Proprietary. Ce champ spécifie les conditions d'utilisation du fichier de compétence lui-même, et non d'une licence d'abonnement utilisateur ou d'application Gemini Enterprise. Si spécifiée, la valeur ne doit pas être vide.
metadata	Non	Mappage clé-valeur facultatif de tags, d'auteurs ou de paramètres de version personnalisés. Les clés doivent être des chaînes scalaires, et les valeurs doivent être des chaînes scalaires ou des listes de chaînes scalaires.

Fichier SKILL.md d'exemple

L'exemple suivant montre un fichier SKILL.md valide :

---
name: brand-voice-reviewer
description: Reviews marketing copy and legal contracts to ensure compliance with brand voice guidelines. Use when asked to review, edit, or draft customer-facing text.
---

# Brand Voice Reviewer

Follow these guidelines when reviewing or drafting customer-facing text:

1. Use clear, concise, and active language.
2. Avoid jargon and unverified claims.
3. Verify that terminology aligns with the company style guide.

Contraintes liées aux archives ZIP

Lorsque vous importez une compétence sous forme d'archive ZIP, assurez-vous qu'elle répond aux exigences de validation suivantes :

• Fichier SKILL.md unique : chaque archive ZIP doit contenir exactement un fichier SKILL.md situé soit à la racine de l'archive (SKILL.md), soit dans un seul dossier de wrapper de premier niveau (jusqu'à trois niveaux de profondeur, par exemple my-skill/SKILL.md).
• Taille de l'archive : taille maximale de l'archive ZIP compressée de 100 Mo et taille totale maximale non compressée de 100 Mo.
• Nombre de fichiers : 100 fichiers maximum par archive ZIP.
• Profondeur d'imbrication des répertoires : profondeur d'imbrication maximale de 10 niveaux par rapport à la racine de la compétence.
• Intégrité du chemin d'accès : les chemins d'accès aux fichiers en double et les références au répertoire parent (..) ne sont pas autorisés.

Importer une compétence dans l'application Web

Pour importer une compétence, procédez comme suit :

1. Connectez-vous à l'application Web Gemini Enterprise.
2. Dans le menu de navigation, cliquez sur Compétences.
3. Cliquez sur l'icône Ajouter, puis sur Importer une compétence.
4. Faites glisser le fichier Markdown ou le fichier ZIP, ou parcourez vos fichiers pour le trouver, puis cliquez sur Importer. Gemini Enterprise active la compétence par défaut.

Remarque : Si l'importation échoue avec une erreur telle que Upload failed. Details: Request contains an invalid argument, vérifiez les points suivants :

• Votre fichier SKILL.md commence par un frontmatter YAML valide entouré de délimiteurs ---.
• Le frontmatter inclut les champs obligatoires name et description dans la limite du nombre maximal de caractères.
• Le champ name n'utilise que des lettres minuscules, des chiffres et des traits d'union (et correspond au nom du dossier parent s'il est importé dans une archive ZIP).
• Votre archive respecte les contraintes liées aux archives ZIP.

Parcourir les compétences

Vous pouvez parcourir et installer des compétences en utilisant les sections suivantes pour filtrer la liste :

Section	Description
Tous	Les compétences gérées par Google et celles créées par l'utilisateur.
Google	Compétences intégrées fournies par Google.
Partagés avec moi	Compétences en lecture seule créées par d'autres utilisateurs et partagées avec vous.

Pour parcourir et installer une skill, procédez comme suit :

1. Connectez-vous à l'application Web Gemini Enterprise.
2. Dans le menu de navigation, cliquez sur Compétences.
3. Cliquez sur l'icône Ajouter, puis sur Parcourir les compétences.
4. Recherchez la compétence que vous souhaitez utiliser, puis cliquez sur + Installer.

Mettre à jour une compétence

Pour mettre à jour une compétence existante, procédez comme suit :

1. Connectez-vous à l'application Web Gemini Enterprise.
2. Dans le menu de navigation, cliquez sur Compétences.
3. Cliquez sur le nom de la compétence que vous souhaitez modifier.
4. Cliquez sur l'icône  à côté de la compétence, puis sur Modifier.
5. Apportez les modifications nécessaires aux instructions, au nom ou à la description.
6. Cliquez sur Enregistrer.

Pour revenir à la page "Compétences", cliquez sur Compétences.

Partager une compétence

Si votre administrateur Gemini Enterprise active le partage de compétences, vous pouvez partager les compétences que vous créez avec d'autres utilisateurs.

Remarque : Le partage d'une compétence n'envoie pas de notification par e-mail. Pour trouver la compétence, les destinataires doivent accéder à la section Partagées avec moi dans Parcourir les compétences.

Pour partager une compétence, procédez comme suit :

1. Connectez-vous à l'application Web Gemini Enterprise.
2. Dans le menu de navigation, cliquez sur Compétences.
3. Recherchez la compétence que vous avez créée et que vous souhaitez partager.
4. Cliquez sur l'icône à côté de la compétence, puis sur Partager.
5. Dans la boîte de dialogue Partager la compétence, saisissez les adresses e-mail des utilisateurs avec lesquels vous souhaitez partager la compétence, en les séparant par une virgule.
6. Cliquez sur OK.

Remarque : Si votre administrateur Gemini Enterprise exige une approbation pour les demandes de partage, les autres utilisateurs ne peuvent pas accéder à la compétence tant que l'administrateur n'a pas approuvé la demande.

Utiliser une compétence

Vous pouvez utiliser des compétences directement dans vos conversations par chat dans l'application Web Gemini Enterprise.

Tester une compétence depuis la page "Compétences"

Vous pouvez tester une compétence directement depuis la page Compétences en démarrant une nouvelle session de chat avec cette compétence :

1. Connectez-vous à l'application Web Gemini Enterprise.
2. Dans le menu de navigation, cliquez sur Compétences.
3. Cliquez sur l'icône  à côté de la compétence, puis sur Nouvelle discussion. Gemini Enterprise ouvre une nouvelle discussion faisant référence à la compétence sélectionnée.

Invoquer une compétence dans une conversation

Vous pouvez appeler des compétences de manière dynamique pendant une conversation pour personnaliser les réponses de l'assistant.

Remarque : Vous pouvez utiliser des compétences et des agents de manière dynamique, mais vous ne pouvez pas appeler à la fois un agent et une compétence dans la même requête.

Lorsque vous discutez avec l'assistant Gemini Enterprise, vous pouvez utiliser les compétences de différentes manières :

• Mentions manuelles : vous pouvez appeler explicitement une compétence à l'aide de la fonctionnalité de mention @ ou / dans la zone de chat (par exemple, @Brand Voice ou /Brand Voice). Saisir / ouvre un menu affichant uniquement vos compétences disponibles, tandis que saisir @ ouvre le menu des mentions générales.
• Requêtes directes : si vous avez besoin que Gemini Enterprise utilise une compétence spécifique, vous pouvez le demander directement dans votre prompt. Exemple : Use the brand voice skill to review this.
• Sélection automatique : Gemini Enterprise utilise automatiquement une compétence lorsqu'elle est pertinente pour votre tâche, en fonction de la description de la compétence et des instructions de déclenchement.

Désactiver une compétence

Pour empêcher Gemini Enterprise d'utiliser une compétence spécifique, désactivez-la. Lorsque vous désactivez une compétence, Gemini Enterprise ne l'appelle pas dans les conversations.

Pour désactiver une compétence, procédez comme suit :

1. Connectez-vous à l'application Web Gemini Enterprise.
2. Dans le menu de navigation, cliquez sur Compétences.
3. Sur la page Compétences, recherchez la compétence que vous souhaitez désactiver.
4. Cliquez sur le bouton à côté de la compétence pour la désactiver.

Désinstaller une compétence

Pour supprimer une compétence installée de votre page Compétences, procédez comme suit :

1. Connectez-vous à l'application Web Gemini Enterprise.
2. Dans le menu de navigation, cliquez sur Compétences.
3. Cliquez sur l'icône  à côté de la compétence, puis sur Désinstaller.

Remarque : Désactiver une compétence met en veille son déclenchement automatique, mais la conserve sur la page Compétences. Désinstaller une compétence la supprime de votre page Compétences, mais elle reste disponible dans Parcourir les compétences pour que vous puissiez la réinstaller.

États des compétences

En plus d'activer ou de désactiver vous-même des compétences, votre administrateur peut modifier l'état d'une compétence, ce qui affecte sa disponibilité :

• Suspendue : votre administrateur désactive temporairement la compétence. Elle reste visible sur la page Compétences avec l'état "Suspendue", mais les autres utilisateurs ne peuvent pas l'appeler dans les conversations tant que l'administrateur ne l'a pas réactivée. Les propriétaires de compétences peuvent mettre à jour et tester la compétence.
• Désactivée : votre administrateur masque temporairement la compétence aux autres utilisateurs, en la supprimant de leur page Compétences. La compétence reste visible par son propriétaire, qui peut la mettre à jour et la tester jusqu'à ce que l'administrateur la réactive.
• Supprimée : votre administrateur supprime définitivement la compétence de l'application Web Gemini Enterprise. Vous ne pouvez donc plus l'utiliser.

Limites

Cette section liste les limites des compétences dans Gemini Enterprise :

• Les compétences ne sont pas disponibles pour les agents.
• Les compétences ne sont compatibles qu'avec l'exécution de Python et Bash.
• L'éditeur d'application Web vous permet de créer des compétences en saisissant des instructions dans les champs du formulaire ou en discutant avec l'assistant, qui génère automatiquement un seul fichier SKILL.md. Vous devez importer les compétences plus complexes qui nécessitent des scripts ou des fichiers supplémentaires sous forme de fichier ZIP.
• La création de compétences en langage naturel n'utilise pas le contexte de votre conversation ni les connecteurs comme entrées pour créer une compétence.
• Les compétences fonctionnent mieux avec Canvas lorsqu'une compétence ne comporte qu'un seul fichier SKILL.md.
• Un fichier SKILL.md est soumis à des limites de longueur strictes : 64 caractères pour name, 1 024 caractères pour description et 500 000 caractères pour le corps des instructions Markdown. Les archives ZIP importées ne peuvent pas dépasser 100 Mo (compressées ou non compressées), 100 fichiers ou 10 niveaux d'imbrication de répertoires.

Étapes suivantes

• Découvrez comment les administrateurs gèrent les compétences.