Übersicht über die Skill Registry

Die Skill Registry dient als sicheres, privates Repository mit geringer Latenz zum Verwalten von KI-Agenten-Skills. Jede Skill ist ein in sich geschlossenes Paket, das strukturelle Anweisungen, ausführbaren Code und Dokumentation enthält und dazu dient, die Fähigkeiten eines Agenten zu erweitern.

Durch die Zentralisierung dieser Skills ermöglicht die Skill-Registrierung, dass Agents die relevantesten Funktionen basierend auf der Nutzerabsicht dynamisch erkennen und laden können. So wird die Leistung optimiert und eine sichere Ausführungsumgebung gewährleistet.

Wichtige Konzepte

In der Skill Registry werden zwei Standard-API-Entitäten der obersten Ebene eingeführt, um den Lebenszyklus und die Versionsverwaltung zu verwalten:

Konzept Beschreibung
Skill Eine veränderliche Entität auf oberster Ebene, die Metadaten (z. B. Anzeigename, Zeitstempel für Erstellung und Aktualisierung sowie Labels), die Standardrevision und den Inhalt des Skills enthält.

Beispiele für die erwartete Skill-Struktur finden Sie in den SKILL.md-Dateien im Google Cloud Skills-Repository.
Skill-Version Ein unveränderlicher Snapshot einer bestimmten Skill-Version. Sie enthält einen Namen, eine Beschreibung und einen unveränderlichen Verweis auf die übergeordnete Skill-Ressource.

Validierung der Skill-Nutzlast

Damit Agents gültige Skill-Inhalte verwenden können, überprüft das System automatisch alle Skill-Payloads bei der Erstellung oder bei Updates. Diese Validierungen werden asynchron durchgeführt.

Der asynchrone Vorgang schlägt mit einem Validierungsfehler fehl, wenn das System einen der folgenden Punkte erkennt:

  • Die Datei ist keine gültige ZIP-Datei oder es fehlen wichtige Informationen.
  • Die ZIP-Datei ist leer.
  • Die ZIP-Datei enthält mehr als 10.000 Elemente.
  • Die Datei- oder Ordnernamen in der ZIP-Datei enthalten .. oder beginnen mit / oder \\.
  • Die ZIP-Datei enthält symbolische Links.
  • Die ZIP-Datei enthält doppelte Datei- oder Ordnernamen.
  • Die Gesamtgröße aller Dateien in der ZIP-Datei beträgt nach dem Entpacken mehr als 500 MB.
  • Die Datei ist zu stark komprimiert. Das Komprimierungsverhältnis liegt über 100.
  • Die Ordner in der ZIP-Datei sind mehr als 8 Ebenen tief verschachtelt.
  • Die ZIP-Datei enthält keine SKILL.md-Datei.
  • Die Datei SKILL.md weist die folgenden Probleme auf:
    • In der Datei SKILL.md fehlt das erforderliche YAML-Frontmatter oder der erwartete Markdown-Inhalt.
    • Das Feld „name“ im YAML-Frontmatter fehlt, ist länger als 64 Zeichen, beginnt oder endet mit einem Bindestrich oder enthält andere Zeichen als Kleinbuchstaben, Ziffern und Bindestriche.
    • Das Beschreibungsfeld im YAML-Frontmatter fehlt oder ist länger als 1.024 Zeichen.
    • Das Feld „license“ im YAML-Frontmatter enthält mehr als 1.024 Zeichen.
    • Die Anleitung in der Datei SKILL.md überschreitet 500.000 Zeichen.
  • Das gezippte Archiv ist größer als 10 MB.

Integrierte Skills

Die Skill-Registry enthält einen integrierten gcp-skill-registry-Skill. Mit dieser Funktion können Agents mit der Skill Registry interagieren, um verfügbare Skills zu erstellen, zu suchen und zu verwalten. So können sie neue Funktionen registrieren oder vorhandene Funktionen ermitteln. Google verwaltet den Lebenszyklus, die Veröffentlichung und die Versionsverwaltung dieses integrierten Skills und sorgt so für eine sofort einsatzbereite Funktionalität.

Nächste Schritte

Leitfaden

Hier erfahren Sie, wie Sie Skills in der Skill Registry erstellen, aktualisieren, suchen und löschen.