Agent-Skills für die Gemini CLI erstellen

1. Einführung

In diesem Lab erfahren Sie, wie Sie Agent Skills erstellen, um LLMs Zugriff auf benutzerdefiniertes Wissen und benutzerdefinierte Workflows zu ermöglichen. Sie erstellen es als lokales Skill, auf das über die Gemini CLI zugegriffen werden kann.

Aufgaben

  • Eigene Agent-Skills für Ihre Lieblingsdinge erstellen
  • Gemini CLI zum Abfragen Ihres Skills verwenden
  • Installieren Sie offizielle Agent Skills für Firebase und verwenden Sie sie, um eine App zu erstellen und bereitzustellen.

Lerninhalte

  • So strukturieren Sie einen Skill.
  • So schreiben Sie eine SKILL.md-Datei.
  • Lokale Skills mit der Gemini CLI verwenden

2. Projekt einrichten

  1. Wenn Sie noch kein Google-Konto haben, müssen Sie ein Google-Konto erstellen.
    • Verwenden Sie ein privates Konto anstelle eines Arbeitskontos oder eines Kontos einer Bildungseinrichtung. Bei Arbeitskonten und Konten von Bildungseinrichtungen kann es Einschränkungen geben, die verhindern, dass Sie die für dieses Lab erforderlichen APIs aktivieren.
  2. Melden Sie sich in der Google Cloud Console an.
  3. Aktivieren Sie die Abrechnung in der Cloud Console.
    • Die Kosten für Cloud-Ressourcen für dieses Lab sollten weniger als 1 $betragen.
    • Sie können die Schritte am Ende dieses Labs ausführen, um Ressourcen zu löschen und so weitere Kosten zu vermeiden.
    • Neue Nutzer haben Anspruch auf die kostenlose Testversion mit einem Guthaben von 300$.
  4. Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes Projekt aus.
    • Wenn Sie eine Fehlermeldung zum Projektkontingent sehen, verwenden Sie ein vorhandenes Projekt wieder oder löschen Sie ein vorhandenes Projekt, um ein neues zu erstellen.

3. Cloud Shell-Editor öffnen

  1. Klicken Sie auf diesen Link, um direkt zum Cloud Shell-Editor zu gelangen.
  2. Wenn Sie heute an irgendeinem Punkt zur Autorisierung aufgefordert werden, klicken Sie auf Autorisieren, um fortzufahren. Klicken Sie, um Cloud Shell zu autorisieren.
  3. Wenn das Terminal nicht unten auf dem Bildschirm angezeigt wird, öffnen Sie es:
    • Klicken Sie auf Ansehen.
    • Klicken Sie auf TerminalNeues Terminal im Cloud Shell-Editor öffnen.
  4. Legen Sie im Terminal Ihr Projekt mit diesem Befehl fest:
    • Format:
      gcloud config set project [PROJECT_ID]
    • Beispiel:
      gcloud config set project lab-project-id-example
    • Wenn Sie sich nicht an Ihre Projekt-ID erinnern können:
      • Sie können alle Ihre Projekt-IDs mit folgendem Befehl auflisten:
        gcloud projects list | awk '/PROJECT_ID/{print $2}'
      Projekt-ID im Cloud Shell Editor-Terminal festlegen
  5. Es sollte folgende Meldung angezeigt werden:
    Updated property [core/project].
    Wenn Sie WARNING sehen und Do you want to continue (Y/n)? gefragt werden, haben Sie die Projekt-ID wahrscheinlich falsch eingegeben. Drücken Sie n, dann Enter und versuchen Sie, den Befehl gcloud config set project noch einmal auszuführen.

4. Skill „Lieblingsdinge“ erstellen

Agent-Skills sind Verzeichnisse, die mindestens eine SKILL.md-Datei mit Anweisungen und Wissen für einen KI-Agenten enthalten. In diesem Abschnitt erstellen Sie eine Skill, mit der Sie Gemini CLI Ihre Lieblingsdinge beibringen.

  1. Erstellen Sie ein Verzeichnis zum Speichern Ihres Skills:
    mkdir -p ~/.gemini/skills/my-favorite-things
  2. Erstellen und öffnen Sie eine neue SKILL.md-Datei für Ihren Skill:
    cloudshell edit ~/.gemini/skills/my-favorite-things/SKILL.md
    Mit dem Befehl cloudshell edit wird die Datei SKILL.md im Editor über dem Terminal geöffnet.
  3. Fügen Sie der Datei SKILL.md den folgenden Inhalt hinzu:
    ---
name: my-favorite-things
description: Information about my favorite things. Use this skill to answer questions about my favorite color, food, or programming language.
---

My favorite color is blue.
My favorite food is pizza.
My favorite programming language is Python.

If asked about one of my favorite things, please respond with the information provided above.

Mit nur einer SKILL.md-Datei haben Sie Ihren ersten Skill erstellt. Jetzt ist es an der Zeit, diese Fähigkeit in der Gemini CLI zu nutzen.

5. Skill in der Gemini CLI verwenden

Nachdem Sie einen Skill erstellt haben, können Sie ihn mit der Gemini CLI verwenden. Skills, die in ~/.gemini/skills platziert werden, werden automatisch von der Gemini CLI erkannt.

  1. Gemini CLI in Cloud Shell starten
    gemini
    Möglicherweise müssen Sie die Enter drücken, um einige Standardeinstellungen zu übernehmen.
  2. Gemini soll die in seinem Kontext verfügbaren Fähigkeiten auflisten
    /skills
    my-favorite-things sollte in der Liste der verfügbaren Skills angezeigt werden.
  3. Gemini nach Ihrer Lieblingsfarbe fragen:
    What is my favorite color?
    Die Gemini-CLI sollte den my-favorite-things-Skill verwenden, um Ihre Frage zu beantworten. Erlauben Sie der Gemini CLI, den Skill zu verwenden, wenn Sie dazu aufgefordert werden.

In der Ausgabe sollte zu sehen sein, dass die Gemini CLI Ihren Skill verwendet und mit „Blau“ geantwortet hat.

Sie haben es geschafft! Sie haben erfolgreich eine Skill erstellt und mit der Gemini CLI getestet.

Wenn Sie die Sitzung beenden möchten, geben Sie /quit ein und drücken Sie dann Enter, um die Gemini CLI zu schließen.

6. Agent Skills für Firebase installieren

Sie können nicht nur eigene Skills erstellen, sondern auch von anderen entwickelte Skills installieren. Agent Skills für Firebase (GitHub) sind übertragbare, in sich geschlossene Module mit Firebase-spezifischem Wissen, Anleitungen und Workflows. Sie sollen KI-Assistenten helfen, Firebase-Best Practices zu verstehen und komplexe Aufgaben mit höherer Genauigkeit und geringeren Token-Kosten auszuführen.

Sie können alle Agent Skills für Firebase mit der skills CLI in Ihrem Terminal installieren:

npx skills add firebase/agent-skills

Mit diesem Befehl werden Skills wie firebase-basics, firebase-auth-basics, firebase-firestore-basics und firebase-app-hosting-basics heruntergeladen und installiert, sodass sie in der Gemini CLI zusammen mit Ihrem my-favorite-things-Skill verwendet werden können.

Weitere Informationen zu Agent Skills für Firebase

7. Agent-Skills für Firebase

Die Agent Skills für Firebase sind jetzt installiert und können in der Gemini CLI verwendet werden. Sie können sie aufrufen, indem Sie die Gemini CLI ausführen und /skills firebase eingeben:

gemini

Gehen Sie dann in der Gemini CLI so vor:

/skills firebase

Es wird eine Liste der installierten Firebase-Skills angezeigt, z. B. firebase-basics, firebase-auth-basics, firebase-firestore-basics und firebase-app-hosting-basics.

8. Optional: Mit Agent Skills for Firebase eine Anwendung erstellen und bereitstellen

Verwenden Sie nun die installierten Agent Skills für Firebase, um eine Webanwendung für Aufgabenlisten mit Nutzerauthentifizierung und einer Datenbank zu erstellen und in Firebase App Hosting bereitzustellen.

  1. Wenn Sie sich noch in der Gemini CLI befinden, geben Sie /quit ein, um sie zu beenden.
  2. Erstellen Sie ein neues Verzeichnis für Ihr Projekt und rufen Sie dieses Verzeichnis auf:
    mkdir todo-app && cd todo-app
  3. Melden Sie sich mit Ihrem Google-Konto bei Firebase an. Wenn Sie Cloud Shell oder eine andere Umgebung ohne Browser verwenden, verwenden Sie das Flag --no-localhost.
    firebase login --no-localhost
    Folgen Sie der Anleitung, um die Firebase CLI zu autorisieren.
  4. Gemini CLI starten:
    gemini
  5. Bitten Sie Gemini nun, den Anwendungscode zu generieren:
    Generate HTML, CSS, and Javascript for a single page  application. It should use Google Sign-in with Firebase Authentication, and save tasks in Cloud Firestore for the signed-in user. A user should be able to add new tasks and see a list of their tasks.
    Gemini kann Sie auffordern, Dateien wie index.html, style.css und script.js zu erstellen. Erlauben Sie es.
  6. Stellen Sie die Anwendung schließlich in Firebase App Hosting bereit:
    /firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
    Folgen Sie der Anleitung, um App Hosting zu konfigurieren und die Bereitstellung abzuschließen. Nach der Bereitstellung sollten Sie eine URL für Ihre Live-Anwendung erhalten.

9. Fazit

Glückwunsch! Sie haben erfolgreich einen Skill erstellt und gelernt, wie Sie zusätzliche Skills für die Gemini CLI installieren.

Optional: Bereinigen

Wenn Sie Ihr Cloud-Projekt bereinigen möchten, können Sie es löschen, um zusätzliche Gebühren zu vermeiden.

Wenn Sie möchten, können Sie das Projekt löschen:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Möglicherweise möchten Sie auch unnötige Ressourcen von Ihrer Cloud Shell-Festplatte löschen. Sie haben folgende Möglichkeiten:

  1. Löschen Sie das Skill-Verzeichnis: 
    rm -rf ~/.gemini/skills/my-favorite-things
  2. Warnung! Die nächste Aktion kann nicht rückgängig gemacht werden. Wenn Sie alles in Ihrer Cloud Shell löschen möchten, um Speicherplatz freizugeben, können Sie Ihr gesamtes Basisverzeichnis löschen. Achten Sie darauf, dass alles, was Sie behalten möchten, an einem anderen Ort gespeichert ist. 
    sudo rm -rf $HOME