Jak korzystać z umiejętności agenta AI (za pomocą interfejsu wiersza poleceń Antigravity i umiejętności agenta w Firebase)

1. Wprowadzenie

W tym module dowiesz się, jak tworzyć umiejętności agenta, aby zapewnić agentom AI dostęp do specjalistycznej wiedzy i przepływów pracy. Utworzysz go jako umiejętność lokalną, do której można uzyskać dostęp z Antigravity CLI.

Jakie zadania wykonasz

• Twórz własne umiejętności agenta do ulubionych czynności.
• Użyj Antigravity CLI, aby wysłać zapytanie do umiejętności.
• Zainstaluj oficjalne umiejętności agenta Firebase i użyj ich do tworzenia i wdrażania aplikacji.

Czego się nauczysz

• Jak skonstruować umiejętność.
• Jak napisać plik SKILL.md.
• Jak używać lokalnych umiejętności w Antigravity CLI.

2. Konfiguracja projektu

1. Jeśli nie masz jeszcze konta Google, musisz je utworzyć.
   • Użyj konta osobistego zamiast konta służbowego lub szkolnego. Konta służbowe i szkolne mogą mieć ograniczenia, które uniemożliwiają włączenie interfejsów API potrzebnych w tym module.
2. Zaloguj się w konsoli Google Cloud.
3. Włącz płatności w konsoli Google Cloud.
   • Pod względem opłat za zasoby chmury ukończenie tego modułu powinno kosztować mniej niż 1 USD.
   • Jeśli chcesz uniknąć dalszych opłat, wykonaj czynności opisane na końcu tego modułu, aby usunąć zasoby.
   • Nowi użytkownicy mogą skorzystać z bezpłatnego okresu próbnego, w którym mają do dyspozycji środki w wysokości 300 USD.
4. Utwórz nowy projekt lub użyj już istniejącego.
   • Jeśli pojawi się błąd dotyczący limitu projektu, użyj ponownie istniejącego projektu lub usuń go, aby utworzyć nowy.

3. Otwórz edytor Cloud Shell

1. Kliknij ten link, aby przejść bezpośrednio do edytora Cloud Shell
2. Jeśli w dowolnym momencie pojawi się prośba o autoryzację, kliknij Autoryzuj, aby kontynuować.
3. Jeśli terminal nie pojawia się u dołu ekranu, otwórz go:
   • Kliknij Wyświetl.
   • Kliknij Terminal.
4. W terminalu ustaw projekt za pomocą tego polecenia:
   • Format:

     gcloud config set project [PROJECT_ID]
     

   • Przykład:

     gcloud config set project lab-project-id-example
     

   • Jeśli nie pamiętasz identyfikatora projektu:
     • Aby wyświetlić listę wszystkich identyfikatorów projektów, użyj tego polecenia:

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

     
5. Powinien wyświetlić się ten komunikat:

   Updated property [core/project].
   

   Jeśli widzisz symbol WARNING i pojawia się pytanie Do you want to continue (Y/n)?, prawdopodobnie identyfikator projektu został wpisany nieprawidłowo. Naciśnij n, a następnie Enter i spróbuj ponownie uruchomić polecenie gcloud config set project.

4. Tworzenie własnej umiejętności

Umiejętności agenta to katalogi zawierające co najmniej 1 plik SKILL.md, który zawiera instrukcje i wiedzę dla agenta AI. W tej sekcji utworzysz umiejętność, która nauczy Antigravity CLI Twoich ulubionych rzeczy.

1. Utwórz katalog na potrzeby tego laboratorium i przejdź do niego:

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

2. Utwórz katalog umiejętności projektu:

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

3. Utwórz i otwórz nowy plik SKILL.md dla swojej umiejętności:

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

   Polecenie cloudshell edit otworzy plik SKILL.md w edytorze nad terminalem.
4. Dodaj do pliku SKILL.md te wiersze:

   ---
   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.
   

Za pomocą tylko SKILL.md udało Ci się utworzyć pierwszą umiejętność. Czas użyć tej umiejętności w interfejsie wiersza poleceń Antigravity.

5. Korzystanie z umiejętności w Antigravity CLI

Po utworzeniu umiejętności jest ona już wykrywalna przez Antigravity CLI, ponieważ znajduje się w katalogu .agents/skills.

1. Uruchom Antigravity CLI:

   agy
   

Uwaga: Antigravity CLI jest wstępnie zainstalowany w Cloud Shell.

1. Uwierzytelnij się za pomocą interfejsu Antigravity CLI: podczas pierwszego uruchomienia wymagane jest uwierzytelnienie. Wybierz OAuth (naciśnij Enter).
2. Kliknij link (jeśli nie można go kliknąć, zaznacz adres URL w Cloud Shell, aby go skopiować, a następnie wklej go w przeglądarce).
3. Zaloguj się na konto Google
4. Skopiuj kod
5. Wklej kod w terminalu edytora Cloud Shell.
6. Naciśnij Enter.
7. Naciśnij Enter, aby zaakceptować niektóre ustawienia domyślne.
8. Poproś Antigravity CLI o wyświetlenie umiejętności dostępnych w jego kontekście.

   /skills
   

   Na liście dostępnych umiejętności powinna pojawić się pozycja my-favorite-things.
9. Naciśnij ESC, aby zamknąć widok umiejętności
10. Zapytaj Antigravity CLI o ulubiony kolor:

    What is my favorite color?
    

    Interfejs wiersza poleceń Antigravity powinien użyć my-favorite-things, aby odpowiedzieć na Twoje pytanie. Jeśli pojawi się prośba, zezwól interfejsowi wiersza poleceń Antigravity na korzystanie z umiejętności.

Wynik powinien wskazywać, że interfejs Antigravity CLI użył Twojej umiejętności i odpowiedział np. „Niebieski” lub „Mój ulubiony kolor to niebieski”.

Udało Ci się! Udało Ci się utworzyć umiejętność i przetestować ją za pomocą interfejsu Antigravity CLI.

Gdy zechcesz zakończyć sesję, wpisz /exit, a potem naciśnij Enter, aby zamknąć Antigravity CLI.

6. (Opcjonalnie) Tworzenie i wdrażanie aplikacji w Hostingu Firebase

Oprócz tworzenia własnych umiejętności możesz instalować umiejętności utworzone przez inne osoby. Pokazuje to wykorzystanie przenośnych umiejętności, czyli samodzielnych modułów wiedzy, instrukcji i procesów, które można łatwo udostępniać i ponownie wykorzystywać.

Umiejętności agenta Firebase to doskonały przykład takich przenośnych modułów. Zostały one zaprojektowane tak, aby pomagać asystentom AI w poznawaniu sprawdzonych metod korzystania z Firebase i wykonywaniu złożonych zadań z większą dokładnością i mniejszym kosztem tokenów.

Teraz użyj funkcji Agent Skills for Firebase, aby utworzyć aplikację internetową „Lista zadań” z uwierzytelnianiem użytkowników i bazą danych, a następnie wdrożyć ją w usłudze Hosting Firebase.

Konfigurowanie projektu

1. Jeśli nadal korzystasz z interfejsu wiersza poleceń Antigravity, wpisz /exit, aby go zamknąć.
2. Utwórz nowy katalog projektu i przejdź do niego:

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

3. Zaloguj się w Firebase za pomocą konta Google. Użyj flagi --no-localhost, ponieważ korzystasz z Cloud Shell:

   firebase login --no-localhost
   

   1. Odpowiadaj na pytania w interfejsie wiersza poleceń:
      • Gdy pojawi się pytanie Enable Gemini in Firebase features?, wpisz Y (czyli „Tak”) i naciśnij Enter.
      • Gdy pojawi się pytanie Allow Firebase to collect CLI and Emulator Suite usage and error reporting information?, wpisz Y (czyli „Tak”) i naciśnij Enter.
   2. Autoryzacja w przeglądarce:
      • W terminalu zobaczysz adres URL. Kliknij link (jeśli nie można go kliknąć, zaznacz adres URL w Cloud Shell, aby go skopiować, a potem wklej go w przeglądarce), aby otworzyć stronę logowania w nowej karcie przeglądarki.
      • Krok 1 z 3 (potwierdzenie polecenia): kliknij Tak, to polecenie zostało właśnie uruchomione.
      • Krok 2 z 3 (Potwierdź identyfikator sesji): sprawdź, czy identyfikator sesji jest zgodny z identyfikatorem wyświetlanym w terminalu, a następnie kliknij Tak, to jest mój identyfikator sesji.
      • Krok 3 z 3 (Kopiowanie kodu): kliknij Kopiuj, aby skopiować kod autoryzacji do schowka.
   3. Dokończ logowanie:
      • Wróć do terminala Cloud Shell i wklej kod autoryzacji w wierszu poleceń ? Enter authorization code:.
      • Naciśnij Enter.
   Powinien wyświetlić się komunikat o powodzeniu: ✔ Success! Logged in as .

Wskazówka: podczas wklejania kodu autoryzacji w Cloud Shell zwróć uwagę na okno Chrome z prośbą o uprawnienia do schowka i upewnij się, że są one włączone. Aby wkleić kod w terminalu, możesz użyć klawisza Ctrl+Shift+V (Windows) lub CMD+Shift+V (Mac).

Instalowanie umiejętności agenta Firebase

Po utworzeniu katalogu projektu zainstaluj w nim Agent Skills for Firebase.

Umiejętności agenta Firebase możesz zainstalować za pomocą interfejsu wiersza poleceń umiejętności w terminalu:

npx skills add firebase/agent-skills

Podczas instalacji pojawi się prośba o wybranie umiejętności, które chcesz zainstalować. Aby poruszać się po liście, użyj klawiszy strzałek, a aby wybrać umiejętności, naciśnij spację.

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

W przypadku kolejnych promptów możesz bezpiecznie zaakceptować wartości domyślne, naciskając Enter.

To polecenie pobierze i zainstaluje umiejętności, w tym firebase-basics i firebase-hosting-basics, dzięki czemu będą one dostępne do użycia w Antigravity CLI wraz z umiejętnością my-favorite-things.

Więcej informacji o umiejętnościach agenta w Firebase znajdziesz w tym artykule.

Tworzenie i wdrażanie podstawowej aplikacji internetowej

1. Włącz wymagane interfejsy API w projekcie:

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

2. Włącz Firebase w bieżącym projekcie Google Cloud:

   firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
   

3. Uruchom Antigravity CLI:

   agy
   

4. Poproś interfejs Antigravity CLI o wygenerowanie podstawowego index.html:

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

   Interfejs Antigravity CLI poprosi o uprawnienia podczas generowania i wdrażania aplikacji. Naciśnij Enter, aby zezwolić na to działanie. Może być konieczne wpisanie „approve” i naciśnięcie Enter.Antigravity CLI powinien używać umiejętności agenta w Firebase do tworzenia i wdrażania witryny. W razie potrzeby udzielaj agentowi wskazówek i zatwierdzaj jego działania.

Po zakończeniu wdrażania powinien zostać podany adres URL aplikacji internetowej. Użyj klawisza ctrl+click (Windows/Linux) lub cmd+click (Mac), aby otworzyć linki w terminalu edytora Cloud Shell. Otwórz adres URL wdrożonej aplikacji.

Dodawanie uwierzytelniania Firebase

1. Uruchom interfejs Antigravity CLI, jeśli nie jest jeszcze uruchomiony:

   agy
   

   Interfejs wiersza poleceń Antigravity może zadawać pytania takie jak „Czy ufasz temu folderowi?”. Aby zaakceptować ustawienia domyślne, naciśnij Enter.
2. Teraz poproś interfejs wiersza poleceń Antigravity o dodanie logowania przez Google:

   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.
   

   Interfejs Antigravity CLI może poprosić o utworzenie lub zaktualizowanie plików takich jak index.html, style.css i script.js. Zezwól na to. Interfejs Antigravity CLI może poprosić Cię o wykonanie pewnych działań w konsoli Firebase. Interfejs wiersza poleceń może wykonać większość tych czynności, jeśli poprosisz go o to, ale jeśli na instancji Cloud Shell jest zainstalowana starsza wersja wiersza poleceń Firebase, może być konieczne ręczne wykonanie niektórych czynności (np. włączenie Google OAuth).

Po zakończeniu wdrażania powinien zostać podany adres URL aplikacji internetowej. Użyj klawisza ctrl+click (Windows/Linux) lub cmd+click (Mac), aby otworzyć linki w terminalu edytora Cloud Shell. Otwórz adres URL wdrożonej aplikacji.

Aby zobaczyć najnowsze zmiany, może być konieczne „twarde odświeżenie” za pomocą klawisza ctrl+shift+R (Windows/Linux) lub cmd+shift+R (Mac).

Dodawanie Cloud Firestore

1. Uruchom interfejs Antigravity CLI, jeśli nie jest jeszcze uruchomiony:

   agy
   

   Interfejs wiersza poleceń Antigravity może zadawać pytania takie jak „Czy ufasz temu folderowi?”. Aby zaakceptować ustawienia domyślne, naciśnij Enter.
2. Poproś Antigravity CLI o dodanie Firestore do zapisywania zadań:

   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.
   

   Antigravity CLI zaktualizuje pliki. Zezwól na to.

Po zakończeniu wdrażania powinien zostać podany adres URL aplikacji internetowej. Użyj klawisza ctrl+click (Windows/Linux) lub cmd+click (Mac), aby otworzyć linki w terminalu edytora Cloud Shell. Otwórz adres URL wdrożonej aplikacji.

Aby zobaczyć najnowsze zmiany, może być konieczne „twarde odświeżenie” za pomocą klawisza ctrl+shift+R (Windows/Linux) lub cmd+shift+R (Mac).

Jeśli aplikacja nie działa zgodnie z oczekiwaniami, kontynuuj pracę z interfejsem Antigravity CLI, aby uzyskać oczekiwaną funkcjonalność. Przykład: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

Eksperymentuj w laboratorium, aby dodać funkcje, które chcesz zobaczyć w nowej aplikacji Firebase.

7. Podsumowanie

Gratulacje! Udało Ci się utworzyć umiejętność i dowiedzieć się, jak instalować dodatkowe umiejętności w interfejsie wiersza poleceń Antigravity CLI.

(Opcjonalnie) Zwalnianie miejsca

Jeśli chcesz zwolnić miejsce, możesz usunąć swój projekt w chmurze, aby uniknąć dodatkowych opłat.

Jeśli chcesz, usuń projekt:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Aby zwolnić miejsce, możesz też usunąć z dysku Cloud Shell niepotrzebne zasoby.

1. Usuń katalog laboratorium (spowoduje to usunięcie zarówno umiejętności, jak i aplikacji):

   rm -rf ~/agent-skills-lab
   

2. Usuń katalog aplikacji „Lista zadań” (jeśli został utworzony poza usługą):

   rm -rf ~/todo-app
   

Jeśli kiedykolwiek zechcesz zresetować Cloud Shell do stanu domyślnego, możesz skorzystać z oficjalnej dokumentacji, w której znajdziesz instrukcje, jak to zrobić w bezpieczny sposób.