Antigravity Agent
Antigravity Agent pone en tu flujo a Antigravity CLI (agy), el agente de programación de Google que sustituye a Gemini CLI, con tu API key de Gemini. Trabaja sobre un repositorio de Git o una carpeta vacía, en un espacio aislado solo para tu conversación: lee el código, lo cambia, ejecuta comandos y pruebas, y te devuelve su respuesta y la lista de ficheros que ha cambiado.
Funciona como un nodo normal (entra una instrucción, sale la respuesta) y como herramienta de un Agent o de un Voice Agent: así puedes pedir cambios en tu código hablando o por chat.
Cuándo usarlo
- Quieres que un agente arregle un error, añada una función pequeña, escriba pruebas o revise un cambio en un repositorio.
- Quieres programar por voz: el agente de voz le pasa lo que dices y te cuenta lo que ha hecho.
- Quieres automatizar tareas de código desde un flujo: por ejemplo, que cada incidencia nueva genere una rama con una propuesta de arreglo.
Cómo funciona
- Cada conversación (un chat del playground, una llamada, una sesión de la API) tiene su propio contenedor aislado con sus ficheros. Nadie más lo ve.
- Los mensajes siguientes de la misma conversación continúan el trabajo: el agente recuerda lo que hizo y los ficheros siguen ahí.
- El espacio de Run Instruction se apaga solo tras 15 minutos sin uso y se conserva 7 días; el siguiente mensaje lo vuelve a arrancar tal como estaba. Las operaciones List Sessions, Delete Session y Get Changes se ejecutan al vuelo (contenedor efímero destruido al instante, sin consumir límite de contenedores simultáneos).
- En el nodo colapsado solo aparece visible Instruction (a la izquierda) y Tools (abajo); el resto de campos se configuran desde el panel lateral o activando su visibilidad si necesitas cablearlos.
- La API key llega solo al proceso del agente y el token de Git solo a los comandos de Git que ejecuta la plataforma: el agente nunca ve el token.
Configuración
| Campo | Qué hace |
|---|---|
| Gemini API Key | Se rellena con la credencial Antigravity. Es tu clave: el trabajo se factura a tu cuenta del proveedor. |
| Operation (tool) | Qué hacer en el espacio de trabajo: Run Instruction (por defecto), List Sessions (devuelve las sesiones guardadas con su session_name, conversation_id, fecha y resumen), Delete Session (borra una sesión guardada sin tocar los archivos) o Get Changes (muestra los cambios pendientes sin consumir tokens). |
| Instruction | Lo que tiene que hacer, en palabras normales. Como herramienta, lo escribe el agente que la llama. |
| Agent Instructions | Reglas fijas para todas las instrucciones: convenciones del proyecto, qué evitar, cómo contestar. |
| Model | gemini-4-neon (por defecto), gemini-4-carbon, gemini-4-hydrogen, gemini-4-argon o gemini-3.8-flash; también puedes escribir otro. |
| Permissions | Qué puede hacer dentro de su espacio: Read only (leer y explicar), Edit files (cambiar ficheros) o Edit files and run commands (por defecto; necesario para lanzar pruebas). Lo que pase de ese nivel se rechaza y aparece en el resultado. |
| Repository URL | El repositorio que se clona la primera vez. Vacío, empieza en una carpeta vacía. |
| Workspace Name | Nombre único para persistir la carpeta de trabajo en tu Storage (antigravity_data/<nombre>). Vacío, no persiste (cada conversación empieza de cero). Con el mismo nombre en varios nodos o flujos de Antigravity Agent comparten archivos y sesiones. |
| Skills | Skills de tu cuenta de la plataforma (las tuyas y las instaladas del marketplace) que el agente puede usar. Pulsa refrescar para cargar la lista; se copian al agente antes de cada instrucción. |
| When Done | Commit and push a new branch sube los cambios de cada instrucción a una rama nueva nappai/gemini-<fecha>. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Branch | La rama que se clona. Vacío, la rama principal del repositorio. |
| Git Access Token | Token para un repositorio privado y para subir la rama. Solo lo usan los comandos de Git de la plataforma. |
| Keep Workspace | During the conversation (por defecto) conserva ficheros y memoria entre mensajes; Only for this run lo borra todo al acabar. |
| Session Name (tool) | Nombre lógico o conversation_id de la sesión a continuar o retomar. Vacío usa la sesión por defecto; pon nombres distintos por tarea para no mezclar contextos en un mismo espacio persistente. |
| New Session (tool) | Activado (true), arranca una conversación limpia desde cero en vez de reanudar la sesión actual. |
| Reasoning Effort | Cuánto piensa el modelo antes de actuar. Más es más lento y más caro. |
| Output Schema | Un esquema JSON opcional: el agente termina con una respuesta con esa forma, en structured del resultado. |
| Time Limit (s) | Si una instrucción tarda más, se detiene. Por defecto, 600. |
| API Base URL | Solo para una pasarela compatible propia. Vacío, la dirección oficial del proveedor. |
Resultado
- Response: en Run Instruction, la respuesta final del agente; en List Sessions, Delete Session y Get Changes, un JSON válido listo para automatizaciones (
{"sessions": [...], "count": N},{"changed_files": [...], "diff_summary": "...", "count": N}o{"deleted": true, "session_name": "..."}). - Result: objeto
Dataestructurado. En Run Instruction incluyechanged_files,diff_summary,branch,denied_actions,steps,conversation_id,session_name,structured,usageycost_usd; en List Sessions, Delete Session y Get Changes incluye los mismos datos estructurados enstructuredy en el nivel raíz (sessions,changed_files,deleted,count). Es lo que recibe un agente cuando lo usa como herramienta.
Ejemplo
Programar por voz sobre un repositorio:
- Añade un Voice Agent y un Antigravity Agent con tu credencial Google Gemini.
- En Repository URL pon tu repositorio y, si es privado, el Git Access Token.
- Activa el modo herramienta del nodo y conéctalo a Tools del Voice Agent.
- Llama y di «arregla el test que falla en el módulo de facturas»: el agente de voz se lo pasa y te cuenta qué ha cambiado.
Seguridad
-
Usa una API key de Gemini con la credencial Antigravity.
-
Iniciar sesión con una cuenta personal de Google (botón Iniciar sesión en Antigravity del nodo) solo aparece en las cuentas de prueba que el servidor habilita, para pruebas internas: los términos de Antigravity prohíben que un software de terceros use ese inicio de sesión y Google puede suspender la cuenta. No lo uses con tu cuenta principal.
-
Usa siempre tu API key: los inicios de sesión de suscripción (claude.ai, ChatGPT) no se pueden usar en NappAI.
-
El agente trabaja aislado: sin acceso a la red interna de NappAI ni a los espacios de otras personas.
-
No escribas claves ni tokens en la instrucción: usa la credencial y el campo Git Access Token.