KI-Agent-Skills verwenden (mit Antigravity CLI und Agent Skills für Firebase)

1. Einführung

In diesem Lab erfahren Sie, wie Sie Agenten-Skills erstellen, um KI-Agenten Zugriff auf benutzerdefiniertes Wissen und benutzerdefinierte Workflows zu ermöglichen. Sie erstellen ihn als lokalen Skill, auf den über die Antigravity CLI zugegriffen werden kann.

Aufgaben

• Eigene Agent-Skills für Ihre Lieblingsaktivitäten erstellen
• Verwenden Sie die Antigravity CLI, um Ihren Skill abzufragen.
• 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 Antigravity CLI verwenden

2. Projekt einrichten

1. Wenn Sie noch kein Google-Konto haben, müssen Sie ein Google-Konto erstellen.
   • Verwenden Sie stattdessen ein privates Konto anstelle eines Kontos einer Bildungseinrichtung. Bei Arbeitskonten und Konten einer Bildungseinrichtung 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 kommen für die kostenlose Testversion mit einem Guthaben von 300 $ infrage.
4. Erstellen Sie ein neues Projekt oder verwenden Sie ein vorhandenes Projekt.
   • Wenn Sie einen Fehler 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 irgendeiner Stelle zur Autorisierung aufgefordert werden, klicken Sie auf Autorisieren, um fortzufahren.
3. Wenn das Terminal nicht unten auf dem Bildschirm angezeigt wird, öffnen Sie es:
   • Klicken Sie auf Ansehen.
   • Klicken Sie auf Terminal
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 mehr an Ihre Projekt-ID erinnern können, gehen Sie so vor:
     • Sie können alle Ihre Projekt-IDs mit folgendem Befehl auflisten:

       gcloud projects list | awk '/PROJECT_ID/{print $2}'
       

     
5. Es sollte folgende Meldung angezeigt werden:

   Updated property [core/project].
   

   Wenn Sie den Fehler WARNING erhalten und aufgefordert werden, Do you want to continue (Y/n)?, 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. Benutzerdefinierten Skill erstellen

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

1. Erstellen Sie ein Verzeichnis für dieses Lab und rufen Sie es auf:

   mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
   

2. Erstellen Sie ein Verzeichnis für Ihren Projekt-Skill:

   mkdir -p ~/agent-skills-lab/.agents/skills/my-favorite-things
   

3. Erstellen Sie eine neue SKILL.md-Datei für Ihren Skill und öffnen Sie sie:

   cloudshell edit ~/agent-skills-lab/.agents/skills/my-favorite-things/SKILL.md
   

   Mit dem Befehl cloudshell edit wird die Datei SKILL.md im Editor über dem Terminal geöffnet.
4. Fügen Sie der Datei SKILL.md den folgenden Inhalt hinzu:

   ---
   name: my-favorite-things
   description: Provides personal information about my favorite color, food, and programming language. Use this skill when the user asks questions about my personal preferences or favorite things.
   ---
   
   # Knowledge
   
   - **Favorite Color:** Blue
   - **Favorite Food:** Pizza
   - **Favorite Programming Language:** 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, diesen Skill in der Antigravity CLI zu verwenden.

5. Skill über die Antigravity CLI verwenden

Nachdem Sie einen Skill erstellt haben, ist er bereits über die Antigravity CLI auffindbar, da er sich im Verzeichnis .agents/skills befindet.

1. Starten Sie die Antigravity CLI:

   agy
   

Hinweis:Die Antigravity CLI ist in Cloud Shell vorinstalliert.

1. Mit der Antigravity CLI authentifizieren: Beim ersten Start ist eine Authentifizierung erforderlich. Wählen Sie OAuth aus (drücken Sie Enter).
2. Klicken Sie auf den Link. Wenn er nicht anklickbar ist, markieren Sie die URL in Cloud Shell, um sie zu kopieren, und fügen Sie sie dann in Ihren Browser ein.
3. Im Google-Konto anmelden
4. Code kopieren
5. Code in das Cloud Shell-Editor-Terminal einfügen
6. Drücken Sie Enter.
7. Drücken Sie Enter, um einige Standardeinstellungen zu übernehmen.
8. Antigravity CLI die Skills auflisten lassen, die im Kontext verfügbar sind

   /skills
   

   my-favorite-things sollte in der Liste der verfügbaren Skills angezeigt werden.
9. Drücke ESC, um die Ansicht der Skills zu beenden.
10. Antigravity CLI nach Ihrer Lieblingsfarbe fragen:

    What is my favorite color?
    

    Die Antigravity-CLI sollte den Skill my-favorite-things verwenden, um Ihre Frage zu beantworten. Wenn Sie dazu aufgefordert werden, erlauben Sie der Antigravity CLI, den Skill zu verwenden.

In der Ausgabe sollte zu sehen sein, dass die Antigravity CLI Ihren Skill verwendet und mit etwas wie „Blau“ oder „Meine Lieblingsfarbe ist Blau“ geantwortet hat.

Sie haben es geschafft! Sie haben einen Skill erstellt und mit der Antigravity CLI getestet.

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

6. (Optional) Anwendung erstellen und in Firebase Hosting bereitstellen

Sie können nicht nur eigene Skills erstellen, sondern auch von anderen entwickelte Skills installieren. Hier wird die Verwendung von portablen Skills demonstriert – in sich geschlossene Wissens-, Anleitungs- und Workflowmodule, die sich einfach teilen und wiederverwenden lassen.

Agent Skills für Firebase sind ein gutes Beispiel für diese portablen Module. Sie sollen KI-Assistenten helfen, Firebase-Best Practices zu verstehen und komplexe Aufgaben mit höherer Genauigkeit und geringeren Token-Kosten auszuführen.

Erstellen Sie jetzt mit Agent Skills for Firebase eine „To-do“-Webanwendung mit Nutzerauthentifizierung und einer Datenbank und stellen Sie sie in Firebase Hosting bereit.

Projekt einrichten

1. Wenn Sie sich noch in der Antigravity CLI befinden, geben Sie /exit ein, um sie zu beenden.
2. Erstellen Sie ein neues Verzeichnis für Ihr Projekt und rufen Sie es auf:

   mkdir ~/todo-app && cd ~/todo-app
   

3. Melden Sie sich mit Ihrem Google-Konto in Firebase an. Verwenden Sie das Flag --no-localhost, da Sie sich in Cloud Shell befinden:

   firebase login --no-localhost
   

   1. Mit den CLI-Aufforderungen interagieren:
      • Wenn Sie gefragt werden, ob Sie Enable Gemini in Firebase features?, geben Sie Y (für „Ja“) ein und drücken Sie die Enter.
      • Wenn Sie gefragt werden, ob Sie Allow Firebase to collect CLI and Emulator Suite usage and error reporting information?, geben Sie Y (für „Ja“) ein und drücken Sie die Enter.
   2. Im Browser autorisieren
      :
      • Im Terminal wird eine URL angezeigt. Klicken Sie auf den Link (wenn er nicht anklickbar ist, markieren Sie die URL in Cloud Shell, um sie zu kopieren, und fügen Sie sie dann in Ihren Browser ein), um die Anmeldeseite in einem neuen Browsertab zu öffnen.
      • Schritt 1 von 3 (Befehl bestätigen): Klicken Sie auf Ja, ich habe diesen Befehl ausgeführt.
      • Schritt 2 von 3 (Sitzungs-ID bestätigen): Prüfen Sie, ob die Sitzungs-ID mit der in Ihrem Terminal angezeigten ID übereinstimmt, und klicken Sie dann auf Ja, das ist meine Sitzungs-ID.
      • Schritt 3 von 3 (Code kopieren): Klicken Sie auf Kopieren, um den Autorisierungscode in die Zwischenablage zu kopieren.
   3. Anmeldung abschließen
      :
      • Kehren Sie zum Cloud Shell-Terminal zurück und fügen Sie den Autorisierungscode an der ? Enter authorization code:-Eingabeaufforderung ein.
      • Drücken Sie Enter.
   Es sollte eine Erfolgsmeldung angezeigt werden: ✔ Success! Logged in as .

Tipp:Wenn Sie den Autorisierungscode in Cloud Shell einfügen, achten Sie auf ein Chrome-Dialogfeld, in dem Sie nach Berechtigungen für die Zwischenablage gefragt werden, und stellen Sie sicher, dass diese aktiviert sind. Sie können den Code mit Ctrl+Shift+V (Windows) oder CMD+Shift+V (Mac) in das Terminal einfügen.

Agent Skills für Firebase installieren

Nachdem Sie das Projektverzeichnis erstellt haben, sollten Sie die Agent Skills für Firebase darin installieren.

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

npx skills add firebase/agent-skills

Während der Installation werden Sie aufgefordert, auszuwählen, welche Skills installiert werden sollen. Verwenden Sie die Pfeiltasten, um in der Liste zu navigieren, und die Leertaste, um diese Fähigkeiten auszuwählen.

• firebase-auth-basics
• firebase-basics
• firebase-firestore
• firebase-hosting-basics
• firebase-security-rules-auditor

Bei nachfolgenden Aufforderungen können Sie die Standardwerte durch Drücken von Enter übernehmen.

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

Weitere Informationen zu Agent Skills für Firebase

Einfache Webanwendung erstellen und bereitstellen

1. Aktivieren Sie die erforderlichen APIs für Ihr Projekt:

   gcloud services enable \
     cloudresourcemanager.googleapis.com \
     firebase.googleapis.com
   

2. Aktivieren Sie Firebase in Ihrem aktuellen Google Cloud-Projekt:

   firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
   

3. Starten Sie die Antigravity CLI:

   agy
   

4. Fordern Sie Antigravity CLI auf, eine einfache index.html zu generieren:

   Generate an index.html file with the content "Hello Firebase Hosting" and
   deploy the application to Firebase Hosting using the current Google Cloud
   Project.
   

   Die Antigravity CLI fordert Berechtigungen an, während sie die Anwendung generiert und bereitstellt. Drücken Sie Enter, um dies zu erlauben. Möglicherweise müssen Sie „genehmigen“ eingeben und Enter drücken.Die Antigravity CLI sollte die Agent Skills für Firebase verwenden, um Ihre Website zu erstellen und bereitzustellen. Leiten Sie den KI-Agenten bei Bedarf an und erteilen Sie Genehmigungen.

Nach der Bereitstellung sollte eine URL für Ihre Web-App angezeigt werden. Verwenden Sie ctrl+click (Windows/Linux) oder cmd+click (Mac), um Links im Cloud Shell Editor-Terminal zu öffnen. Rufen Sie die URL Ihrer bereitgestellten App auf.

Firebase Authentication hinzufügen

1. Starten Sie die Antigravity CLI, falls sie noch nicht gestartet wurde:

   agy
   

   Die Antigravity CLI kann Fragen wie „Vertraust du diesem Ordner?“ stellen. Drücken Sie Enter, um die Standardeinstellungen zu übernehmen.
2. Bitten Sie nun Antigravity CLI, die Google-Anmeldung hinzuzufügen:

   Generate HTML, CSS, and Javascript for a single page application.
   It should use Google Sign-in with Firebase Authentication.
   A user should be able to sign in with their Google Account.
   Deploy when you are done and give the URL to me.
   

   Die Antigravity CLI fordert Sie möglicherweise auf, Dateien wie index.html, style.css und script.js zu erstellen oder zu aktualisieren. Erlauben Sie das. Möglicherweise werden Sie von der Antigravity CLI aufgefordert, einige Aktionen in der Firebase Console auszuführen. Die CLI kann die meisten dieser Schritte ausführen, wenn Sie sie dazu auffordern. Wenn auf Ihrer Cloud Shell-Instanz jedoch eine ältere Version der Firebase CLI installiert ist, müssen Sie die Schritte möglicherweise manuell ausführen, z. B. Google-OAuth aktivieren.

Nach der Bereitstellung sollte eine URL für Ihre Web-App angezeigt werden. Verwenden Sie ctrl+click (Windows/Linux) oder cmd+click (Mac), um Links im Cloud Shell Editor-Terminal zu öffnen. Rufen Sie die URL Ihrer bereitgestellten App auf.

Damit Ihre letzten Änderungen angezeigt werden, müssen Sie möglicherweise eine „harte Aktualisierung“ mit ctrl+shift+R (Windows/Linux) oder cmd+shift+R (Mac) durchführen.

Cloud Firestore hinzufügen

1. Starten Sie die Antigravity CLI, falls sie noch nicht gestartet wurde:

   agy
   

   Die Antigravity CLI kann Fragen wie „Vertraust du diesem Ordner?“ stellen. Drücken Sie Enter, um die Standardeinstellungen zu übernehmen.
2. Bitten Sie die Antigravity CLI, Firestore zum Speichern von Aufgaben hinzuzufügen:

   Update the application to 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.
   Deploy when you are done and give the URL to to me.
   

   Die Antigravity CLI aktualisiert die Dateien. Lassen Sie das zu.

Nach der Bereitstellung sollte eine URL für Ihre Web-App angezeigt werden. Verwenden Sie ctrl+click (Windows/Linux) oder cmd+click (Mac), um Links im Cloud Shell Editor-Terminal zu öffnen. Rufen Sie die URL Ihrer bereitgestellten App auf.

Damit Ihre letzten Änderungen angezeigt werden, müssen Sie möglicherweise eine „harte Aktualisierung“ mit ctrl+shift+R (Windows/Linux) oder cmd+shift+R (Mac) durchführen.

Wenn Ihre Anwendung nicht wie erwartet funktioniert, arbeiten Sie weiter mit der Antigravity CLI, um die gewünschte Funktionalität zu erhalten. Beispiel: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

Experimentieren Sie weiter mit dem Lab, um Funktionen hinzuzufügen, die Sie in Ihrer neuen Firebase-Anwendung sehen möchten.

7. Fazit

Glückwunsch! Sie haben erfolgreich einen Skill erstellt und gelernt, wie Sie zusätzliche Skills für die Antigravity 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

Sie können auch unnötige Ressourcen von Ihrer Cloud Shell-Festplatte löschen, um Speicherplatz freizugeben.

1. Löschen Sie das Lab-Verzeichnis. Dadurch werden sowohl der Skill als auch die App entfernt:

   rm -rf ~/agent-skills-lab
   

2. Löschen Sie das Anwendungsverzeichnis „To Do“, falls Sie es extern erstellt haben:

   rm -rf ~/todo-app
   

Wenn Sie Cloud Shell auf den Standardzustand zurücksetzen müssen, finden Sie in der offiziellen Dokumentation eine Anleitung dazu.