Skills erstellen und verwalten

Skills sind wiederverwendbare benutzerdefinierte Anweisungen, mit denen der Gemini Enterprise-Assistent bestimmte Aufgaben ausführen kann, z. B. rechtliche Verträge prüfen oder im Stil Ihrer Marke schreiben.

Jeder Skill ist ein Paket, das eine SKILL.md-Prompt-Datei enthält. Ein Skill-Paket kann auch Skripts, Dateien oder Hintergrundkontext enthalten, die der Assistent zum Ausführen einer Aufgabe verwendet. Gemini Enterprise aktiviert standardmäßig die von Ihnen erstellten Skills.

Unterstützte Versionen

Die Möglichkeit, Skills zu erstellen, hochzuladen oder zu verwenden, hängt von der Gemini Enterprise-Version ab, die Sie abonniert haben:

  • Standard, Plus und „Pay as you go“: Sie können benutzerdefinierte Skills erstellen und hochladen sowie von Google verwaltete Skills und von Nutzern erstellte Skills verwenden, die für Sie freigegeben wurden.
  • Frontline: Sie können von Google verwaltete Skills und von Nutzern erstellte Skills, die für Sie freigegeben wurden, suchen, installieren und verwenden. Sie können keine benutzerdefinierten Skills erstellen oder hochladen.

Übersicht

Wichtige Aspekte von Skills:

  • Offener Standard: Jeder Skill basiert auf dem offenen Skills-Standard und wird durch eine zentrale SKILL.md-Datei definiert. Er kann mit zusätzlichen Dateien oder Skripts erweitert werden.
  • Modulare Erweiterung: Mit Skills können Sie einem Agenten domänenspezifische Aufgaben mithilfe von benutzerdefinierten Anweisungen und Kontext beibringen.
  • Dynamischer Zugriff: Gemini Enterprise greift automatisch auf diese spezialisierten Anweisungen zu, wenn sie für Ihre Frage oder Aufgabe relevant sind.

Skill erstellen

So erstellen Sie einen neuen Skill in der Gemini Enterprise-Web-App:

  1. Melden Sie sich in der Gemini Enterprise-Web-App an.
  2. Klicken Sie im Navigationsmenü auf Skills.
  3. Klicken Sie auf das Symbol Hinzufügen und dann auf Skill mit Gemini erstellen.
  4. Gib einen Namen für den Skill ein.
  5. Geben Sie eine Beschreibung ein. Gemini Enterprise verwendet die Beschreibung, um festzustellen, ob der Skill bei einem Prompt oder einer Aufgabe helfen kann. Sie können der Beschreibung auch Triggeranweisungen hinzufügen, um Gemini Enterprise zu unterstützen.
  6. Geben Sie die Skill-Anweisungen in natürlicher Sprache im Chatfeld oder im Feld Anweisungen ein. Informationen zum Erstellen eines Skills mit einer vorhandenen SKILL.md-Datei mit benutzerdefiniertem Markdown- oder YAML-Frontmatter finden Sie unter Skill hochladen.
  7. Klicken Sie auf Speichern. Gemini Enterprise aktiviert die neue Fähigkeit standardmäßig.

Skill hochladen

Wenn Sie vorhandene Skills hinzufügen möchten, laden Sie sie als Markdown- oder ZIP-Dateien hoch. Gemini Enterprise extrahiert den Skill-Namen und die Beschreibung automatisch aus der SKILL.md-Datei.

Dateiformat und Verzeichnisstruktur für Skills

Ein Skill-Paket besteht aus einer erforderlichen SKILL.md-Prompt-Datei und optionalen Unterverzeichnissen für Scripts, Referenzdokumentation und Assets. Sie können entweder eine eigenständige SKILL.md-Datei oder ein ZIP-Archiv mit der folgenden Verzeichnisstruktur hochladen:

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
Datei oder Verzeichnis Erforderlich Beschreibung
SKILL.md Ja Enthält die YAML-Frontmatter-Metadaten der Fähigkeit (z. B. name und description), gefolgt von Markdown-Anweisungen, die den Gemini Enterprise-Assistenten anleiten.
scripts/ Nein Ausführbare Python- oder Bash-Hilfsskripts für deterministische oder wiederholte Vorgänge.
references/ Nein Ergänzender Kontext, der bei Bedarf geladen wird, z. B. Schemas, Spickzettel oder API-Referenzdokumentation.
assets/ Nein In der Ausgabe verwendete Dateien (z. B. Vorlagen oder Bilder), die nicht direkt in den Prompt-Kontext von Gemini Enterprise geladen werden.

Anforderungen an YAML-Frontmatter

Die SKILL.md-Datei muss mit einem gültigen YAML-Frontmatter-Block beginnen, der zwischen ----Trennzeichen am Anfang der Datei eingeschlossen ist, gefolgt vom Markdown-Anweisungstext (harte Grenze von 500.000 Zeichen; Uploads, die diese Grenze überschreiten, schlagen fehl).

Der YAML-Frontmatter unterstützt die folgenden Felder:

Feld Erforderlich Format und Einschränkungen
name Ja Eine eindeutige Kennung für die Fähigkeit (1 bis 64 Zeichen). Darf nur Kleinbuchstaben (a-z), Ziffern (0-9) und Bindestriche (-) enthalten. Darf nicht mit einem Bindestrich (-) beginnen oder enden und keine aufeinanderfolgenden Bindestriche (--) enthalten. Wenn der Wert in einem Ordner hochgeladen wird, muss der Wert name mit dem Namen des übergeordneten Ordners übereinstimmen.
description Ja Eine Funktionsbeschreibung (1 bis 1.024 Zeichen), in der erklärt wird, was der Skill tut und wann Gemini Enterprise ihn aufrufen soll. Fügen Sie Trigger-Keywords hinzu, damit Gemini Enterprise erkennen kann, wann der Skill relevant ist. Dies ist ein festes Limit. Wenn die Beschreibung 1.024 Zeichen überschreitet, schlägt der Skill-Upload mit dem folgenden Fehler fehl: A field in your SKILL.md is too long. Shorten the name, description or the instructions.
license Nein Die Software- oder Inhaltsverteilungslizenz, die für das Skill-Paket gilt (bis zu 1.024 Zeichen), z. B. eine Open-Source-SPDX-Lizenzkennung (z. B. Apache-2.0 oder MIT) oder Proprietary. In diesem Feld werden die Nutzungsbedingungen für die Skill-Datei selbst angegeben, nicht für eine Gemini Enterprise-Nutzer- oder App-Abolizenz. Wenn angegeben, darf der Wert nicht leer sein.
metadata Nein Eine optionale Schlüssel/Wert-Zuordnung von benutzerdefinierten Tags, Autoren oder Versionsparametern. Schlüssel müssen skalare Strings sein und Werte müssen skalare Strings oder Listen von skalaren Strings sein.

SKILL.md-Beispieldatei

Das folgende Beispiel zeigt eine gültige SKILL.md-Datei:

---
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.

Einschränkungen für ZIP-Archive

Wenn Sie einen Skill als ZIP-Archiv hochladen, muss das Archiv die folgenden Validierungsanforderungen erfüllen:

  • Einzelne SKILL.md-Datei: Jedes ZIP-Archiv muss genau eine SKILL.md-Datei enthalten, die sich entweder im Stammverzeichnis des Archivs (SKILL.md) oder in einem einzelnen Wrapper-Ordner auf oberster Ebene (bis zu 3 Ebenen tief, z. B. my-skill/SKILL.md) befindet.
  • Archivgröße: Die maximale Größe des komprimierten ZIP-Archivs beträgt 100 MB und die maximale unkomprimierte Gesamtgröße 100 MB.
  • Anzahl der Dateien:maximal 100 Dateien pro ZIP-Archiv.
  • Verzeichnistiefe: Maximale Verzeichnistiefe von 10 Ebenen relativ zum Stammverzeichnis des Skills.
  • Pfadintegrität: Doppelte Dateipfade und Verweise auf übergeordnete Verzeichnisse (..) sind nicht zulässig.

Skill in die Webanwendung hochladen

So laden Sie eine Fähigkeit hoch:

  1. Melden Sie sich in der Gemini Enterprise-Web-App an.
  2. Klicken Sie im Navigationsmenü auf Skills.
  3. Klicken Sie auf das Symbol Hinzufügen und dann auf Skill hochladen.
  4. Ziehen Sie die Markdown- oder ZIP-Datei in das Feld oder suchen Sie danach und klicken Sie auf Importieren. Gemini Enterprise aktiviert die Fähigkeit standardmäßig.

Skills ansehen

Sie können Skills durchsuchen und installieren, indem Sie die Liste anhand der folgenden Abschnitte filtern:

Bereich Beschreibung
Alle Sowohl von Google verwaltete als auch von Nutzern erstellte Skills.
Google Integrierte Skills von Google.
Für mich freigegeben Schreibgeschützte, von Nutzern erstellte Skills, die andere Nutzer für Sie freigegeben haben.

So suchst du nach einem Skill und installierst ihn:

  1. Melden Sie sich in der Gemini Enterprise-Web-App an.
  2. Klicken Sie im Navigationsmenü auf Skills.
  3. Klicken Sie auf das Symbol Hinzufügen und dann auf Skills ansehen.
  4. Suchen Sie nach dem Skill, den Sie verwenden möchten, und klicken Sie auf + Installieren.

Skill aktualisieren

So aktualisieren Sie eine vorhandene Fähigkeit:

  1. Melden Sie sich in der Gemini Enterprise-Web-App an.
  2. Klicken Sie im Navigationsmenü auf Skills.
  3. Klicken Sie auf den Namen der Fähigkeit, die Sie aktualisieren möchten.
  4. Klicken Sie auf das Symbol neben der Fähigkeit und dann auf Bearbeiten.
  5. Nehmen Sie die erforderlichen Änderungen an der Anleitung, am Namen oder an der Beschreibung vor.
  6. Klicken Sie auf Speichern.

Klicken Sie auf Skills, um zur Seite „Skills“ zurückzukehren.

Skill teilen

Wenn Ihr Gemini Enterprise-Administrator die Freigabe von Skills aktiviert, können Sie von Ihnen erstellte Skills für andere Nutzer freigeben.

So teilen Sie einen Skill:

  1. Melden Sie sich in der Gemini Enterprise-Web-App an.
  2. Klicken Sie im Navigationsmenü auf Skills.
  3. Suchen Sie den Skill, den Sie erstellt haben und teilen möchten.
  4. Klicken Sie neben dem Skill auf das Symbol  und dann auf Teilen.
  5. Geben Sie im Dialogfeld Share skill (Skill freigeben) die kommagetrennten E‑Mail-Adressen der Nutzer ein, für die Sie den Skill freigeben möchten.
  6. Klicken Sie auf Fertig.

Skill verwenden

Sie können Skills direkt in Ihren Chat-Unterhaltungen in der Gemini Enterprise Web-App verwenden.

Skill auf der Seite „Skills“ testen

Sie können einen Skill direkt auf der Seite Skills testen, indem Sie eine neue Chatsitzung mit diesem Skill starten:

  1. Melden Sie sich in der Gemini Enterprise-Web-App an.
  2. Klicken Sie im Navigationsmenü auf Skills.
  3. Klicken Sie auf das Symbol  neben dem Skill und dann auf Neuer Chat. Gemini Enterprise öffnet einen neuen Chat, der sich auf die ausgewählte Fähigkeit bezieht.

Skill in einer Unterhaltung aufrufen

Sie können Skills während einer Unterhaltung dynamisch aufrufen, um die Antworten des Assistenten anzupassen.

Wenn Sie mit dem Gemini Enterprise-Assistenten chatten, können Sie Skills auf folgende Weise verwenden:

  • Manuelle Erwähnungen: Sie können einen Skill explizit über die Erwähnungsfunktion @ oder / im Chatfeld aufrufen (z. B. @Brand Voice oder /Brand Voice). Wenn Sie / eingeben, wird ein Menü geöffnet, in dem nur Ihre verfügbaren Skills angezeigt werden. Wenn Sie @ eingeben, wird das allgemeine Erwähnungsmenü geöffnet.
  • Direkte Anfragen: Wenn Gemini Enterprise einen bestimmten Skill verwenden soll, können Sie dies direkt in Ihrem Prompt angeben. Beispiel: Use the brand voice skill to review this
  • Automatische Auswahl:Gemini Enterprise verwendet automatisch einen Skill, wenn er für Ihre Aufgabe relevant ist. Dies wird anhand der Beschreibung und der Triggeranweisungen des Skills ermittelt.

Skill deaktivieren

Wenn Sie verhindern möchten, dass Gemini Enterprise einen bestimmten Skill verwendet, deaktivieren Sie ihn. Wenn Sie einen Skill deaktivieren, wird er von Gemini Enterprise in Unterhaltungen nicht aufgerufen.

So deaktivieren Sie einen Skill:

  1. Melden Sie sich in der Gemini Enterprise-Web-App an.
  2. Klicken Sie im Navigationsmenü auf Skills.
  3. Suchen Sie auf der Seite Skills den Skill, den Sie deaktivieren möchten.
  4. Klicken Sie auf den Ein/Aus-Button neben der Fähigkeit, um sie zu deaktivieren.

Skill deinstallieren

So entfernen Sie einen installierten Skill von der Seite Skills:

  1. Melden Sie sich in der Gemini Enterprise-Web-App an.
  2. Klicken Sie im Navigationsmenü auf Skills.
  3. Klicken Sie auf das Symbol  neben dem Skill und dann auf Deinstallieren.

Skill-Status

Zusätzlich zum Aktivieren oder Deaktivieren von Skills können Administratoren den Status eines Skills ändern, was sich auf seine Verfügbarkeit auswirkt:

  • Gesperrt:Ihr Administrator hat die Qualifikation vorübergehend deaktiviert. Er bleibt auf der Seite Skills mit dem Status „Gesperrt“ sichtbar, kann aber von anderen Nutzern erst dann in Unterhaltungen aufgerufen werden, wenn der Administrator ihn wieder aktiviert. Skill-Inhaber können den Skill aktualisieren und testen.
  • Deaktiviert: Ihr Administrator blendet den Skill vorübergehend für andere Nutzer aus und entfernt ihn von deren Seite Skills. Der Skill bleibt für den Skill-Inhaber sichtbar, der ihn aktualisieren und testen kann, bis der Administrator ihn wieder aktiviert.
  • Gelöscht: Ihr Administrator entfernt die Fähigkeit dauerhaft aus der Gemini Enterprise-Web-App, sodass Sie sie nicht mehr verwenden können.

Beschränkungen

In diesem Abschnitt werden die Einschränkungen für Skills in Gemini Enterprise aufgeführt:

  • Skills können nicht mit KI-Agenten verwendet werden.
  • Fähigkeiten unterstützen nur die Ausführung von Python und Bash.
  • Im Editor der Webanwendung können Sie Skills erstellen, indem Sie Anweisungen in die Formularfelder eingeben oder mit dem Assistenten chatten, der automatisch eine einzelne SKILL.md-Datei generiert. Komplexere Skills, die zusätzliche Skripts oder Dateien erfordern, müssen als ZIP-Datei hochgeladen werden.
  • Beim Erstellen von Skills in natürlicher Sprache werden Ihr Konversationskontext oder Ihre Connectors nicht als Eingaben verwendet.
  • Skills funktionieren am besten mit Canvas, wenn ein Skill nur eine SKILL.md-Datei hat.
  • Für eine SKILL.md-Datei gelten strenge Längenbeschränkungen: 64 Zeichen für name, 1.024 Zeichen für description und 500.000 Zeichen für den Text der Markdown-Anweisungen. Hochgeladene ZIP-Archive dürfen nicht größer als 100 MB (komprimiert oder unkomprimiert) sein und nicht mehr als 100 Dateien oder 10 Ebenen von Verzeichnisschachtelungen enthalten.

Nächste Schritte