Die Skill Registry dient als sicheres, privates Repository mit geringer Latenz zur Verwaltung von Agent-Skills. Jeder Skill ist ein in sich geschlossenes Paket mit strukturellen Anweisungen, ausführbarem Code und Dokumentation, das die Fähigkeiten eines Agenten erweitert.
Durch die Zentralisierung dieser Skills können Agenten mit der Skill Registry die relevantesten Fähigkeiten basierend auf der Nutzerabsicht dynamisch ermitteln und laden. So werden die Leistung optimiert und eine sichere Ausführungsumgebung gewährleistet.
Wichtige Konzepte
Die Skill Registry führt zwei Standard-API-Entitäten der obersten Ebene zur Verwaltung von Lebenszyklus und Versionsverwaltung ein:
| Konzept | Beschreibung |
|---|---|
| Skill |
Eine veränderliche Entität der obersten Ebene, die Metadaten (z. B. Anzeigename,
Zeitstempel für Erstellung und Aktualisierung sowie Labels), die Standardversion 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. Er enthält einen Namen, eine Beschreibung und einen unveränderlichen Verweis auf die übergeordnete Skill-Ressource. |
Skill-Nutzlastvalidierung
Damit Agenten gültige Skill-Inhalte verwenden können, werden alle Skill-Nutzlasten während der Erstellung oder Aktualisierung automatisch vom System überprüft. Diese Validierungen werden asynchron ausgeführt.
Der asynchrone Vorgang schlägt mit einem Validierungsfehler fehl, wenn das System eines der folgenden Probleme feststellt:
- 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, mit einem Komprimierungsverhältnis von über 100.
- Die Ordner in der ZIP-Datei haben mehr als 8 Ebenen.
- Die ZIP-Datei enthält keine
SKILL.md-Datei. - Die
SKILL.md-Datei weist die folgenden Probleme auf:- In der
SKILL.md-Datei fehlt die erforderliche YAML-Frontmatter oder der erwartete Markdown-Inhalt. - Das Feld „Name“ in der 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 „Beschreibung“ in der YAML-Frontmatter fehlt oder ist länger als 1.024 Zeichen.
- Das Feld „Lizenz“ in der YAML-Frontmatter ist länger als 1.024 Zeichen.
- Die Anleitung in der
SKILL.md-Datei ist länger als 500.000 Zeichen.
- In der
- Das ZIP-Archiv ist größer als 10 MB.
Integrierte Skills
Die Skill Registry enthält einen integrierten gcp-skill-registry-Skill. Mit diesem Skill können Agenten 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 sofort einsatzbereite Funktionen.
Nächste Schritte
Skills erstellen und verwalten
Informationen zum Erstellen, Aktualisieren, Suchen und Löschen von Skills in der Skill Registry.