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

1. Einführung

In diesem Lab erfahren Sie, wie Sie Agent Skills erstellen, um KI-Agenten Zugriff auf benutzerdefiniertes Wissen und benutzerdefinierte Workflows zu gewähren. Sie erstellen sie als lokalen Skill, auf den über die Antigravity CLI zugegriffen werden kann.

Aufgaben

• Erstellen Sie eigene Agent Skills für Ihre Lieblingsthemen.
• Fragen Sie Ihren Skill mit der Antigravity CLI ab.
• Installieren Sie offizielle Agent Skills für Firebase und verwenden Sie sie, um eine App zu erstellen und bereitzustellen.

Lerninhalte

• Wie Sie einen Skill strukturieren.
• Wie Sie eine SKILL.md-Datei schreiben.
• Wie Sie lokale Skills mit der Antigravity CLI verwenden.

2. Projekt einrichten

1. Wenn Sie noch kein Google-Konto haben, müssen Sie eines erstellen.
   • Verwenden Sie ein privates Konto anstelle eines Arbeitskontos oder eines Kontos einer Bildungseinrichtung. Bei Arbeits- und Schulkonten können Einschränkungen gelten, die verhindern, dass Sie die für dieses Lab erforderlichen APIs aktivieren.
2. Melden Sie sich in der Google Cloud Console an.
3. Abrechnung aktivieren in der Cloud Console.
   • Die Kosten für dieses Lab sollten weniger als 1 $ für Cloud-Ressourcen betragen.
   • Am Ende dieses Labs finden Sie eine Anleitung zum Löschen von Ressourcen, um weitere Kosten zu vermeiden.
   • Neue Nutzer können die kostenlose Testversion mit einem Guthaben von 300 $ nutzen.
4. Erstellen Sie ein neues Projekt oder verwenden Sie ein vorhandenes Projekt wieder.
   • Wenn ein Fehler wegen des Projektkontingents angezeigt wird, 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 zu Cloud Shell-Editor zu gelangen.
2. Wenn Sie heute aufgefordert werden, eine Autorisierung vorzunehmen, 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 mit diesem Befehl Ihr Projekt 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 diesem Befehl auflisten:

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

     
5. Es sollte folgende Meldung angezeigt werden:

   Updated property [core/project].
   

   Wenn Sie eine WARNING-Meldung sehen und gefragt werden, ob Sie fortfahren möchten (Do you want to continue (Y/n)?), haben Sie die Projekt-ID wahrscheinlich falsch eingegeben. Drücken Sie n, dann die Enter und versuchen Sie noch einmal, den Befehl gcloud config set project auszuführen.

4. Benutzerdefinierten Skill erstellen

Agent Skills sind Verzeichnisse, die mindestens eine SKILL.md-Datei enthalten, die einem KI-Agenten Anweisungen und Wissen zur Verfügung stellt. In diesem Abschnitt erstellen Sie einen Skill, mit dem Sie der Antigravity CLI Ihre Lieblingsthemen beibringen.

1. Erstellen Sie ein Verzeichnis für dieses Lab und wechseln Sie zu diesem Verzeichnis:

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

2. Erstellen Sie ein Verzeichnis für Ihren Projektskill:

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

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

   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 können Sie diesen Skill in der Antigravity CLI verwenden.

5. Skill über die Antigravity CLI verwenden

Nachdem Sie einen Skill erstellt haben, kann er bereits von der Antigravity CLI erkannt werden, 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. Authentifizieren Sie sich mit der Antigravity CLI: Beim ersten Start ist eine Authentifizierung erforderlich. Wählen Sie OAuth aus (drücken Sie die Enter).
2. Klicken Sie auf den Link. Wenn Sie nicht darauf klicken können, markieren Sie die URL in Cloud Shell, kopieren Sie sie und fügen Sie sie in Ihren Browser ein.
3. Im Google-Konto anmelden
4. Code kopieren
5. Fügen Sie den Code in das Terminal des Cloud Shell-Editors ein.
6. Drücken Sie die Enter.
7. Drücken Sie Enter, um einige Standardeinstellungen zu übernehmen.
8. Lassen Sie die Antigravity CLI die Skills auflisten, die in ihrem Kontext verfügbar sind.

   /skills
   

   In der Liste der verfügbaren Skills sollte my-favorite-things angezeigt werden.
9. Drücken Sie ESC, um die Skill-Ansicht zu beenden.
10. Fragen Sie die Antigravity CLI nach Ihrer Lieblingsfarbe:

    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 erfolgreich einen Skill erstellt und ihn mit der Antigravity CLI getestet.

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

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

Neben dem Erstellen eigener Skills können Sie auch Skills installieren, die von anderen erstellt wurden. Hier wird die Verwendung von portablen Skills veranschaulicht. Das sind in sich geschlossene Module mit Wissen, Anweisungen und Workflows, die einfach freigegeben und wiederverwendet werden können.

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

Erstellen Sie jetzt mit Agent Skills für Firebase eine Webanwendung für Aufgabenlisten 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 wechseln Sie zu diesem Verzeichnis:

   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-Prompts interagieren:
      • Wenn Sie gefragt werden Enable Gemini in Firebase features?, geben Sie Y (für „Ja“) ein und drücken Sie die Enter.
      • Wenn Sie gefragt werden, ob Firebase Daten zur CLI- und Emulator Suite-Nutzung und zu Fehlerberichten erfassen darf (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 Sie nicht darauf klicken können, markieren Sie die URL in Cloud Shell, kopieren Sie sie und fügen Sie sie 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 im 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 Eingabeaufforderung ? Enter authorization code: ein.
      • Drücken Sie die Enter.
   Sie sollten eine Erfolgsmeldung sehen: ✔ 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 Ihr 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, die zu installierenden Skills auszuwählen. Verwenden Sie die Pfeiltasten , um in der Liste zu navigieren, und die Leertaste , um diese Skills auszuwählen.

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

Bei nachfolgenden Eingabeaufforderungen können Sie die Standardeinstellungen übernehmen, indem Sie die Enter drücken.

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

Weitere Informationen zu Agent Skills für Firebase finden Sie unter Verfügbare Skills.

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 die Antigravity CLI auf, eine einfache index.html-Datei 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 „approve“ 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 Agenten bei Bedarf mit Genehmigungen an.

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

Firebase Authentication hinzufügen

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

   agy
   

   Die Antigravity CLI kann Fragen wie „Do you trust this folder?“ stellen. Drücken Sie Enter, um die Standardeinstellungen zu übernehmen.
2. Fordern Sie die Antigravity CLI auf, 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 kann Sie auffordern, Dateien wie index.html, style.css und script.js zu erstellen oder zu aktualisieren. Erlauben Sie dies. Die Antigravity CLI kann Sie auffordern, einige Aktionen in der Firebase Console auszuführen. Die CLI kann die meisten dieser Aktionen 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 Webanwendung angezeigt werden. Verwenden Sie ctrl+click (Windows/Linux) oder cmd+click (Mac), um Links im Terminal des Cloud Shell-Editors zu öffnen. Rufen Sie die URL für Ihre bereitgestellte Anwendung 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 „Do you trust this folder?“ stellen. Drücken Sie Enter, um die Standardeinstellungen zu übernehmen.
2. Fordern Sie die Antigravity CLI auf, Firestore hinzuzufügen, um Aufgaben zu speichern:

   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. Erlauben Sie dies.

Nach der Bereitstellung sollte eine URL für Ihre Webanwendung angezeigt werden. Verwenden Sie ctrl+click (Windows/Linux) oder cmd+click (Mac), um Links im Terminal des Cloud Shell-Editors zu öffnen. Rufen Sie die URL für Ihre bereitgestellte Anwendung 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 bereinigen möchten, können Sie Ihr Cloud-Projekt löschen, um zusätzliche Kosten zu vermeiden.

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

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Sie können auch unnötige Ressourcen von Ihrem Cloud Shell-Laufwerk 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 Verzeichnis der Anwendung für Aufgabenlisten, falls Sie es außerhalb erstellt haben:

   rm -rf ~/todo-app
   

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