Übersicht über die Skill Registry

Die Skill Registry dient als sicheres, privates Repository mit geringer Latenz für die Verwaltung von Agent-Skills. Jeder 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 dynamisch die relevantesten Funktionen basierend auf der Nutzerabsicht erkennen und laden können. So werden Leistung und eine sichere Ausführungsumgebung optimiert.

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 Top-Level-Entität, die Metadaten (z. B. Anzeigename, Erstellungs- und Aktualisierungszeitstempel und Labels), die Standardrevision und die Inhalte des Skills enthält.

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

Validierung der Skill-Nutzlast

Damit Agents gültige Skill-Inhalte verwenden können, werden alle Skill-Nutzlasten bei der Erstellung oder bei Updates automatisch vom System überprüft. 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 mehrere Dateien oder Ordner mit demselben Namen.
  • Die Gesamtgröße aller Dateien in der ZIP-Datei beträgt nach dem Entzippen 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 Feld „description“ im YAML-Frontmatter fehlt oder überschreitet 1.024 Zeichen.
    • Das Lizenzfeld 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-Registrierung umfasst einen integrierten gcp-skill-registry-Skill. Mit dieser Fähigkeit 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 entdecken. 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.