Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Cómo usar las habilidades de los agentes de IA (con la CLI de Antigravity y Agent Skills para Firebase)

1. Introducción

Foto de portada del lab de Agent Skills

En este lab, aprenderás a crear habilidades de agentes para proporcionar a los agentes de IA acceso a conocimientos y flujos de trabajo personalizados. La crearás como una habilidad local a la que se puede acceder desde CLI de Antigravity.

Actividades

Crea tus propias Agent Skills para tus actividades favoritas.
Usa la CLI de Antigravity para consultar tu habilidad.
Instala las habilidades de agentes oficiales para Firebase y úsalas para compilar e implementar una app.

Qué aprenderás

Cómo estructurar una habilidad
Cómo escribir un archivo SKILL.md
Cómo usar habilidades locales con la CLI de Antigravity

2. Configuración del proyecto

Si aún no tienes una Cuenta de Google, debes crear una.
- Usa una cuenta personal en lugar de una cuenta laboral o educativa. Es posible que las cuentas laborales y educativas tengan restricciones que te impidan habilitar las APIs necesarias para este lab.
Accede a la consola de Google Cloud.
Habilita la facturación en la consola de Cloud.
- Completar este lab debería costar menos de USD 1 en recursos de Cloud.
- Puedes seguir los pasos que se indican al final de este lab para borrar los recursos y evitar cargos adicionales.
- Los usuarios nuevos pueden acceder a la prueba gratuita de USD 300.
Crea un proyecto nuevo o elige reutilizar uno existente.
- Si ves un error sobre la cuota del proyecto, reutiliza un proyecto existente o bórralo para crear uno nuevo.

3. Abre el editor de Cloud Shell

Haz clic en este vínculo para navegar directamente al editor de Cloud Shell.
Si se te solicita autorización en algún momento, haz clic en Autorizar para continuar.
Si la terminal no aparece en la parte inferior de la pantalla, ábrela:
- Haz clic en Ver.
- Haz clic en Terminal.
En la terminal, configura tu proyecto con este comando:
- Formato:
```
gcloud config set project [PROJECT_ID]
```
- Ejemplo:
```
gcloud config set project lab-project-id-example
```
- Si no recuerdas el ID de tu proyecto, haz lo siguiente:
  - Puedes enumerar todos los IDs de tus proyectos con el siguiente comando:
```
gcloud projects list | awk '/PROJECT_ID/{print $2}'
```
Deberías ver el siguiente mensaje:
```
Updated property [core/project].
```
Si ves un WARNING y se te pregunta Do you want to continue (Y/n)?, es probable que hayas ingresado el ID del proyecto de forma incorrecta. Presiona n, presiona Enter y vuelve a intentar ejecutar el comando gcloud config set project.

4. Crea tu habilidad personalizada

Las habilidades del agente son directorios que contienen, como mínimo, un archivo SKILL.md que proporciona instrucciones y conocimiento a un agente de IA. En esta sección, crearás una habilidad que le enseñará a la CLI de Antigravity sobre tus cosas favoritas.

Crea un directorio para este lab y navega a él:

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

Crea un directorio para la skill de tu proyecto:

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

Crea y abre un nuevo archivo SKILL.md para tu skill:
```
cloudshell edit ~/agent-skills-lab/.agents/skills/my-favorite-things/SKILL.md
```
El comando cloudshell edit abrirá el archivo SKILL.md en el editor que se encuentra sobre la terminal.

Agrega el siguiente contenido al archivo 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 solo un archivo SKILL.md, creaste tu primera habilidad. Es hora de usar esta habilidad en la CLI de Antigravity.

5. Usa tu habilidad desde la CLI de Antigravity

Ahora que creaste correctamente una habilidad, la CLI de Antigravity ya la puede detectar porque se encuentra en el directorio .agents/skills.

Inicia la CLI de Antigravity:
```
agy
```

Autentica con la CLI de Antigravity: Durante el inicio inicial, se requiere autenticación. Selecciona OAuth (presiona Enter).
Haz clic en el vínculo (si no se puede hacer clic, destaca la URL en Cloud Shell para copiarla y, luego, pégala en tu navegador).
Accede a tu Cuenta de Google
Copia el código
Pega el código en la terminal del editor de Cloud Shell.
Presiona Enter.
Presiona Enter para aceptar algunos parámetros de configuración predeterminados.
Haz que la CLI de Antigravity muestre las habilidades disponibles en su contexto.
```
/skills
```
Deberías ver my-favorite-things en la lista de habilidades disponibles.
Presiona ESC para salir de la vista de habilidades
Pregúntale a la CLI de Antigravity sobre tu color favorito:
```
What is my favorite color?
```
La CLI de Antigravity debería usar la habilidad my-favorite-things para responder tu pregunta. Si se te solicita, permite que la CLI de Antigravity use la skill.

El resultado debería mostrar que la CLI de Antigravity usó tu habilidad y respondió con algo como "Azul" o "Mi color favorito es el azul".

¡Lo lograste! Creaste correctamente una habilidad y la probaste con la CLI de Antigravity.

Cuando quieras finalizar tu sesión, escribe /exit y, luego, presiona Enter para salir de la CLI de Antigravity.

6. (Opcional) Compila e implementa una aplicación en Firebase Hosting

Además de crear tus propias habilidades, puedes instalar las que crearon otras personas. Esto demuestra el uso de habilidades portátiles, que son módulos autónomos de conocimiento, instrucciones y flujos de trabajo que se pueden compartir y reutilizar fácilmente.

Las Agent Skills para Firebase son un excelente ejemplo de estos módulos portátiles. Están diseñadas para ayudar a los asistentes de IA a comprender las prácticas recomendadas de Firebase y ejecutar tareas complejas con mayor precisión y un menor costo de tokens.

Ahora usa las habilidades de agentes de Firebase para crear una aplicación web de "tareas pendientes" con autenticación de usuarios y una base de datos, y, luego, impleméntala en Firebase Hosting.

Configura tu proyecto

Si aún estás en la CLI de Antigravity, escribe /exit para salir.
Crea un directorio nuevo para tu proyecto y navega hasta él:
```
mkdir ~/todo-app && cd ~/todo-app
```
Accede a Firebase con tu Cuenta de Google. Usa la marca --no-localhost, ya que estás en Cloud Shell:
```
firebase login --no-localhost
```
1. Interactúa con las indicaciones de la CLI:
  - Cuando se te pregunte Enable Gemini in Firebase features?, escribe Y (para Sí) y presiona Enter.
  - Cuando se te pregunte Allow Firebase to collect CLI and Emulator Suite usage and error reporting information?, escribe Y (para Sí) y presiona Enter.
2. Autoriza en el navegador:
  - Verás una URL en la terminal. Haz clic en el vínculo (si no se puede hacer clic, destaca la URL en Cloud Shell para copiarla y, luego, pégala en tu navegador) para abrir la página de acceso en una nueva pestaña del navegador.
  - Paso 1 de 3 (confirmar el comando): Haz clic en Yes, I just ran this command.
  - Paso 2 de 3 (Confirmar ID de sesión): Asegúrate de que el ID de sesión coincida con el que se muestra en tu terminal y, luego, haz clic en Yes, this is my session ID.
  - Paso 3 de 3 (Copiar código): Haz clic en Copiar para copiar el código de autorización en el portapapeles.
3. Completa el acceso:
  - Vuelve a la terminal de Cloud Shell y pega el código de autorización en el símbolo del sistema ? Enter authorization code:.
  - Presiona Enter.
Deberías ver un mensaje de éxito: ✔ Success! Logged in as .

Instala Agent Skills para Firebase

Ahora que creaste el directorio del proyecto, debes instalar las habilidades de agentes para Firebase en él.

Puedes instalar las Agent Skills para Firebase con skills CLI en tu terminal:

npx skills add firebase/agent-skills

Durante la instalación, se te pedirá que selecciones las habilidades que deseas instalar. Usa las teclas de flecha para navegar por la lista y la barra espaciadora para seleccionar estas habilidades.

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

Seleccionar cinco habilidades de Firebase

Para los mensajes posteriores, puedes aceptar los valores predeterminados de forma segura presionando Enter.

Este comando descargará e instalará habilidades, incluidas firebase-basics y firebase-hosting-basics, lo que hará que estén disponibles para su uso en la CLI de Antigravity junto con tu habilidad my-favorite-things.

Para obtener más información sobre las habilidades de agentes de Firebase, consulta las habilidades disponibles.

Crea e implementa una app web básica

Habilita las APIs obligatorias para tu proyecto:

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

Habilita Firebase en tu proyecto actual de Google Cloud:

firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}

Inicia la CLI de Antigravity:
```
agy
```
Pídele a la CLI de Antigravity que genere un index.html básico:
```
Generate an index.html file with the content "Hello Firebase Hosting" and
deploy the application to Firebase Hosting using the current Google Cloud
Project.
```
La CLI de Antigravity solicitará permisos a medida que genere y, luego, implemente la aplicación. Presiona Enter para permitirlo. Es posible que debas escribir "approve" y presionar Enter.La CLI de Antigravity debería usar las Agent Skills para Firebase para crear e implementar tu sitio web. Guía al agente junto con las aprobaciones según sea necesario.

Cuando finalice la implementación, se debería proporcionar una URL para tu app web. Usa ctrl+click (Windows/Linux) o cmd+click (Mac) para abrir vínculos en la terminal del Editor de Cloud Shell. Visita la URL de tu app implementada.

Agrega Firebase Authentication

Inicia la CLI de Antigravity si aún no lo hiciste:
```
agy
```
Es posible que la CLI de Antigravity haga preguntas como "¿Confías en esta carpeta?". Presiona Enter para aceptar los valores predeterminados.
Ahora, pídele a la CLI de Antigravity que agregue el acceso 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.
```
Es posible que la CLI de Antigravity solicite crear o actualizar archivos como index.html, style.css y script.js. Permite que lo haga. Es posible que la CLI de Antigravity te pida que realices algunas acciones en Firebase console. La CLI puede realizar la mayoría de estas acciones si se lo pides, pero es posible que debas completar los pasos de forma manual (como habilitar Google OAuth) si tu instancia de Cloud Shell tiene instalada una versión anterior de Firebase CLI.

Para ver los cambios más recientes, es posible que debas realizar una "actualización forzada" con ctrl+shift+R (Windows/Linux) o cmd+shift+R (Mac).

Agrega Cloud Firestore

Inicia la CLI de Antigravity si aún no lo hiciste:
```
agy
```
Es posible que la CLI de Antigravity haga preguntas como "¿Confías en esta carpeta?". Presiona Enter para aceptar los valores predeterminados.

Pídele a la CLI de Antigravity que agregue Firestore para guardar tareas:

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.

La CLI de Antigravity actualizará los archivos. Permite que lo haga.

Para ver los cambios más recientes, es posible que debas realizar una "actualización forzada" con ctrl+shift+R (Windows/Linux) o cmd+shift+R (Mac).

Si tu aplicación no funciona como esperabas, sigue trabajando con la CLI de Antigravity para obtener la funcionalidad que esperas. Ejemplo: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

Sigue experimentando con el lab para agregar las funciones que te gustaría ver en tu nueva aplicación de Firebase.

7. Conclusión

¡Felicitaciones! Creaste correctamente una habilidad y aprendiste a instalar habilidades adicionales para la CLI de Antigravity.

(Opcional) Limpieza

Si deseas liberar espacio, puedes borrar tu proyecto de Cloud para evitar que se generen cargos adicionales.

Si quieres, borra el proyecto:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

También puedes borrar los recursos innecesarios de tu disco de Cloud Shell para liberar espacio.

Borra el directorio del lab (esto quita la skill y la app):
```
rm -rf ~/agent-skills-lab
```
Borra el directorio de la aplicación "To Do" (si lo creaste fuera):
```
rm -rf ~/todo-app
```

Si alguna vez necesitas restablecer Cloud Shell a su estado predeterminado, puedes seguir la documentación oficial para obtener instrucciones sobre cómo hacerlo de forma segura.