Desarrolla apps de pila completa en Google AI Studio

Google AI Studio ahora admite el desarrollo de pila completa, lo que te permite compilar aplicaciones que van más allá de los prototipos del cliente. Con un entorno de ejecución del servidor, puedes administrar secretos, conectarte a APIs externas y compilar experiencias multijugador en tiempo real.

Entorno de ejecución del servidor

Las aplicaciones de Google AI Studio ahora pueden incluir un componente del servidor (Node.js). Esto te permite hacer lo siguiente:

  • Ejecuta la lógica del servidor: Ejecuta código que no se deba exponer al cliente.
  • Acceder a paquetes de npm: El agente de Antigravity puede instalar y usar paquetes del vasto ecosistema de npm.
  • Administra secretos: Usa claves de API y credenciales de forma segura.

Usa paquetes de npm

No es necesario que ejecutes npm install de forma manual. Solo pídele al agente que agregue la funcionalidad que requiere un paquete, y este se encargará de la instalación y la importación.

Ejemplo: > "Usa axios para recuperar datos de la API externa".

Administra secretos de forma segura

Con el código del servidor y la administración de secretos, ahora puedes compilar apps que interactúen con el mundo.

Clave de API de Gemini

Cuando creas una app nueva que usa la API de Gemini, AI Studio configura automáticamente tu GEMINI_API_KEY como un secreto del servidor, sin necesidad de realizar una configuración manual. Puedes ver esta clave en el panel Secrets de Configuración. Las llamadas a la API de Gemini de tu app se realizan desde el código del servidor con esta clave, por lo que nunca se expone en el navegador.

Claves de API de terceros

Para otros servicios, puedes agregar claves de API de forma manual:

  • APIs de terceros: Conéctate a servicios como Stripe, SendGrid o APIs de REST personalizadas.
  • Bases de datos: Conéctate a bases de datos externas (p.ej., a través de Supabase, Firebase o MongoDB Atlas) para conservar los datos más allá de la sesión.

Cuando creas apps para el mundo real, a menudo necesitas conectarte a servicios de terceros (como Twilio, Slack o bases de datos) que requieren claves de API. Puedes agregar claves manualmente con los siguientes pasos:

  1. Agrega un secreto: Ve al menú Configuración en Google AI Studio y busca la sección Secretos.
  2. Almacena tu clave: Agrega tus claves de API o tokens secretos aquí.
  3. Acceso en el código: El agente puede escribir código del servidor que acceda a estos secrets de forma segura (por lo general, a través de variables de entorno), lo que garantiza que nunca se expongan al navegador del cliente.

Cuando sea necesario, el agente también mostrará una tarjeta en el chat para que agregues claves cada vez que se necesite un secreto nuevo o cuando se detecte una clave nueva en las variables de entorno del proyecto.

Integración de Firebase para la base de datos y la autenticación

Ahora, Google AI Studio facilita agregar una base de datos o autenticación a tu app a través de una integración de Firebase. El agente de Antigravity puede aprovisionar y configurar los siguientes servicios por ti automáticamente:

  • Base de datos de Firestore: Es una base de datos NoSQL flexible, escalable y en la nube para almacenar y sincronizar datos para el desarrollo en el cliente y el servidor.
  • Firebase Authentication: Permite que los usuarios accedan de forma segura a tu aplicación con los flujos de "Acceder con Google".

Solo pídele al agente que "agregue una base de datos a mi app" o "configure Acceder con Google", y se encargará de la configuración y la generación de código necesarias por ti. Cuando compilas apps para Android, la integración de Firebase también aprovisiona Firebase AI Logic y la Verificación de aplicaciones de Firebase para realizar llamadas a la API de Gemini seguras del cliente.

Firebase te permite comenzar de forma gratuita y, de manera opcional, escalar con una cuenta pagada cuando necesites más cuota o quieras usar funciones pagadas.

APIs de Google Workspace

Google AI Studio te permite compilar apps que se conectan a las APIs de Google Workspace, de modo que tus usuarios puedan trabajar con sus datos reales: correos electrónicos, hojas de cálculo, documentos, eventos de calendario y mucho más, todo dentro de tu app. Ya no necesitas configurar un proyecto de Google Cloud, configurar OAuth ni administrar tu API de forma manual.

Cómo funciona

Puedes agregar una integración de Workspace de dos maneras:

  • Descríbelo en el panel de chat: Solo dile al agente lo que quieres en el panel de chat que se encuentra en la parte inferior. Por ejemplo, "Crea un sistema de seguimiento de gastos que registre los recibos en mi hoja de cálculo de Google" o "Crea un panel que resuma mis mensajes de Gmail no leídos".
  • Selecciona desde el panel de integraciones: Abre el panel Integraciones en la barra lateral derecha del modo de compilación y habilita la app de Workspace que quieras conectar.

Cuando agregas una app de Workspace, AI Studio hace lo siguiente de forma automática:

  1. Conecta la API de Google necesaria para tu app.
  2. Genera el código del servidor para llamar a la API.
  3. Agrega un flujo seguro de "Acceder con Google" para que los usuarios finales de tu app puedan autorizar el acceso a sus propios datos.

Apps compatibles

Están disponibles las siguientes apps de Google Workspace:

Aplicación Qué puedes compilar
Calendario de Google Leer, crear y administrar eventos y calendarios
Google Chat Leer las conversaciones y los espacios grupales, y participar en ellos
Documentos de Google Crear, leer, actualizar y dar formato a documentos
Google Drive Organiza, busca y administra archivos y carpetas
Formularios de Google Crea encuestas, actualiza preguntas y recupera respuestas
Gmail Leer, enviar y administrar contenido de correo electrónico
Google Keep Cómo administrar notas, listas y archivos adjuntos
Google Meet Programa y administra videollamadas
Contactos Cómo sincronizar y administrar contactos
Hojas de cálculo de Google Lee, escribe y aplica formato a los datos de las hojas de cálculo
Presentaciones de Google Crear y modificar presentaciones
Google Tasks Crea, administra y organiza tareas

Autenticación y permisos

Como creador, no necesitas configurar clientes de OAuth, administrar credenciales ni configurar un proyecto de Google Cloud. AI Studio se encarga de todo esto por ti.

Las apps con APIs de Workspace integradas usan "Acceder con Google" para autenticar a los usuarios finales. Cuando un usuario abre tu app, se le solicita que acceda y otorgue los permisos específicos que necesita la app (por ejemplo, acceso de solo lectura a su calendario o la capacidad de editar una hoja de cálculo). Tu app solo accede a los datos de la persona que la usa. Cada usuario autoriza el acceso a su propia cuenta.

Ejemplos de instrucciones

Estas son algunas ideas para comenzar a usar las integraciones de Workspace:

  • "Crea una app que lea mi Calendario de Google y redacte correos electrónicos de preparación en Gmail para cada reunión".
  • "Crea una herramienta que tome un documento de Google y genere una presentación de resumen de 5 diapositivas en Presentaciones de Google".
  • "Crea un sistema de seguimiento de gastos en el que suba un recibo, Gemini extraiga los detalles y registre una nueva fila en mi hoja de cálculo de Google".

Configura OAuth

Un caso de uso clave para Secret Manager es configurar OAuth para conectarse a otros sitios web o apps. Cuando tu instrucción incluya instrucciones para conectarse a una app de terceros que requiera autenticación de OAuth, el agente proporcionará instrucciones para configurar OAuth para esa aplicación. Estas instrucciones incluirán las URLs de devolución de llamada necesarias para configurar tu aplicación de OAuth. También puedes encontrar las URLs de devolución de llamada en Integraciones, en el panel Configuración.

Crea experiencias multijugador

El entorno de ejecución de pila completa habilita las funciones de colaboración en tiempo real.

  • Estado en tiempo real: Puedes pedirle al agente que cree funciones como "un chat en vivo", "una pizarra colaborativa" o "un juego multijugador".
  • Sesiones sincronizadas: El servidor administra el estado, lo que permite que varios usuarios interactúen con la misma instancia de la aplicación en tiempo real.

Instrucción de ejemplo: > "Haz que este sea un juego multijugador en el que los jugadores puedan ver los cursores de los demás".

Sugerencias para probar apps multijugador

Puedes probar el modo multijugador de dos maneras antes de implementar tu app.

  1. Abre tu app en el modo de compilación de Google AI Studio en varias pestañas. Cuando desarrollas en el modo de compilación, tu app se encuentra en un contenedor de desarrollo. Si abres la app en varias pestañas, podrás simular que varios jugadores usan tu app.
  2. Comparte la app con otras personas usando el menú Compartir en la parte superior derecha. Luego, usa la URL compartida de la pestaña Integraciones del menú Compartir para usar la app con los jugadores con los que la compartiste.

Prácticas recomendadas

  • Llamadas a la API de Gemini: Tu GEMINI_API_KEY se configura automáticamente como un secreto del servidor. Realiza llamadas a la API de Gemini desde tu código del servidor con esta clave. Puedes verlo en el panel Secrets.
  • Seguridad de los Secrets: Usa siempre el administrador de Secrets para las claves sensibles. Nunca los codifiques en tus archivos.
  • Separación de problemas: Mantén la lógica de la IU en el framework del cliente (React/Angular) y la lógica empresarial o el manejo de datos en el servidor.
  • Manejo de errores: Asegúrate de que tu código del servidor controle de forma sólida los errores de las llamadas a la API externas para evitar que la app falle.

¿Qué sigue?