Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

1. Wprowadzenie

Zdjęcie główne laboratorium Umiejętności agenta

Z tego modułu 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 interfejsu wiersza poleceń Antigravity.

Jakie zadania wykonasz

Twórz własne umiejętności agenta do ulubionych czynności.
Użyj interfejsu wiersza poleceń Antigravity, aby wysłać zapytanie do swojego umiejętności.
Zainstaluj oficjalne umiejętności agenta w 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 interfejsie wiersza poleceń Antigravity

2. Konfiguracja projektu

Jeśli nie masz jeszcze konta Google, musisz je utworzyć.
- Używaj 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 do tego ćwiczenia.
Zaloguj się w konsoli Google Cloud.
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 o wartości 300 USD.
Utwórz nowy projekt lub użyj już istniejącego.
- Jeśli zobaczysz błąd dotyczący limitu projektu, użyj ponownie istniejącego projektu lub usuń go, aby utworzyć nowy.

3. Otwórz edytor Cloud Shell

Kliknij ten link, aby przejść bezpośrednio do edytora Cloud Shell.
Jeśli w dowolnym momencie pojawi się prośba o autoryzację, kliknij Autoryzuj, aby kontynuować.
Jeśli terminal nie pojawia się u dołu ekranu, otwórz go:
- Kliknij Wyświetl.
- Kliknij Terminal.
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}'
```
Powinien wyświetlić się ten komunikat:
```
Updated property [core/project].
```
Jeśli widzisz znak WARNING i pojawia się pytanie Do you want to continue (Y/n)?, prawdopodobnie identyfikator projektu został wpisany nieprawidłowo. Naciśnij n, a potem 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 plik SKILL.md, który zawiera instrukcje i wiedzę dla agenta AI. W tej sekcji utworzysz umiejętność, która nauczy interfejs wiersza poleceń Antigravity Twoich ulubionych rzeczy.

Utwórz katalog na potrzeby tego modułu i przejdź do niego:
```
mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
```

Utwórz katalog umiejętności projektu:

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

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.

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 pliku SKILL.md udało Ci się utworzyć pierwszą umiejętność. Czas użyć jej w interfejsie wiersza poleceń Antigravity.

5. Korzystanie z umiejętności w interfejsie wiersza poleceń Antigravity

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

Uruchom interfejs wiersza poleceń Antigravity:
```
agy
```

Uwierzytelnij się za pomocą interfejsu Antigravity CLI: podczas pierwszego uruchomienia wymagane jest uwierzytelnienie. Wybierz OAuth (naciśnij Enter).
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).
Zaloguj się na konto Google
Skopiuj kod
Wklej kod w terminalu edytora Cloud Shell.
Naciśnij Enter.
Naciśnij Enter, aby zaakceptować niektóre ustawienia domyślne.
Wyświetlanie przez Antigravity CLI 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.
Naciśnij ESC, aby zamknąć widok umiejętności
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 pokazywać, że interfejs wiersza poleceń Antigravity 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ąć interfejs wiersza poleceń Antigravity.

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 przepływów pracy, które można łatwo udostępniać i ponownie wykorzystywać.

Umiejętności agenta w Firebase to doskonały przykład takich przenośnych modułów. Zostały one zaprojektowane, aby pomagać asystentom AI w zrozumieniu sprawdzonych metod korzystania z Firebase i wykonywaniu złożonych zadań z większą dokładnością i niższym 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 Hostingu Firebase.

Konfigurowanie projektu

Jeśli nadal korzystasz z interfejsu Antigravity CLI, wpisz /exit, aby go zamknąć.
Utwórz nowy katalog projektu i przejdź do niego:
```
mkdir ~/todo-app && cd ~/todo-app
```
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 (tak) i naciśnij Enter.
  - Gdy pojawi się pytanie Allow Firebase to collect CLI and Emulator Suite usage and error reporting information?, wpisz Y (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 następnie wklej go do przeglądarki), 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 .

Instalowanie umiejętności agenta w Firebase

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

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

npx skills add firebase/agent-skills

Podczas instalacji zobaczysz prośbę o wybranie umiejętności do zainstalowania. 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

Wybieranie 5 umiejętności związanych z Firebase

W przypadku kolejnych promptów możesz bezpiecznie zaakceptować ustawienia 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 interfejsie wiersza poleceń Antigravity 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

Włącz wymagane interfejsy API w projekcie:

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

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

firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}

Uruchom interfejs wiersza poleceń Antigravity:
```
agy
```
Poproś 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 wiersza poleceń Antigravity poprosi o uprawnienia podczas generowania i wdrażania aplikacji. Aby zezwolić na to działanie, naciśnij Enter. Może być konieczne wpisanie „approve” (zatwierdź) i naciśnięcie Enter.Interfejs wiersza poleceń Antigravity powinien używać funkcji Agent Skills for Firebase do tworzenia i wdrażania witryny. W razie potrzeby udzielaj agentowi zgody na wykonywanie działań.

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

Uruchom interfejs wiersza poleceń Antigravity, jeśli nie jest jeszcze uruchomiony:
```
agy
```
Interfejs wiersza poleceń Antigravity może zadawać pytania, np. „Do you trust this folder?” (Czy ufasz temu folderowi?). Aby zaakceptować ustawienia domyślne, naciśnij Enter.
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.
```
Wiersz poleceń Antigravity może poprosić o utworzenie lub zaktualizowanie plików takich jak index.html, style.css i script.js. Zezwól na to. Wiersz poleceń Antigravity może poprosić Cię o wykonanie pewnych działań w konsoli Firebase. Wiersz poleceń jest w stanie wykonać większość z nich, 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 uwierzytelniania Google).

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

Uruchom interfejs wiersza poleceń Antigravity, jeśli nie jest jeszcze uruchomiony:
```
agy
```
Interfejs wiersza poleceń Antigravity może zadawać pytania, np. „Do you trust this folder?” (Czy ufasz temu folderowi?). Aby zaakceptować ustawienia domyślne, naciśnij Enter.

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.

Interfejs wiersza poleceń Antigravity zaktualizuje pliki. Zezwól na to.

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 zainstalować dodatkowe umiejętności w interfejsie 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.

Usuń katalog laboratorium (spowoduje to usunięcie zarówno umiejętności, jak i aplikacji):
```
rm -rf ~/agent-skills-lab
```
Usuń katalog aplikacji „Lista zadań” (jeśli został utworzony poza tym środowiskiem):
```
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.