Jak tworzyć umiejętności agenta w interfejsie wiersza poleceń Gemini

1. Wprowadzenie

Z tego modułu dowiesz się, jak tworzyć umiejętności agenta, aby zapewnić dużym modelom językowym 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ń Gemini.

Jakie zadania wykonasz

Twórz własne umiejętności agenta do ulubionych rzeczy.
Użyj interfejsu wiersza poleceń Gemini, aby wysłać zapytanie do umiejętności.
Zainstaluj oficjalne umiejętności agenta w Firebase i użyj ich do utworzenia oraz wdrożenia aplikacji.

Czego się nauczysz

Jak skonstruować umiejętność.
Jak napisać plik SKILL.md.
Jak korzystać z lokalnych umiejętności za pomocą interfejsu wiersza poleceń Gemini.

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, w którym mają do dyspozycji środki w wysokoś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 pojawi 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 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 umiejętności „ulubione rzeczy”

Umiejętności agenta to katalogi zawierające co najmniej SKILL.md, który zawiera instrukcje i wiedzę dla agenta AI. W tej sekcji utworzysz umiejętność, która nauczy interfejs wiersza poleceń Gemini informacji o Twoich ulubionych rzeczach.

Utwórz katalog do przechowywania umiejętności:
```
mkdir -p ~/.gemini/skills/my-favorite-things
```
Utwórz i otwórz nowy plik SKILL.md dla swojej umiejętności:
```
cloudshell edit ~/.gemini/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: 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.

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

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

Po utworzeniu umiejętności możesz używać jej w interfejsie wiersza poleceń Gemini. Umiejętności umieszczone w ~/.gemini/skills są automatycznie wykrywane przez interfejs wiersza poleceń Gemini.

Uruchamianie interfejsu wiersza poleceń Gemini w Cloud Shell
```
gemini
```
Aby zaakceptować niektóre ustawienia domyślne, może być konieczne naciśnięcie Enter.
Poproś Gemini o wyświetlenie umiejętności dostępnych w danym kontekście.
```
/skills
```
Na liście dostępnych umiejętności powinna pojawić się pozycja my-favorite-things.
Zapytaj Gemini o ulubiony kolor:
```
What is my favorite color?
```
Interfejs wiersza poleceń Gemini powinien używać umiejętności my-favorite-things, aby odpowiedzieć na Twoje pytanie. Jeśli pojawi się odpowiedni komunikat, zezwól interfejsowi wiersza poleceń Gemini na korzystanie z umiejętności.

Dane wyjściowe powinny wskazywać, że interfejs wiersza poleceń Gemini użył Twojej umiejętności i odpowiedział „Niebieski”.

Udało Ci się! Udało Ci się utworzyć umiejętność i przetestować ją za pomocą interfejsu wiersza poleceń Gemini.

Gdy chcesz zakończyć sesję, wpisz /quit, a potem naciśnij Enter, aby zamknąć interfejs wiersza poleceń Gemini.

6. Instalowanie funkcji Agent Skills w Firebase

Oprócz tworzenia własnych umiejętności możesz instalować umiejętności utworzone przez inne osoby. Umiejętności agenta w Firebase (GitHub) to przenośne, samodzielne moduły zawierające wiedzę, instrukcje i przepływy pracy dotyczące Firebase. 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 niższym kosztem tokenów.

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

npx skills add firebase/agent-skills

To polecenie pobierze i zainstaluje umiejętności, w tym firebase-basics, firebase-auth-basics, firebase-firestore-basics i firebase-app-hosting-basics, dzięki czemu będą one dostępne do użycia w interfejsie wiersza poleceń Gemini wraz z umiejętnością my-favorite-things.

Więcej informacji o umiejętnościach agenta w Firebase znajdziesz w sekcji Dostępne umiejętności.

7. Poznaj umiejętności agenta w Firebase

Narzędzia Agent Skills for Firebase zostały zainstalowane i są gotowe do użycia w interfejsie Gemini CLI. Możesz je wyświetlić, uruchamiając interfejs wiersza poleceń Gemini i wpisując /skills firebase:

gemini

Następnie w interfejsie wiersza poleceń Gemini:

/skills firebase

Zobaczysz listę zainstalowanych umiejętności Firebase, takich jak firebase-basics, firebase-auth-basics, firebase-firestore-basics i firebase-app-hosting-basics.

8. (Opcjonalnie) Tworzenie i wdrażanie aplikacji za pomocą funkcji Agent Skills for Firebase

Teraz użyj zainstalowanych umiejętności agenta w Firebase, aby utworzyć aplikację internetową „Lista zadań” z uwierzytelnianiem użytkowników i bazą danych, a następnie wdrożyć ją w usłudze Firebase App Hosting.

Jeśli nadal korzystasz z interfejsu wiersza poleceń Gemini, wpisz /quit, 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. Jeśli korzystasz z Cloud Shell lub innego środowiska bez przeglądarki, użyj flagi --no-localhost.
```
firebase login --no-localhost
```
Postępuj zgodnie z instrukcjami, aby autoryzować wiersz poleceń Firebase.
Uruchom interfejs wiersza poleceń Gemini:
```
gemini
```

Teraz poproś Gemini o wygenerowanie kodu aplikacji:

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 może poprosić o utworzenie plików takich jak index.html, style.css i script.js. Zezwól na to.

Na koniec wdróż aplikację w Firebase App Hosting:
```
/firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
```
Postępuj zgodnie z instrukcjami, aby skonfigurować hosting aplikacji i dokończyć wdrażanie. Po wdrożeniu powinna zostać wyświetlona aplikacja na żywo.

9. Podsumowanie

Gratulacje! Umiejętność została utworzona. Wiesz już, jak instalować dodatkowe umiejętności w interfejsie wiersza poleceń Gemini.

(Opcjonalnie) Czyszczenie

Jeśli chcesz wyczyścić projekt, możesz go usunąć, aby uniknąć dodatkowych opłat.

Jeśli chcesz, usuń projekt:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Możesz też usunąć niepotrzebne zasoby z dysku Cloud Shell. Możesz:

Usuń katalog umiejętności:

rm -rf ~/.gemini/skills/my-favorite-things

Ostrzeżenie! Tej czynności nie można cofnąć. Jeśli chcesz usunąć wszystko z Cloud Shell, aby zwolnić miejsce, możesz usunąć cały katalog domowy. Upewnij się, że wszystko, co chcesz zachować, jest zapisane w innym miejscu.
```
sudo rm -rf $HOME
```