Ein Gem bauen: Ihr eigener wiederverwendbarer Assistent

# Ein Gem bauen: Ihr eigener wiederverwendbarer Assistent

Ein Gem ist eine gespeicherte Gemini-Konfiguration: ein Name, ein Satz dauerhafter Instruktionen und optional einige Referenzdateien, die aus einem wiederkehrenden Prompt einen Assistenten mit einem Klick machen. Statt jeden Morgen dieselbe 300-Wörter-Präambel „agiere als unser Brand Editor" einzufügen, bauen Sie sie einmal und öffnen sie, wann Sie sie brauchen.

In dieser Lektion bauen wir ein echtes: ein „Brand Voice Rewriter"-Gem. Wir richten es ein, testen es und schauen dann, wann ein Gem einem scharf formulierten Einzelprompt wirklich überlegen ist und wann nicht.

Was ein Gem technisch eigentlich ist

Ein Gem ist eine persistente System-Instruktion plus optionales Wissen, angebunden an eine Chat-Oberfläche in der Gemini-App. Wenn Sie ein Gem öffnen, werden diese Instruktionen jedem Turn in dieser Konversation vorangestellt. Das Modell läuft weiter auf den normalen Pro- oder Flash-Tiers, hat weiter das volle Context WindowContext WindowDas Context Window ist die maximale Textmenge (gemessen in Tokens), die ein Sprachmodell auf einmal verarbeiten kann, einschließlich Input-Prompt und generiertem Output.Vollständige Definition ansehen →, beherrscht weiter native Multimodalität. Das Gem garantiert nur, dass Instruktionen und Referenzmaterial jedes Mal auftauchen, ohne dass Sie sie neu eintippen.

Zwei praktische Konsequenzen:

• Ein Gem ist auf ein Verhalten zugeschnitten, nicht auf eine einzelne Frage. „Schreibe das in unserer Voice um" ist ein Verhalten. „Was ist die Hauptstadt von Frankreich" nicht.
• Die Instruktionen eines Gems sind stehender Kontext. Sie fressen dasselbe Window auf, das Ihre eigentliche Aufgabe nutzt, also halten Sie sie knapp. Ein aufgeblähtes Instruktionsset mit 2.000 Wörtern ist nicht „gründlich", es ist Overhead bei jedem einzelnen Turn.

Sie erstellen und verwalten Gems im Gem-Manager der Gemini-App (Bereich „Explore Gems" / „New Gem" in der Seitenleiste). Workspace-Admins kkDie durchschnittliche Zahl neuer Nutzer, die jeder bestehende Nutzer über Empfehlungen generiert. Über 1,0 verstärkt sich das Wachstum selbst und wird exponentiell.Vollständige Definition ansehen →önnen Gems auch für eine ganze Organisation veröffentlichen, und das ist der Unterschied zwischen einer persönlichen Gewohnheit und einem Team-Standard.

Den Brand Voice Rewriter entwerfen

Bevor Sie die UI anfassen, entscheiden Sie die drei Dinge, die jedes Gem braucht:

1. Einen Namen und einen Zweck in einer Zeile. „Brand Voice Rewriter: macht aus jedem Draft unsere House Voice."

2. Die Aufgabe, formuliert als Verhalten. Was geht rein, was kommt raus, was soll es nie tun.

3. Das Wissen, das es braucht. Ihren echten Style Guide, Beispielpaare vorher/nachher, verbotene Wörter.

Der häufigste Grund, warum ein Gem scheitert, sind vage Instruktionen. „Lass es on-brand klingen" sagt dem Modell nichts. Sie müssen die Marke als Regeln und Beispiele kodieren. Die Beispiele zählen mehr als die Adjektive.

Die Instruktionen schreiben

Hier ein komplettes Instruktionsset für das Gem. Beachten Sie: es ist strukturiert, konkret und zeigt Beispiele, statt sie nur zu beschreiben.

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.

Genau diesen letzten Block überspringen die meisten. Regeln für Edge Cases (was tun mit Text, der schon on-voice ist, was tun mit Fragmenten) machen ein Gem im ganzen Team verlässlich, statt nur bei Ihnen an einem guten Tag.

Knowledge-Dateien hinzufügen

Instruktionen deckenal die Regeln ab. Knowledge-Dateien decken das Detail ab, das nicht inline passt. Hängen Sie Ihren echten Style Guide als PDF an, ein Glossar der freigegebenen Produktnamen und ein Dokument mit 10 bis 15 Vorher/Nachher-Paaren. Das Gem liest das als Referenz, sodass es bei einem Satz über Ihr Produkt „FreightSync" die korrekte Schreibweise und Beschreibung verwendet.

Ein paar Gewohnheiten beim Anhängen, die sich lohnen:

• Bevorzugen Sie saubere, strukturierte Dateien (ein aufgeräumtes Dokument mit Paaren) gegenüber dem Dump einer 90-seitigen Markenbibel. Das Modell groundet besser auf Signal als auf Volumen.
• Führen Sie eine Beispielsammlung als eigene Datei, damit Sie sie ausbauen kkDie durchschnittliche Zahl neuer Nutzer, die jeder bestehende Nutzer über Empfehlungen generiert. Über 1,0 verstärkt sich das Wachstum selbst und wird exponentiell.Vollständige Definition ansehen →önnen. Jedes Mal, wenn das Gem eine Umschreibung falsch macht, fügen Sie das korrigierte Paar hinzu. Das Gem wird mit der Zeit besser, ohne dass Sie die Instruktionen umschreiben.

Es in der Gemini-App bauen

Die Mechanik geht schnell:

1. Gemini öffnen, in den Gems-Bereich gehen, New Gem wählen.

2. Namen und den Instruktionsblock von oben einfügen.

3. Style Guide und Dateien mit Beispielpaaren als Knowledge hochladen.

4. Das Live-Preview-Panel rechts zum Testen nutzen, bevor Sie speichern.

5. Speichern. Es liegt jetzt in Ihrer Seitenleiste.

Die offizielle Anleitung und die aktuellen UI-Details stehen in Googles Gems-Hilfedokumentation, ein Blick lohnt sich, weil sich das Layout mit der Produktentwicklung verschiebt.

Testen wie ein Engineer, nicht wie ein Fan

Testen Sie nicht mit dem Beispiel, das Sie schon in die Instruktionen geschrieben haben. Testen Sie mit Fällen, die es kaputt machen sollen:

• Ein schon sauberer Satz (lässt es ihn weitgehend in Ruhe?).
• Ein Satz mit drei verbotenen Wörtern (erwischt es alle drei?).
• Ein einzeiliges Fragment (stellt es eine Rückfrage oder halluziniert es Kontext?).
• Ein Absatz mit einer echten Zahl darin (bleibt die Zahl exakt erhalten?).

Schicken Sie das durch die Preview. Wenn es scheitert, korrigieren Sie die Instruktion oder ergänzen ein Beispielpaar, dann erneut testen. Diese Schleife, adversariales Testen und dann Nachpatchen, ist die eigentliche Arbeit beim Bauen eines guten Gems. Der UI-Teil dauert fünf Minuten, das Testen macht es vertrauenswürdig.

Wenn Sie wiederholbare, automatisierte Tests über viele Inputs wollen, ist das ein Signal, dass Sie der App entwachsen sind. Derselbe Instruktionstext wird über Google AI Studio zu einer system_instruction in der Gemini API, wo Sie ein Testset skripten kkDie durchschnittliche Zahl neuer Nutzer, die jeder bestehende Nutzer über Empfehlungen generiert. Über 1,0 verstärkt sich das Wachstum selbst und wird exponentiell.Vollständige Definition ansehen →önnen:

from google import genai

client = genai.Client()  # liest GEMINI_API_KEY aus der Umgebung

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")

Das ist dasselbe Gem-Verhalten, jetzt als Code, den Sie in der CI laufen lassen kkDie durchschnittliche Zahl neuer Nutzer, die jeder bestehende Nutzer über Empfehlungen generiert. Über 1,0 verstärkt sich das Wachstum selbst und wird exponentiell.Vollständige Definition ansehen →önnen. App-Gem und APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → teilen dieselbe Idee: eine System-Instruktion ist das Rückgrat von beidem.

Wann ein Gem besser ist als ein Einzelprompt (und wann nicht)

Das ist die Abwägung, die Leute, die Gems sammeln, von Leuten unterscheidet, die sie benutzen.

Ein Gem gewinnt, wenn:

• Das Verhalten sich wiederholt. Sie machen diese Aufgabe wöchentlich oder täglich. Die Wiederverwendung amortisiert den Aufwand beim Einrichten.
• Konsistenz über Personen hinweg zählt. Fünf Marketer sollten dieselbe Voice produzieren. Ein geteiltes, vom Admin veröffentlichtes Gem erzwingt das, fünf separat auswendig gelernte Prompts nicht.
• Die Instruktionen lang oder fummelig sind. Wenn Ihr Prompt verbotene Wörter, Edge Cases und Beispiele enthält, ist Neutippen fehleranfällig. Ein Gem friert die gute Version ein.
• Sie es neben Ihrer Arbeit haben wollen. Ein gespeichertes Gem ist ein Klick in der Seitenleiste.

Ein Einzelprompt gewinnt, wenn:

• Die Aufgabe wirklich einmalig ist. Ein Gem, das Sie einmal nutzen, ist nur ein langsamerer Prompt.
• Jeder Durchlauf andere Instruktionen braucht. Wenn die „Regeln" jedes Mal wechseln, gibt es kein stabiles Verhalten zum Speichern.
• Sie es in einem Dokument oder Postfach brauchen. Gems leben in der Gemini-App. Für „schreibe genau diesen Absatz hier um" ist Gemini in Google Workspace (das Seitenpanel in Docs und Gmail) die bessere Oberfläche. Es sieht das Dokument, in dem Sie gerade sind.

Dieser letzte Punkt ist die nützlichste Grenze. Ein Gem ist ein wiederverwendbarer *Assistent, zu dem Sie gehen*. Gemini in Workspace ist Hilfe, die *zu Ihnen kommt*, in der Datei. Der Brand Voice Rewriter als Gem ist großartig für das Massenumschreiben eines Stapels eingefügter Drafts. Fürs Feilen an einer einzelnen Zeile während des Schreibens ist das Docs-Seitenpanel schneller.

Wenn Sie Gems komplett entwachsen sind

Gems sind absichtlich einfach: Instruktionen plus Wissen, keine eigene Logik, keine externen Tools. Sie sind einem Gem entwachsen, wenn Sie eines davon brauchen:

• Programmatischen Zugriff. Andere Software ruft es auf. Wechseln Sie zur Gemini APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen →.
• Live-Daten oder Tool-Nutzung. Es muss mitten in der Aufgabe auf Ihre Datenbank oder einen internen Service zugreifen. Das ist ein Agent, gebaut mit dem Agent Development Kit (ADK) und deployt auf Vertex AI.
• Spreadsheet- oder Workspace-Automatisierung. Ein Gem kann nicht nach Zeitplan laufen oder ein Sheet transformieren. Apps Script mit der Gemini APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → kann das.
• Gegroundete, aktuelle Fakten. Ein Gem browst nicht für Sie. Für aktuelle Antworten nutzen Sie Gemini mit Grounding über Google Search, konfiguriert in der APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → oder in AI Studio.

Ein Gem ist genau auf einer Ebene das richtige Werkzeug: ein festes Verhalten, das Sie von Hand auslösen. Sobald es *selbst handeln* oder *von Code aufgerufen werden* soll, sind Sie im Agent- und APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen →-Territorium, das der Rest dieses Pfads abdeckt.

Wichtigste Erkenntnisse

• Bauen Sie ein Gem, wenn das Verhalten sich wiederholt und Konsistenz zählt, besonders über ein Team hinweg. Für wirklich einmalige Aufgaben ist ein scharfer Prompt schneller.
• Kodieren Sie Marke oder Verhalten als Regeln plus Beispiele, nicht als Adjektive. „Mach es on-brand" scheitert, eine Liste verbotener Wörter und Vorher/Nachher-Paare funktionieren.
• Nehmen Sie immer Instruktionen für Edge Cases auf (Text, der schon on-voice ist, Fragmente, Zahlen erhalten). Das macht ein Gem für andere verlässlich, nicht nur für Sie.
• Testen Sie adversarial, bevor Sie ihm vertrauen: sauberer Input, Input mit verbotenen Wörtern, Fragmente, echte Zahlen. Instruktionen oder Beispielsammlung nachpatchen, dann erneut testen.
• Kennen Sie den Upgrade-Pfad: für Hilfe im Dokument Gemini in Workspace, für Code die Gemini APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen →, und für Tools oder Live-Daten ADK auf Vertex AI.