Créer un Gem : votre propre assistant réutilisable

Un Gem est une configuration Gemini enregistrée : un nom, un jeu d'instructions permanentes et, éventuellement, des fichiers de référence, qui transforme un prompt répété en assistant accessible en un clic. Au lieu de recoller chaque matin le même préambule de 300 mots « agis comme notre éditeur de marque », vous le construisez une fois et vous l'ouvrez quand vous en avez besoin.

Cette leçon en construit un vrai : un Gem « Brand Voice Rewriter ». Nous allons le configurer, le tester, puis regarder dans quels cas un Gem bat vraiment un prompt ponctuel bien écrit, et dans quels cas non.

Ce qu'est réellement un Gem sous le capot

Un Gem est une system instructionsystem instructionLes 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, plus des connaissances optionnelles, rattachée à une surface de chat dans l'application Gemini. Quand vous ouvrez un Gem, ces instructions sont ajoutées en tête de chaque tour de cette conversation. Le modèle tourne toujours sur les tiers Pro ou Flash habituels, garde la même fenêtre de contexte, garde la multimodalité native. Le Gem garantit simplement que les instructions et le matériel de référence sont présents chaque fois, sans que vous les retapiez.

Deux conséquences pratiques :

• Un Gem est cadré sur un comportement, pas sur une question unique. « Réécris ceci dans notre voix » est un comportement. « Quelle est la capitale de la France » non.
• Les instructions d'un Gem sont du contexte permanent. Elles consomment la même fenêtre que votre tâche réelle, donc gardez-les serrées. Un jeu d'instructions gonflé à 2 000 mots n'est pas « exhaustif », c'est un surcoût sur chaque tour.

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 dans l'application Gemini (la zone « Explorer les Gems » / « Nouveau Gem » dans la barre latérale). Les administrateurs Workspace peuvent aussi publier des Gems partagés à toute une organisation, ce qui fait la différence entre une habitude personnelle et un standard d'équipe.

Concevoir le brand voice rewriter

Avant de toucher à l'interface, décidez les trois choses dont tout Gem a besoin :

1. Un nom et une raison d'être en une ligne. « Brand Voice Rewriter : transforme n'importe quel brouillon dans notre voix maison. »
2. Le travail qu'il fait, formulé comme un comportement. Ce qui entre, ce qui sort, ce qu'il ne doit jamais faire.
3. Les connaissances dont il a besoin. Votre vrai guide de style, des paires d'exemples avant/après, les mots interdits.

L'échec le plus fréquent d'un Gem, c'est des instructions vagues. « Fais que ça sonne on-brand » ne dit rien au modèle. Vous devez encoder la marque sous forme de règles et d'exemples. Les exemples comptent plus que les adjectifs.

Écrire les instructions

Voici un jeu d'instructions complet pour le Gem. Remarquez qu'il est structuré, précis, et qu'il montre des exemples au lieu de seulement les décrire.

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.

Ce dernier bloc, c'est celui que les gens sautent. Les règles de cas limites (quoi faire d'un texte déjà dans la voix, quoi faire d'un fragment) sont ce qui rend un Gem fiable à l'échelle d'une équipe, et pas seulement pour vous un bon jour.

Ajouter des fichiers de connaissances

Les instructions couvrent les règles. Les fichiers de connaissances couvrent le détail qui ne tient pas en ligne. Attachez le PDF de votre vrai guide de style, un glossaire des noms de produits approuvés, et un document de 10 à 15 paires de réécriture avant/après. Le Gem les lit comme référence, donc quand quelqu'un colle une phrase à propos de votre produit « FreightSync », il utilise la bonne graphie et la bonne description.

Quelques habitudes d'attachement à garder :

• Préférez des fichiers propres et structurés (un document net de paires) à un dépotoir de 90 pages de bible de marque. Le modèle s'appuie mieux sur du signal que sur du volume.
• Gardez une banque d'exemples dans son propre fichier pour pouvoir l'enrichir. Chaque fois que le Gem se trompe sur une réécriture, ajoutez la paire corrigée. Le Gem s'affine dans le temps sans que vous réécriviez les instructions.

Le construire dans l'application Gemini

La mécanique est rapide :

1. Ouvrez Gemini, allez dans la zone Gems, choisissez Nouveau Gem.
2. Collez le nom et le bloc d'instructions ci-dessus.
3. Téléversez votre guide de style et vos fichiers de paires d'exemples comme connaissances.
4. Utilisez le panneau d'aperçu en direct à droite pour tester avant d'enregistrer.
5. Enregistrez. Il vit maintenant dans votre barre latérale.

La procédure officielle et les détails actuels de l'interface sont dans la documentation d'aide Gems de Google, qui vaut le coup d'œil puisque la mise en page bouge au fil des évolutions du produit.

Le tester comme un ingénieur, pas comme un fan

Ne testez pas avec l'exemple que vous avez déjà mis dans les instructions. Testez avec des cas conçus pour le casser :

• Une phrase déjà propre (est-ce qu'il la laisse à peu près tranquille ?).
• Une phrase bourrée de trois mots interdits (est-ce qu'il attrape les trois ?).
• Un fragment d'une ligne (est-ce qu'il pose une question de clarification, ou est-ce qu'il hallucine du contexte ?).
• Un paragraphe contenant un vrai chiffre (est-ce qu'il préserve le chiffre exactement ?).

Passez-les dans l'aperçu. Quand ça échoue, corrigez l'instruction ou ajoutez une paire d'exemples, puis retestez. Cette boucle, test adversarial puis correctif, c'est le vrai travail de construction d'un bon Gem. La partie interface prend cinq minutes ; c'est le test qui le rend digne de confiance.

Si vous voulez des tests reproductibles et automatisés sur beaucoup d'entrées, c'est le signe que vous avez dépassé l'application. Le même texte d'instruction devient une system_instruction dans l'API Gemini via Google AI Studio, où vous pouvez 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-2.5-flash",
        config={"system_instruction": BRAND_VOICE},
        contents=draft,
    )
    print(f"IN:  {draft}\nOUT: {resp.text}\n")

C'est le même comportement de Gem, désormais sous forme de code exécutable en CI. 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 → partagent la même idée : une system instruction est la colonne vertébrale des deux.

Quand un Gem bat un prompt ponctuel (et quand non)

C'est le jugement qui sépare ceux qui collectionnent les Gems de ceux qui les utilisent.

Un Gem gagne quand :

• Le comportement se répète. Vous faites cette tâche chaque semaine ou chaque jour. La réutilisation amortit le coût de mise en place.
• La cohérence entre personnes compte. Cinq marketeurs doivent produire la même voix. Un Gem partagé, publié par un admin, l'impose ; cinq prompts mémorisés séparément non.
• Les instructions sont longues ou tatillonnes. Si votre prompt contient des mots interdits, des cas limites et des exemples, le retaper est source d'erreurs. Un Gem fige la bonne version.
• Vous le voulez à côté de votre travail. Un Gem enregistré, c'est un clic dans la barre latérale.

Un prompt ponctuel gagne quand :

• La tâche est vraiment unique. Un Gem que vous utilisez une fois n'est qu'un prompt plus lent.
• Chaque exécution a besoin d'instructions différentes. Si les « règles » changent à chaque fois, il n'y a pas de comportement stable à enregistrer.
• Vous en avez besoin dans un document ou une boîte mail. Les Gems vivent dans l'application Gemini. Pour « réécris ce paragraphe ici même », Gemini dans Google Workspace (le panneau latéral dans Docs et Gmail) est la meilleure surface. Il voit le document dans lequel vous êtes.

Ce dernier point est la frontière la plus utile. Un Gem est un *assistant réutilisable vers lequel vous allez*. Gemini dans Workspace est une aide qui *vient à vous* dans le fichier. Le Brand Voice Rewriter en Gem est parfait pour réécrire en volume un lot de brouillons collés. Pour polir une ligne au fil de l'écriture, le panneau latéral de Docs est plus rapide.

Quand vous avez complètement dépassé les Gems

Les Gems sont volontairement simples : instructions plus connaissances, pas de logique personnalisée, pas d'outils externes. Vous avez dépassé un Gem dès que vous avez besoin de l'un de ces éléments :

• Un accès programmatique. D'autres logiciels l'appellent. Passez à l'API Gemini.
• Des données en direct ou l'usage d'outils. Il doit interroger votre base 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.
• De l'automatisation tableur ou Workspace. Un Gem ne peut pas tourner selon un planning ni transformertransformerUn Transformer est une architecture de réseau de neurones qui utilise le self-attention pour traiter des séquences en parallèle. Elle est au cœur de la plupart des modèles de langage et d'IA générative actuels.Voir la définition complète → un Sheet. Apps Script avec l'API Gemini, si.
• Des faits actuels et sourcés. Un Gem ne navigue pas pour vous. Pour des réponses à jour, utilisez Gemini avec le grounding via Google Search, configuré dans l'API ou AI Studio.

Un Gem est le bon outil à exactement une couche : un comportement fixe que vous déclenchez à la main. Dès qu'il doit *agir de lui-même* 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

• Construisez un Gem quand le comportement se répète et que la cohérence compte, surtout à l'échelle d'une équipe. Pour des tâches vraiment uniques, un prompt bien écrit est plus rapide.
• Encodez la marque ou le comportement en règles plus exemples, pas en adjectifs. « Fais que ça soit on-brand » échoue ; une liste de mots interdits et des paires avant/après fonctionnent.
• Incluez toujours des instructions de cas limites (texte déjà dans la voix, fragments, préservation des chiffres). C'est ce qui rend un Gem fiable pour les autres, pas seulement pour vous.
• Testez de façon adversariale avant de lui faire confiance : entrée propre, entrée avec mots interdits, fragments, vrais chiffres. Corrigez les instructions ou la banque d'exemples, puis retestez.
• Connaissez le chemin de montée en gamme : pour l'aide dans le document, Gemini dans Workspace ; pour le code, l'API Gemini ; pour les outils ou les données en direct, passez à l'ADK sur Vertex AI.