Come creare competenze dell'agente per Gemini CLI

1. Introduzione

In questo lab imparerai a creare Agent Skills per fornire ai LLM l'accesso a conoscenze e flussi di lavoro personalizzati. Lo creerai come skill locale a cui è possibile accedere dalla CLI di Gemini.

In questo lab proverai a:

Crea le tue competenze dell'agente per le tue cose preferite.
Utilizza Gemini CLI per eseguire query sulla tua skill.
Installa le competenze degli agenti ufficiali per Firebase e usale per creare e implementare un'app.

Obiettivi didattici

Come strutturare un'abilità.
Come scrivere un file SKILL.md.
Come utilizzare le skill locali con Gemini CLI.

2. Configurazione del progetto

Se non hai ancora un Account Google, devi crearne uno.
- Utilizza un account personale anziché un account di lavoro o della scuola. Gli account di lavoro e della scuola potrebbero avere limitazioni che impediscono l'attivazione delle API necessarie per questo lab.
Accedi alla console Google Cloud.
Abilita la fatturazione nella console Cloud.
- Il completamento di questo lab dovrebbe costare meno di 1 $in risorse cloud.
- Per evitare ulteriori addebiti, puoi seguire i passaggi alla fine di questo lab per eliminare le risorse.
- I nuovi utenti hanno diritto alla prova senza costi di 300$.
Crea un nuovo progetto o scegli di riutilizzarne uno esistente.
- Se visualizzi un errore relativo alla quota del progetto, riutilizza un progetto esistente o eliminalo per crearne uno nuovo.

3. Apri editor di Cloud Shell

Fai clic su questo link per andare direttamente all'editor di Cloud Shell.
Se ti viene richiesto di concedere l'autorizzazione in qualsiasi momento della giornata, fai clic su Autorizza per continuare.
Se il terminale non viene visualizzato nella parte inferiore dello schermo, aprilo:
- Fai clic su Visualizza.
- Fai clic su Terminale.

Nel terminale, imposta il tuo progetto con questo comando:

Formato:
```
gcloud config set project [PROJECT_ID]
```

Esempio:

gcloud config set project lab-project-id-example

Se non ricordi l'ID progetto:
- Puoi elencare tutti gli ID progetto con:
```
gcloud projects list | awk '/PROJECT_ID/{print $2}'
```

Dovresti visualizzare questo messaggio:
```
Updated property [core/project].
```
Se visualizzi un WARNING e ti viene chiesto Do you want to continue (Y/n)?, probabilmente hai inserito l'ID progetto in modo errato. Premi n, premi Enter e prova a eseguire di nuovo il comando gcloud config set project.

4. Crea la tua skill "Cose preferite"

Le competenze dell'agente sono directory contenenti almeno un file SKILL.md che fornisce istruzioni e conoscenze a un agente AI. In questa sezione creerai un'abilità che insegna a Gemini CLI le tue cose preferite.

Crea una directory per archiviare la tua skill:
```
mkdir -p ~/.gemini/skills/my-favorite-things
```
Crea e apri un nuovo file SKILL.md per la tua skill:
```
cloudshell edit ~/.gemini/skills/my-favorite-things/SKILL.md
```
Il comando cloudshell edit aprirà il file SKILL.md nell'editor sopra il terminale.

Aggiungi i seguenti contenuti al file SKILL.md:

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

Con un solo file SKILL.md, hai creato la tua prima skill. È il momento di utilizzare questa competenza in Gemini CLI.

5. Utilizzare la tua skill da Gemini CLI

Ora che hai creato una skill, puoi utilizzarla con la CLI di Gemini. Le skill inserite in ~/.gemini/skills vengono rilevate automaticamente da Gemini CLI.

Avviare Gemini CLI in Cloud Shell
```
gemini
```
Potresti dover premere Enter per accettare alcune impostazioni predefinite.
Chiedi a Gemini di elencare le competenze a sua disposizione nel contesto
```
/skills
```
Dovresti vedere my-favorite-things nell'elenco delle skill disponibili.
Chiedi a Gemini qual è il tuo colore preferito:
```
What is my favorite color?
```
Gemini CLI deve utilizzare la skill my-favorite-things per rispondere alla tua domanda. Se richiesto, consenti a Gemini CLI di utilizzare la skill.

L'output dovrebbe mostrare che l'interfaccia a riga di comando di Gemini ha utilizzato la tua skill e ha risposto con "Blu".

Ce l'hai fatta. Hai creato correttamente una skill e l'hai testata utilizzando Gemini CLI.

Quando è tutto pronto per terminare la sessione, digita /quit e poi premi Enter per uscire da Gemini CLI.

6. Installa Agent Skills per Firebase

Oltre a creare le tue skill, puoi installare quelle create da altri. Le competenze dell'agente per Firebase (GitHub) sono moduli portatili e autonomi di conoscenze, istruzioni e workflow specifici di Firebase. Sono progettati per aiutare gli assistenti AI a comprendere le best practice di Firebase ed eseguire attività complesse con maggiore precisione e a un costo inferiore dei token.

Puoi installare tutte le Agent Skills per Firebase con la CLI skills nel terminale:

npx skills add firebase/agent-skills

Questo comando scaricherà e installerà le competenze, tra cui firebase-basics, firebase-auth-basics, firebase-firestore-basics e firebase-app-hosting-basics, rendendole disponibili per l'uso in Gemini CLI insieme alla competenza my-favorite-things.

Per saperne di più sulle competenze dell'agente per Firebase, consulta Competenze disponibili.

7. Esplora le competenze dell'agente per Firebase

Le competenze dell'agente per Firebase sono ora installate e pronte all'uso in Gemini CLI. Puoi visualizzarli eseguendo Gemini CLI e digitando /skills firebase:

gemini

Quindi, in Gemini CLI:

/skills firebase

Vedrai un elenco di skill Firebase installate, come firebase-basics, firebase-auth-basics, firebase-firestore-basics e firebase-app-hosting-basics.

8. (Facoltativo) Utilizza le competenze dell'agente per Firebase per creare ed eseguire il deployment di un'applicazione

Ora utilizza le competenze dell'agente per Firebase installate per creare un'applicazione web "Cose da fare", con autenticazione utente e un database, ed eseguine il deployment su Firebase App Hosting.

Se ti trovi ancora in Gemini CLI, digita /quit per uscire.
Crea una nuova directory per il tuo progetto e accedi alla directory:
```
mkdir todo-app && cd todo-app
```
Accedi a Firebase utilizzando il tuo Account Google. Se ti trovi in Cloud Shell o in un altro ambiente senza browser, utilizza il flag --no-localhost.
```
firebase login --no-localhost
```
Segui le istruzioni per autorizzare l'interfaccia a riga di comando di Firebase.
Avvia Gemini CLI:
```
gemini
```

Ora chiedi a Gemini di generare il codice dell'applicazione:

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 potrebbe chiedere di creare file come index.html, style.css e script.js. Consenti di farlo.

Infine, esegui il deployment dell'applicazione in Firebase App Hosting:
```
/firebase-app-hosting-basics deploy my web app to Firebase App Hosting.
```
Segui le istruzioni per configurare App Hosting e completare il deployment. Una volta eseguito il deployment, dovresti ricevere un URL per la tua applicazione live.

9. Conclusione

Complimenti! Hai creato correttamente una skill e hai imparato a installare skill aggiuntive per Gemini CLI.

(Facoltativo) Pulizia

Se vuoi eseguire la pulizia, puoi eliminare il tuo progetto Cloud per evitare addebiti aggiuntivi.

Se vuoi, elimina il progetto:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Potresti anche voler eliminare le risorse non necessarie dal disco Cloud Shell. Puoi:

Elimina la directory delle skill:

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

Attenzione. La prossima azione non può essere annullata. Se vuoi eliminare tutti i contenuti di Cloud Shell per liberare spazio, puoi eliminare l'intera home directory. Fai attenzione che tutto ciò che vuoi conservare sia salvato altrove.
```
sudo rm -rf $HOME
```