Gemini · Créer un Gem : votre propre assistant réutilisable
Un Gem est une configuration Gemini enregistrée : un nom, un ensemble d'instructions permanentes et, en option, des fichiers de référence. Il transforme un prompt répété en assistant accessible en un clic. Au lieu de coller chaque matin le même préambule de 300 mots « agis comme notre éditeur de marque », vous le construisez une fois et l'ouvrez dès que vous en avez besoin.
Cette leçon en construit un vrai, un Gem « Brand Voice Rewriter ». Nous allons le configurer, le tester, puis voir quand un Gem fait mieux qu'un bon prompt ponctuel, et quand ce n'est pas le cas.
Ce qu'est réellement un Gem
Un Gem est une instruction systèmeinstruction systèmeLes instructions cachées qui définissent le comportement d'un assistant IA avant toute question : son rôle, son ton, ses limites et ses règles.Voir la définition complète → persistante, avec des connaissances en option, enregistrée dans votre compte Gemini app. Quand vous ouvrez un Gem, ces instructions s'appliquent à chaque échange de la conversation. Le modèle tourne toujours sur les modèles Gemini habituels auxquels vous avez accès, avec la fenêtre de contexte complète et la multimodalité native. Le Gem garantit que les instructions et les documents de référence sont présents à chaque fois, sans que vous ayez à les retaper.
Deux conséquences pratiques :
- Un Gem porte sur un comportement, pas sur une question isolée. « Réécris ceci dans notre ton » est un comportement. « Quelle est la capitale de la France » n'en est pas un.
- Les instructions d'un Gem sont un contexte permanent. Elles consomment la même fenêtre que votre tâche réelle, donc gardez-les concises. Un jeu d'instructions gonflé à 2 000 mots n'est pas de la rigueur, c'est un surcoût à chaque échange.
Vous crcrLe pourcentage de visiteurs ou de prospects qui réalisent une action attendue (achat, inscription, formulaire de contact), calculé en divisant les conversions par le nombre total d'opportunités.Voir la définition complète →éez et gérez vos Gems depuis le gestionnaire de Gems de l'application Gemini (la zone « Explore Gems » / « New Gem » de la barre latérale). Vous pouvez aussi partager un Gem avec vos collègues comme vous partagez un fichier Google Drive, en choisissant qui peut l'utiliser et qui peut le modifier. C'est la différence entre une habitude personnelle et un standard d'équipe.
Concevoir le Brand Voice Rewriter
Avant de toucher à l'interface, décidez de trois choses :
- Un nom et un objectif en une ligne. « Brand Voice Rewriter : transforme n'importe quel brouillon dans notre ton maison. »
- La tâche, formulée comme un comportement. Ce qui entre, ce qui sort, ce qu'il ne doit jamais faire.
- Les connaissances nécessaires. Votre vrai guide de style, des paires d'exemples avant/après, les mots interdits.
L'échec le plus courant d'un Gem, ce sont des instructions vagues. « Fais en sorte que ce soit on-brand » ne dit rien au modèle. Il faut traduire la marque en règles et en exemples. Les exemples comptent plus que les adjectifs.
Rédiger les instructions
Voici un jeu d'instructions complet pour le Gem. Il est structuré et précis, et il montre un exemple au lieu de se contenter d'en décrire un.
You are the Brand Voice Rewriter for Northwind, a B2B logistics company.
YOUR JOB
Take any draft text the user pastes and rewrite it in Northwind's voice.
Output only the rewritten text, then a one-line note on what you changed.
Never invent facts, prices, dates, or features that were not in the input.
OUR VOICE
- Direct and confident. Lead with the outcome, not the backstory.
- Plain words. Replace "utilize" with "use", "leverage" with "use".
- Short sentences. Max ~20 words. No semicolons.
- Warm but not cute. No exclamation marks, no emoji.
BANNED WORDS: synergy, seamless, world-class, revolutionary, game-changer.
EXAMPLE
Input: "We are excited to leverage our world-class network to seamlessly
deliver your freight in a timely manner!"
Output: "Your freight moves on our network and arrives on schedule."
IF the input is already on-voice, say so and make only minimal edits.
IF the input is ambiguous (e.g. a fragment), ask one clarifying question.On oublie souvent ce dernier bloc. Les règles pour les cas limites (que faire d'un texte déjà dans le ton, que faire d'un fragment) rendent un Gem fiable pour toute une équipe, et pas seulement pour vous un jour où tout va bien.
Ajouter des fichiers de connaissances
Les instructions couvrent les règles. Les fichiers de connaissances couvrent le détail qui ne tient pas dans le texte. Joignez votre vrai guide de style, un glossaire des noms de produits validés et un document de 10 à 15 paires de réécriture avant/après. Vous pouvez téléverser des fichiers ou les joindre depuis Google Drive. Les fichiers Drive restent liés, donc les modifications du document se répercutent dans le Gem. Le Gem les lit comme référence : quand quelqu'un colle une phrase sur votre produit « FreightSync », il utilise la bonne casse et la bonne description.
Deux habitudes à garder pour les pièces jointes :
- Préférez des fichiers propres et structurés (un document soigné de paires) à un dépôt de 90 pages de bible de marque. Le modèle s'ancre mieux sur le signal que sur le volume.
- Tenez une banque d'exemples dans un fichier à part pour pouvoir l'enrichir. Chaque fois que le Gem rate une réécriture, ajoutez la paire corrigée. Le Gem s'affine sans que vous ayez à réécrire les instructions.
Le construire dans l'application Gemini
La mécanique est rapide :
- Ouvrez Gemini, allez dans la zone Gems, choisissez New Gem.
- Collez le nom et le bloc d'instructions ci-dessus.
- Ajoutez votre guide de style et vos fichiers de paires d'exemples comme connaissances.
- Utilisez le panneau d'aperçu pour tester avant d'enregistrer.
- Enregistrez. Le Gem figure désormais dans votre liste, prêt à être ouvert ou partagé.
Le guide officiel et les détails actuels de l'interface se trouvent dans la documentation d'aide Gems de Google. Consultez-la, car la mise en page change au fil des évolutions du produit.
Tester en ingénieur, pas en fan
Ne testez pas avec l'exemple déjà présent dans les instructions. Testez avec des cas conçus pour le faire échouer :
- Une phrase déjà propre (la laisse-t-il à peu près intacte ?).
- Une phrase truffée de trois mots interdits (les repère-t-il tous les trois ?).
- Un fragment d'une ligne (pose-t-il une question de clarification, ou invente-t-il un contexte ?).
- Un paragraphe contenant un vrai chiffre (conserve-t-il ce chiffre à l'identique ?).
Passez ces cas dans l'aperçu. En cas d'échec, corrigez l'instruction ou ajoutez une paire d'exemples, puis testez à nouveau. Cette boucle de tests adverses et de correctifs est le vrai travail de construction d'un bon Gem. La partie interface prend cinq minutes. Ce sont les tests qui le rendent fiable.
Si vous voulez des tests automatisés et reproductibles sur de nombreux inputs, l'application ne suffit plus. Le même texte d'instructions devient un system_instruction dans l'API Gemini, avec une clé obtenue sur Google AI Studio. Vous pouvez alors scripter un jeu de tests :
from google import genai
client = genai.Client() # lit GEMINI_API_KEY depuis l'environnement
BRAND_VOICE = open("brand_voice_instructions.txt").read()
drafts = [
"We leverage our world-class network for seamless delivery!",
"Shipment 4471 departs Tuesday.",
"synergy",
]
for draft in drafts:
resp = client.models.generate_content(
model="gemini-flash-latest", # ou figez une version depuis la page des modèles
config={"system_instruction": BRAND_VOICE},
contents=draft,
)
print(f"IN: {draft}\nOUT: {resp.text}\n")Pour la CI, figez une version précise du modèle depuis la page des modèles afin que les résultats ne dérivent pas quand l'alias change. Le Gem de l'application et l'APIAPIApplication Programming Interface : une interface standardisée qui permet aux applications de communiquer et d'échanger des données sans connaître leur fonctionnement interne respectif.Voir la définition complète → reposent sur la même idée : l'instruction système est la colonne vertébrale des deux.
Vérification des acquis
1. D'après la leçon, qu'est-ce qui distingue fondamentalement un Gem d'un prompt ponctuel classique ?
2. Pourquoi la leçon met-elle en garde contre un jeu d'instructions gonflé à 2 000 mots pour un Gem ?
3. La leçon indique que l'échec le plus courant d'un Gem vient d'instructions vagues comme « fais en sorte que ce soit on-brand ». Quelle est la solution recommandée ?
4. Sélectionnez TOUTES les affirmations qui décrivent correctement quand un Gem est pertinent par rapport à un simple prompt.
Sélectionnez toutes les réponses correctes.
5. Sélectionnez TOUS les éléments parmi les trois essentiels dont, selon la leçon, chaque Gem a besoin avant de toucher à l'interface.
Sélectionnez toutes les réponses correctes.
Quand un Gem fait mieux qu'un prompt ponctuel (et quand ce n'est pas le cas)
C'est ce jugement qui distingue ceux qui collectionnent les Gems de ceux qui s'en servent.
Un Gem l'emporte quand :
- Le comportement se répète. Vous faites cette tâche chaque semaine ou chaque jour, donc la réutilisation rembourse le coût de mise en place.
- La cohérence entre personnes compte. Cinq marketeurs doivent produire le même ton. Un Gem partagé l'impose. Cinq prompts mémorisés chacun de son côté, non.
- Les instructions sont longues ou délicates. Si votre prompt comporte des mots interdits, des cas limites et des exemples, le retaper expose aux erreurs. Un Gem fige la bonne version.
- Vous le voulez à côté de votre travail. Les Gems sont disponibles dans l'application Gemini et dans le panneau latéral Gemini des applications Workspace comme Gmail et Docs, donc le Brand Voice Rewriter peut se trouver à côté de l'e-mail que vous rédigez.
Un prompt ponctuel l'emporte quand :
- La tâche est réellement unique. Un Gem utilisé une seule fois n'est qu'un prompt plus lent.
- Chaque exécution demande des instructions différentes. Si les « règles » changent à chaque fois, il n'y a pas de comportement stable à enregistrer.
Le panneau latéral compte ici. Dans Docs, Gemini voit le document dans lequel vous êtes. Pour « resserre ce paragraphe, ici » sans règles maison, Gemini seul dans le panneau latéral est le plus rapide. Quand les règles maison comptent, ouvrez le Gem depuis ce même panneau : vous avez à la fois le contexte du document et vos règles de ton.
Quand les Gems ne suffisent plus du tout
Les Gems sont volontairement simples : des instructions et des connaissances, pas de code personnalisé, pas de connexion à vos propres systèmes. Ils peuvent utiliser les capacités intégrées de Gemini, Google Search compris, mais vous ne pouvez pas y brancher vos propres outils. Un Gem ne suffit plus quand vous avez besoin de l'un de ces éléments :
- Un accès programmatique. D'autres logiciels l'appellent. Passez à l'API Gemini.
- Vos propres données ou outils. Il doit interroger votre base de données ou appeler un service interne en cours de tâche. C'est un agent, construit avec l'Agent Development Kit (ADK) et déployé sur Vertex AI.
- Une automatisation planifiée ou en masse. Un Gem s'exécute quand une personne l'ouvre. Pour traiter une Sheet chaque nuit, utilisez Apps Script avec l'API Gemini.
- Un grounding maîtrisé. Si vous avez besoin de citations, de sources journalisées ou d'un grounding de recherche que vous configurez vous-même, mettez en place le grounding avec Google Search dans l'API ou AI Studio.
Un Gem occupe exactement une couche : un comportement fixe que vous déclenchez à la main. Dès qu'il doit agir seul ou être appelé par du code, vous entrez dans le territoire des agents et de l'API, que couvre la suite de ce parcours.
Points clés
- Créez un Gem quand le comportement se répète et que la cohérence compte, surtout au sein d'une équipe. Partagez-le comme un fichier Drive pour que tout le monde utilise la même version.
- Traduisez la marque ou le comportement en règles et en exemples, pas en adjectifs. « Fais-le on-brand » échoue. Une liste de mots interdits et des paires avant/après fonctionnent.
- Incluez toujours des instructions pour les cas limites (texte déjà dans le ton, fragments, conservation des chiffres). Elles rendent un Gem fiable pour les autres, pas seulement pour vous.
- Testez de façon adverse avant de lui faire confiance : input propre, input avec mots interdits, fragments, vrais chiffres. Corrigez les instructions ou la banque d'exemples, puis testez à nouveau.
- Les Gems fonctionnent dans l'application Gemini et dans le panneau latéral Workspace. Pour du code, utilisez l'API Gemini ; pour vos propres outils ou données, passez à l'ADK sur Vertex AI.
À faire, tiré de cette leçon
Ces actions sont compilées dans le plan d'action du rôle.
- Créez un Gem à la troisième répétition, quand le setup est stable
- Encodez le comportement de marque sous forme de listes de mots interdits et de paires avant/après, pas d'adjectifs