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

Come utilizzare le skill dell'agente AI (con Antigravity CLI e le skill dell'agente per Firebase)

1. Introduzione

Foto di copertina del lab Agent Skills

In questo lab imparerai a creare le skill dell'agente per fornire agli agenti AI l'accesso a conoscenze e flussi di lavoro personalizzati. Le creerai come skill locale a cui è possibile accedere da Antigravity CLI.

In questo lab proverai a:

Creare le tue skill dell'agente per le tue cose preferite.
Utilizzare Antigravity CLI per eseguire query sulla skill.
Installare le skill dell'agente ufficiali per Firebase e utilizzarle per creare ed eseguire il deployment di un'app.

Obiettivi didattici

Come strutturare una skill.
Come scrivere un file SKILL.md.
Come utilizzare le skill locali con Antigravity CLI.

2. Configurazione del progetto

Se non hai già 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 di abilitare le API necessarie per questo lab.
Accedi a Google Cloud Console.
Abilita la fatturazione nella console Cloud.
- Il completamento di questo lab dovrebbe costare meno di 1 $in risorse cloud.
- Puoi seguire i passaggi alla fine di questo lab per eliminare le risorse ed evitare ulteriori addebiti.
- I nuovi utenti possono usufruire della 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 accedere direttamente all'editor di Cloud Shell
Se ti viene chiesto di autorizzare in qualsiasi momento, 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 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 personalizzata

Le skill dell'agente sono directory che contengono almeno un file SKILL.md che fornisce istruzioni e conoscenze a un agente AI. In questa sezione creerai una skill che insegna ad Antigravity CLI le tue cose preferite.

Crea una directory per questo lab e accedi alla directory:
```
mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
```

Crea una directory per la skill del progetto:

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

Crea e apri un nuovo file SKILL.md per la skill:
```
cloudshell edit ~/agent-skills-lab/.agents/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: 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.

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

5. Utilizza la skill da Antigravity CLI

Ora che hai creato correttamente una skill, è già rilevabile da Antigravity CLI perché si trova nella directory .agents/skills.

Avvia Antigravity CLI:
```
agy
```

Esegui l'autenticazione con Antigravity CLI: durante l'avvio iniziale, è richiesta l'autenticazione. Seleziona OAuth (premendo Enter).
Fai clic sul link (se non è selezionabile, evidenzia l'URL in Cloud Shell per copiarlo, quindi incollalo nel browser)
Accedi al tuo Account Google
Copiare il codice
Incolla il codice nel terminale dell'editor di Cloud Shell
Premi Enter.
Premi Enter per accettare alcune impostazioni predefinite.
Fai in modo che Antigravity CLI elenchi le skill disponibili nel suo contesto
```
/skills
```
Dovresti vedere my-favorite-things nell'elenco delle skill disponibili.
Premi ESC per uscire dalla visualizzazione delle skill
Chiedi ad Antigravity CLI il tuo colore preferito:
```
What is my favorite color?
```
Antigravity CLI dovrebbe utilizzare la skill my-favorite-things per rispondere alla tua domanda. Se richiesto, consenti ad Antigravity CLI di utilizzare la skill.

L'output dovrebbe mostrare che Antigravity CLI ha utilizzato la tua skill e ha risposto con qualcosa del tipo "Blue" o "My favorite color is blue".

Ce l'hai fatta. Hai creato e testato correttamente una skill utilizzando Antigravity CLI.

Quando è tutto pronto per terminare la sessione, digita /exit e premi Enter per uscire da Antigravity CLI.

6. (Facoltativo) Crea ed esegui il deployment di un'applicazione in Firebase Hosting

Oltre a creare le tue skill, puoi installare quelle create da altri utenti. Questo dimostra l'utilizzo delle skill portatili, ovvero moduli autonomi di conoscenze, istruzioni e flussi di lavoro che possono essere facilmente condivisi e riutilizzati.

Le skill dell'agente per Firebase sono un ottimo esempio di questi moduli portatili. Sono progettate per aiutare gli assistenti AI a comprendere le best practice di Firebase ed eseguire attività complesse con maggiore accuratezza e costi dei token inferiori.

Ora utilizza le skill dell'agente per Firebase per creare un'applicazione web "To Do", con autenticazione utente e un database, ed eseguirne il deployment in Firebase Hosting.

Configura il progetto

Se sei ancora in Antigravity CLI, digita /exit per uscire.
Crea una nuova directory per il progetto e accedi alla directory:
```
mkdir ~/todo-app && cd ~/todo-app
```
Accedi a Firebase utilizzando il tuo Account Google. Utilizza il flag --no-localhost poiché ti trovi in Cloud Shell:
```
firebase login --no-localhost
```
1. Interagisci con le richieste dell'interfaccia a riga di comando:
  - Quando ti viene chiesto Enable Gemini in Firebase features?, digita Y (per Sì) e premi Enter.
  - Quando ti viene chiesto Allow Firebase to collect CLI and Emulator Suite usage and error reporting information?, digita Y (per Sì) e premi Enter.
2. Autorizza nel browser:
  - Nel terminale vedrai un URL. Fai clic sul link (se non è selezionabile, evidenzia l'URL in Cloud Shell per copiarlo, quindi incollalo nel browser) per aprire la pagina di accesso in una nuova scheda del browser.
  - Passaggio 1 di 3 (Conferma comando): fai clic su Sì, ho appena eseguito questo comando.
  - Passaggio 2 di 3 (Conferma ID sessione): assicurati che l'ID sessione corrisponda a quello visualizzato nel terminale, quindi fai clic su Sì, questo è il mio ID sessione.
  - Passaggio 3 di 3 (Copia codice): fai clic su Copia per copiare il codice di autorizzazione negli appunti.
3. Completa l'accesso:
  - Torna al terminale Cloud Shell e incolla il codice di autorizzazione al prompt ? Enter authorization code:.
  - Premi Enter.
Dovresti visualizzare un messaggio di operazione riuscita: ✔ Success! Logged in as .

Installa le skill dell'agente per Firebase

Ora che hai creato la directory del progetto, devi installare le skill dell'agente per Firebase al suo interno.

Puoi installare le skill dell'agente per Firebase con l'interfaccia a riga di comando delle skill nel terminale:

npx skills add firebase/agent-skills

Durante l'installazione, ti verrà chiesto di selezionare le skill da installare. Utilizza i tasti freccia per spostarti nell'elenco e la barra spaziatrice per selezionare queste skill.

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

Selezione di cinque competenze Firebase

Per le richieste successive, puoi accettare in sicurezza le impostazioni predefinite premendo Enter.

Questo comando scaricherà e installerà le skill, tra cui firebase-basics e firebase-hosting-basics, rendendole disponibili per l'utilizzo in Antigravity CLI insieme alla skill my-favorite-things.

Per saperne di più sulle skill dell'agente per Firebase, consulta le skill disponibili.

Crea ed esegui il deployment di un'app web di base

Abilita le API richieste per il progetto:

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

Abilita Firebase nel progetto cloud Google corrente:

firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}

Avvia Antigravity CLI:
```
agy
```
Chiedi ad Antigravity CLI di generare un file index.html di base:
```
Generate an index.html file with the content "Hello Firebase Hosting" and
deploy the application to Firebase Hosting using the current Google Cloud
Project.
```
Antigravity CLI chiederà le autorizzazioni durante la generazione e il deployment dell'applicazione. Premi Enter per consentire l'operazione. Potresti dover digitare "approve" e premere Enter.Antigravity CLI dovrebbe utilizzare le skill dell'agente per Firebase per creare ed eseguire il deployment del tuo sito web. Guida l'agente con le approvazioni, se necessario.

Al termine del deployment, dovrebbe fornire un URL per l'app web. Utilizza ctrl+click (Windows/Linux) o cmd+click (Mac) per aprire i link nel terminale dell'editor di Cloud Shell. Visita l'URL dell'app di cui hai eseguito il deployment.

Aggiungi Firebase Authentication

Avvia Antigravity CLI se non è già stato avviato:
```
agy
```
Antigravity CLI potrebbe porre domande come "Do you trust this folder?" Premi Enter per accettare le impostazioni predefinite.
Ora, chiedi ad Antigravity CLI di aggiungere l'accesso con 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.
```
Antigravity CLI potrebbe chiedere di creare o aggiornare file come index.html, style.css e script.js. Consenti l'operazione. Antigravity CLI potrebbe chiederti di eseguire alcune azioni nella console Firebase. L'interfaccia a riga di comando di Firebase è in grado di eseguire la maggior parte di queste operazioni se le chiedi di provare, ma potrebbe essere necessario completare i passaggi manualmente (ad esempio abilitare Google OAuth) se nella tua istanza di Cloud Shell è installata una versione precedente di Firebase CLI.

Per visualizzare le modifiche più recenti, potrebbe essere necessario eseguire un "aggiornamento forzato" con ctrl+shift+R (Windows/Linux) o cmd+shift+R (Mac).

Aggiungi Cloud Firestore

Avvia Antigravity CLI se non è già stato avviato:
```
agy
```
Antigravity CLI potrebbe porre domande come "Do you trust this folder?" Premi Enter per accettare le impostazioni predefinite.

Chiedi ad Antigravity CLI di aggiungere Firestore per salvare le attività:

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 aggiornerà i file. Consenti l'operazione.

Per visualizzare le modifiche più recenti, potrebbe essere necessario eseguire un "aggiornamento forzato" con ctrl+shift+R (Windows/Linux) o cmd+shift+R (Mac).

Se l'applicazione non funziona come previsto, continua a utilizzare Antigravity CLI per ottenere la funzionalità che ti aspetti. Esempio: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

Continua a sperimentare con il lab per aggiungere le funzionalità che ti piacerebbe vedere nella tua nuova applicazione Firebase.

7. Conclusione

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

(Facoltativo) Libera spazio

Se vuoi liberare spazio, puoi eliminare il progetto Cloud per evitare addebiti aggiuntivi.

Se vuoi, elimina il progetto:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Puoi anche eliminare le risorse non necessarie dal disco di Cloud Shell per liberare spazio.

Elimina la directory del lab (in questo modo vengono rimosse sia la skill sia l'app):
```
rm -rf ~/agent-skills-lab
```
Elimina la directory dell'applicazione "To Do" (se l'hai creata all'esterno):
```
rm -rf ~/todo-app
```

Se hai bisogno di ripristinare lo stato predefinito di Cloud Shell, puoi seguire la documentazione ufficiale per istruzioni su come farlo in sicurezza.