Skills verwalten

Mit der Agent Registry können Sie eigenständige Skills prüfen, aktualisieren und verwalten. So können Sie steuern, welche Skill-Versionen und Lebenszyklusstatus für Ihre KI-Agenten verfügbar sind. Nachdem Sie einen eigenständigen Skill registriert haben, können Sie die Details aufrufen, die Beschreibung oder Standardversion aktualisieren, den Lebenszyklusstatus ändern oder den Skill aus der Agent Registry löschen. Sie können auch von Google verwaltete Skills auflisten und ansehen, die verfügbar sind, sobald Sie die Agent Registry eingerichtet haben.

Hinweis

  1. Agent Registry einrichten

  2. Rufen Sie die Projekt-ID für das Governance-Projekt ab, in dem die Agent Registry aktiviert ist.

  3. Eigenständigen Skill registrieren

  4. Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, richten Sie Ihre gcloud CLI-Umgebung ein.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Governance-Projekt zuzuweisen, in dem Agent Registry aktiviert ist, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Skills in Agent Registry benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Andere Agent Registry-Rollen können auch die Berechtigungen enthalten, die zum Aufrufen, Aktualisieren und Löschen von Skills erforderlich sind. Weitere Informationen finden Sie unter Agent Registry-Rollen und -Berechtigungen.

Skills auflisten und ansehen

Sie können alle registrierten Skills durchsuchen oder nach bestimmten Funktionen suchen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:

    Zur Agent Registry

  2. Wählen Sie den Tab Skills aus.
  3. Sehen Sie sich die Liste der Fähigkeiten an. Sie können die Anzeige über die Menüs Standort oder Status filtern.
  4. Klicken Sie auf einen Skill-Namen, um die Seite Skill-Details zu öffnen. Dort werden der Name, die Beschreibung, die aktive Version, die Skill-ID, das Datum der letzten Aktualisierung, benutzerdefinierte Metadaten und der Überarbeitungsverlauf angezeigt.

gcloud

Verwenden Sie den Befehl gcloud alpha agent-registry skills list, um alle Skills an einem Standort aufzulisten:

gcloud alpha agent-registry skills list \
    --project=PROJECT_ID \
    --location=LOCATION

Wenn Sie Details zu einer bestimmten Fähigkeit aufrufen möchten, verwenden Sie den Befehl gcloud alpha agent-registry skills describe:

gcloud alpha agent-registry skills describe SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

Ersetzen Sie Folgendes:

  • SKILL_ID: die ID der Fähigkeit, die Sie überprüfen möchten. Fügen Sie bei manuell registrierten Skills das Präfix private- hinzu, z. B. private-my-skill.
  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.

REST

Senden Sie eine GET-Anfrage, um die Liste aller Skills abzurufen:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills"

Senden Sie eine GET-Anfrage, um einen einzelnen Skill-Container abzurufen:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.
  • SKILL_ID: die ID der Fähigkeit, die Sie überprüfen möchten. Fügen Sie bei manuell registrierten Skills das Präfix private- hinzu, z. B. private-my-skill.

Skill-Metadaten oder Standardversion aktualisieren

Sie können den Anzeigenamen oder die Beschreibung eines Skills ändern oder den Standard-Versionszeiger manuell ändern, um eine andere Version bereitzustellen. Informationen zum Erstellen neuer Skill-Versionen finden Sie unter Skill-Versionen verwalten.

So aktualisieren Sie Skill-Metadaten oder die Standardversion eines bestimmten Skills:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:

    Zur Agent Registry

  2. Wählen Sie den Tab Skills aus.
  3. Sehen Sie sich die Liste der Fähigkeiten an. Sie können die Anzeige über die Menüs Standort oder Status filtern.
  4. Klicken Sie auf einen Skill-Namen, um die Seite Skill-Details zu öffnen. Dort werden der Name, die Beschreibung, die aktive Version, die Skill-ID, das Datum der letzten Aktualisierung, benutzerdefinierte Metadaten und der Überarbeitungsverlauf angezeigt.

  5. Wählen Sie eine der folgenden Optionen aus:

    • Skill-Metadaten aktualisieren:

      1. Klicken Sie auf  Bearbeiten.
      2. Aktualisieren Sie im Bereich Skill bearbeiten den Anzeigenamen oder die Beschreibung Ihres Skills.
      3. Klicken Sie auf Speichern.

    • Standardversion aktualisieren:

      1. Suchen Sie die Tabelle Versionsverlauf.
      2. Suchen Sie die Version, die Sie aktivieren möchten.
      3. Klicken Sie in der Spalte Aktionen auf Version aktivieren.

gcloud

  • Verwenden Sie den Befehl gcloud alpha agent-registry skills update, um die Metadaten eines Skills zu aktualisieren:

    gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

  • Verwenden Sie den Befehl gcloud alpha agent-registry skills update, um die Standard-Bereitstellungsversion eines Skills zu aktualisieren, und geben Sie den Ressourcennamen der Zielversion an:

    gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --default-revision="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

Ersetzen Sie Folgendes:

  • SKILL_ID: die ID des Skills, den Sie aktualisieren möchten. Fügen Sie bei manuell registrierten Skills das Präfix private- hinzu, z. B. private-my-skill.
  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.
  • DISPLAY_NAME: der aktualisierte Anzeigename.
  • DESCRIPTION: die aktualisierte Beschreibung.
  • REVISION_ID: die ID der Skill-Version, die Sie als Standard festlegen möchten.

REST

Senden Sie eine PATCH-Anfrage und geben Sie die Felder an, die Sie aktualisieren möchten:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "displayName": "DISPLAY_NAME",
        "description": "DESCRIPTION",
        "defaultRevision": "projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=displayName,description,defaultRevision"

Ersetzen Sie Folgendes:

  • DISPLAY_NAME: der aktualisierte Anzeigename des Skills.
  • DESCRIPTION: die aktualisierte Beschreibung der Fähigkeit.
  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.
  • SKILL_ID: die ID des Skills, den Sie aktualisieren möchten. Fügen Sie bei manuell registrierten Skills das Präfix private- hinzu, z. B. private-my-skill.
  • REVISION_ID: die ID der Skill-Version, die Sie aktivieren möchten.

Lebenszyklusstatus von Skills verwalten

Wenn Sie steuern möchten, wie ein Skill zur Laufzeit aufgelöst wird, können Sie den Zielstatus des Skills ändern:

  • Aktiv: Der Skill wird bereitgestellt und ist vollständig auflösbar. Wenn Sie einen Skill auf Aktiv setzen, muss das Feld defaultRevision auf eine aktive Skill-Version verweisen.
  • Deaktiviert: Der Standard-Anfangszustand, wenn ein Skill erstellt wird. Der Skill wird nicht zur Laufzeit bereitgestellt, die Auflösung des Skills schlägt sofort fehl und Payload-Downloads werden blockiert. Ein Skill wird auch in den Status Deaktiviert versetzt, wenn der defaultRevision-Pointer gelöscht oder die Standardversion gelöscht wird. Im Gegensatz zum Status Außer Betrieb genommen können Sie eine deaktivierte Fähigkeit aktivieren, indem Sie einen gültigen defaultRevision festlegen und den Zielstatus auf Aktiv aktualisieren.
  • Veraltet: Der Skill kann weiterhin geladen und heruntergeladen werden, es wird jedoch darauf hingewiesen, dass er eingestellt wird.
  • Außer Betrieb genommen: Der Skill ist dauerhaft deaktiviert, wird nicht mehr bereitgestellt und kann nicht auf Aktiv oder einen anderen Status zurückgesetzt werden. Ein Skill kann erst außer Betrieb genommen werden, nachdem er bereits eingestellt wurde. Planen Sie ausreichend Zeit für die Migration ein, bevor Sie den Skill außer Betrieb nehmen. Da dieser Status endgültig ist, sollten Sie ihn mit Vorsicht verwenden.

So ändern Sie den Lebenszyklusstatus einer Fähigkeit:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:

    Zur Agent Registry

  2. Wählen Sie den Tab Skills aus.
  3. Sehen Sie sich die Liste der Fähigkeiten an. Sie können die Anzeige über die Menüs Standort oder Status filtern.
  4. Klicken Sie auf einen Skill-Namen, um die Seite Skill-Details zu öffnen. Dort werden der Name, die Beschreibung, die aktive Version, die Skill-ID, das Datum der letzten Aktualisierung, benutzerdefinierte Metadaten und der Überarbeitungsverlauf angezeigt.
  5. Verwenden Sie die Schaltflächen zur Statussteuerung, um den Zielstatus zu ändern. Die auf der Seite angezeigten Schaltflächen hängen vom aktuellen Status des Skills ab, z. B. Aktivieren, Deaktivieren, Einstellung oder Außerbetriebnahme.

gcloud

Aktualisieren Sie den Skill-Container mit dem Befehl gcloud alpha agent-registry skills update und dem Flag --target-state:

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --target-state=DISABLED

Ersetzen Sie Folgendes:

  • SKILL_ID: die ID des Skills, den Sie aktualisieren möchten. Fügen Sie bei manuell registrierten Skills das Präfix private- hinzu, z. B. private-my-skill.
  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.

Zulässige Werte für den Zielstatus sind:

  • ACTIVE
  • DISABLED
  • DEPRECATED
  • DECOMMISSIONED

REST

Senden Sie eine PATCH-Anfrage und geben Sie dabei die targetState im Text und in der Updatemaske an:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "targetState": "TARGET_STATE_DISABLED"
    }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=targetState"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.
  • SKILL_ID: die ID des Skills, den Sie aktualisieren möchten. Fügen Sie bei manuell registrierten Skills das Präfix private- hinzu, z. B. private-my-skill.

Zulässige Werte für den Zielstatus sind:

  • TARGET_STATE_ACTIVE
  • TARGET_STATE_DISABLED
  • TARGET_STATE_DEPRECATED
  • TARGET_STATE_DECOMMISSIONED

Skill löschen

Wenn Sie einen Skill-Container löschen, werden die Ressource Skill und alle zugehörigen unveränderlichen SkillRevision-Ressourcen endgültig gelöscht. Agenten, die versuchen, die gelöschte Skill-ID aufzulösen, schlagen zur Laufzeit fehl.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:

    Zur Agent Registry

  2. Wählen Sie den Tab Skills aus.
  3. Sehen Sie sich die Liste der Fähigkeiten an. Sie können die Anzeige über die Menüs Standort oder Status filtern.
  4. Klicken Sie auf den Namen des Skills, den Sie löschen möchten.
  5. Klicken Sie auf der Seite Skill-Details auf Löschen.
  6. Geben Sie im Bestätigungsdialogfeld DELETE ein und klicken Sie auf Löschen.

gcloud

Verwenden Sie zum Löschen eines Skills den Befehl gcloud alpha agent-registry skills delete:

gcloud alpha agent-registry skills delete SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

Ersetzen Sie Folgendes:

  • SKILL_ID: die ID des Skills, den Sie löschen möchten. Fügen Sie bei manuell registrierten Skills das Präfix private- hinzu, z. B. private-my-skill.
  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.

REST

Senden Sie eine DELETE-Anfrage, um eine Fähigkeit zu löschen:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?force=true"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.
  • SKILL_ID: die ID des Skills, den Sie löschen möchten. Fügen Sie bei manuell registrierten Skills das Präfix private- hinzu, z. B. private-my-skill.

Nächste Schritte