Úsalo Mejor18/09/2026Laboratório de IA5 min de lecturaActualizado el 20/09/2026

Gemini Antigravity 09-2026: cambios en la API y cómo migrar antes del 5 de octubre

La versión 09-2026 sustituye a la preview 05-2026. Consulta quién solo debe cambiar el agente, quién necesita adaptar tool calls y cómo probar la migración antes del 5 de octubre.

Notebook em mesa de trabalho com símbolo colorido de IA, painéis de código e arquivos conectados e calendário marcando 5 de outubro.

En resumen: Google lanzó Antigravity Agent 09-2026 el 17 de septiembre de 2026 con el identificador antigravity-preview-09-2026. Sustituye y deja obsoleto antigravity-preview-05-2026, cuyo cierre está programado para el 5 de octubre de 2026. Para integraciones que usan environment: "remote" y solo consumen output_text o pasos model_output, la indicación oficial es cambiar el identificador del agente. Quienes ejecutan herramientas localmente o interpretan pasos function_call deben adaptar el esquema de las herramientas incorporadas. Google detalló los cambios en las notas de versión de la Gemini API y el plazo aparece en la página oficial de deprecaciones.

Qué cambia de Antigravity 05-2026 a 09-2026

La principal ruptura de compatibilidad está en la capa de herramientas. Cambian varios nombres de funciones, los parámetros pasan a usar PascalCase en lugar de snake_case y la edición de archivos deja de basarse en reescrituras completas para usar reemplazos por rangos de líneas.

Capacidad05-202609-2026Impacto de la migración
Identificador del agenteantigravity-preview-05-2026antigravity-preview-09-2026Todos los proyectos deben apuntar a la nueva versión antes del cierre de la anterior.
Creación de archivoswrite_file(path, content)write_to_file(TargetFile, CodeContent, Overwrite, Description)Actualiza el nombre de la herramienta, los argumentos y cualquier validador que dependa del payload anterior.
Edición de archivoswrite_file(path, content), reescritura completareplace_file_content(TargetFile, StartLine, EndLine, TargetContent, ReplacementContent)El ejecutor local debe aceptar ediciones por rango de líneas y los nuevos campos.
Lectura de archivosread_file(path, offset, limit), con offsets de bytesview_file(AbsolutePath, StartLine, EndLine, ContentOffset)Los parsers y mocks deben seguir el nuevo nombre y el nuevo conjunto de parámetros.
Listado de directorioslist_files(path)list_dir(DirectoryPath)Hay que revisar llamadas y reglas basadas en el nombre anterior.
Búsqueda de archivos y códigoSin herramienta dedicada, los agentes usaban comandos de shellfind_by_name(SearchDirectory, Pattern, MaxDepth) y grep_search(SearchPath, Query, IsRegex)Dos herramientas incorporadas específicas pueden aparecer ahora en pasos function_call.
Ejecución de shellcode_execution(command, timeout_seconds)Sin cambio documentadoNo hay una migración de firma documentada para esta herramienta.
Búsqueda webgoogle_search(queries)Sin cambio documentadoNo hay una migración de firma documentada para esta herramienta.

Quién puede migrar cambiando solo el identificador del agente

El caso más sencillo es el de una aplicación que deja a Antigravity operar dentro del sandbox remoto de Google y solo lee el resultado final. La nota de versión es explícita: si la solicitud usa environment: "remote" y la aplicación solo consume output_text o pasos model_output, basta con cambiar la cadena del agente a antigravity-preview-09-2026. En ese flujo, la aplicación no implementa localmente las herramientas del sistema de archivos ni interpreta sus argumentos.

Aun así, conviene hacer una prueba de humo antes del despliegue. El objetivo es verificar autenticación, creación de la interacción, estado final, lectura de la salida y cualquier lógica propia de timeout, streaming o persistencia alrededor de la API.

Quién necesita cambiar código además de la cadena del agente

La migración exige más trabajo cuando una integración usa local_environment o inspecciona directamente pasos function_call. En esos casos, el software verá nombres y argumentos diferentes para las herramientas incorporadas. Esto afecta especialmente a adaptadores locales, routers de herramientas, validadores de argumentos, filtros de auditoría y pruebas cuyas fixtures codifican el esquema 05-2026.

  • Parámetros: la documentación indica que las herramientas modificadas pasan de snake_case a PascalCase.
  • Nombres de herramientas: write_file, read_file y list_files dejan de representar las mismas operaciones en la forma anterior.
  • Búsqueda en el sistema de archivos: find_by_name y grep_search forman parte del conjunto documentado de 09-2026.
  • Parsing de function_call: la lógica de dispatch basada en el nombre de la función o la validación de claves de argumentos debe aceptar el nuevo esquema.

Qué cambia específicamente en la edición de archivos

El cambio más importante para integraciones con herramientas locales es replace_file_content. En la preview 05-2026, la misma herramienta write_file(path, content) podía usarse para reescribir un archivo completo. En 09-2026, una edición se describe con TargetFile, StartLine, EndLine, TargetContent y ReplacementContent.

En la práctica, un ejecutor local ya no debe asumir que cada edición llega como el contenido completo de un archivo. Debe estar preparado para aplicar un reemplazo dentro de una región delimitada por líneas y validar el contenido objetivo antes de escribir la sustitución. La creación de archivos nuevos usa ahora write_to_file, con campos propios para el destino, el contenido, la sobrescritura y la descripción.

La lectura también cambia su modelo de referencia. read_file, que documentaba un offset y un límite en bytes, se sustituye por view_file, que usa ruta absoluta, líneas inicial y final y un desplazamiento de contenido. Si tu integración calcula offsets, reconstruye fragmentos o mantiene snapshots para pruebas, este punto merece una validación específica.

Checklist de migración antes del 5 de octubre

  1. Localiza referencias a la versión anterior: busca antigravity-preview-05-2026 en código, variables de entorno, archivos de configuración y pruebas.
  2. Cambia a antigravity-preview-09-2026: aplica primero la modificación en un entorno de prueba o en una parte controlada del tráfico.
  3. Clasifica tu flujo: confirma si solo usas environment: "remote" y salida final, o si ejecutas herramientas localmente e inspeccionas function_call.
  4. Actualiza el dispatch de herramientas: implementa los nuevos nombres y claves en PascalCase para creación, edición, lectura, listado y búsqueda de archivos.
  5. Revisa la edición de archivos: prueba reemplazos por rangos de líneas, incluidos casos en los que el contenido objetivo no coincida con lo esperado.
  6. Actualiza mocks, validaciones y observabilidad: logs, métricas, allowlists y pruebas que dependen de nombres antiguos pueden necesitar cambios.
  7. Ejecuta pruebas de regresión: valida tareas que crean, editan, leen y buscan archivos, además de flujos que usan code_execution y google_search.
  8. Completa el despliegue antes del plazo: Google registra el 5 de octubre de 2026 como fecha de cierre de antigravity-preview-05-2026.

Qué no cambia y qué significa realmente el plazo

En las notas de versión, code_execution(command, timeout_seconds) y google_search(queries) aparecen sin cambios. El plazo del 5 de octubre se aplica específicamente a la preview antigravity-preview-05-2026, no a toda la Gemini API. La página de deprecaciones indica antigravity-preview-09-2026 como reemplazo recomendado y, a 18 de septiembre de 2026, no anuncia una fecha de cierre para la nueva versión.

Google también mantiene Antigravity como función en Public Preview. La guía actual de Antigravity Agent lo describe como un agente gestionado de propósito general disponible a través de la Interactions API y Google AI Studio, con ejecución de código, gestión de archivos y acceso web dentro de un sandbox. Al seguir en preview, las funciones y los esquemas pueden cambiar, por lo que conviene evitar dependencias rígidas innecesarias en el formato interno de los pasos.

Fuentes oficiales para seguir la migración

Temas de este artículoagentes de IAAntigravityGeminiGemini APImigração de API