Guía AIOX para AntiGravity

🌐 EN | PT | ES

Plataforma de Desarrollo Agentico de Google - Arquitectura Basada en Flujos de Trabajo

Descripción General

¿Qué es AntiGravity?

AntiGravity es la plataforma de desarrollo agentic de Google que permite a los desarrolladores construir y orquestar flujos de trabajo impulsados por IA. Cuenta con un enfoque único basado en flujos de trabajo para la activación de agentes y una integración profunda con los servicios de Google Cloud.

¿Por qué usar AIOX con AntiGravity?

AntiGravity ofrece capacidades distintivas:

Sistema de Flujos de Trabajo: Orquesta interacciones complejas entre agentes
Integración con Google Cloud: Firebase nativo, servicios de GCP
MCP Nativo: Soporte integrado del Protocolo de Contexto de Modelo
Activación por @mención: Activación estándar de agentes
Flujos de Trabajo Multi-Agente: Encadena agentes juntos

Comparación con Otras Plataformas

Característica	AntiGravity	Claude Code	Cursor
Sistema de Flujos de Trabajo	Sí	Herramienta Task	Composer
Nativo de Google Cloud	Sí	No	No
Soporte MCP	Nativo	Nativo	Configuración
Encadenamiento de Agentes	Sí	Subagentes	No

Requisitos

Requisitos del Sistema

Requisito	Mínimo	Recomendado
RAM	4GB	8GB+
Espacio en Disco	1GB	2GB+
Node.js	18.0+	20.0+

Requisitos de Cuenta

Cuenta de Google Cloud
Acceso a AntiGravity (vía Google AI)
Proyecto Firebase (opcional, para integraciones)

Instalación

Paso 1: Instalar AntiGravity

# Instalar vía npm
npm install -g @google/antigravity

# O usar el instalador de Google
curl -fsSL https://get.antigravity.dev | sh

Paso 2: Autenticarse

# Iniciar sesión con cuenta de Google
antigravity auth login

# O configurar cuenta de servicio
export GOOGLE_APPLICATION_CREDENTIALS="ruta/a/credenciales.json"

Paso 3: Instalar AIOX

cd tu-proyecto
npx @anthropic/aiox init
# Selecciona "AntiGravity" cuando se te solicite

Paso 4: Verificar Instalación

ls -la .antigravity/
ls -la .agent/

Estructura esperada:

proyecto/
├── .antigravity/
│   ├── rules.md              # Reglas principales
│   ├── antigravity.json      # Configuración
│   └── agents/               # Definiciones de agentes
└── .agent/
    └── workflows/            # Definiciones de flujos de trabajo
        ├── dev-workflow.yaml
        ├── qa-workflow.yaml
        └── ...

Configuración

Configuración Principal

Ubicación: .antigravity/antigravity.json

{
  "version": "1.0",
  "project": "nombre-de-tu-proyecto",
  "agents": {
    "default": "dev",
    "available": ["dev", "qa", "architect", "pm", "po", "analyst"]
  },
  "workflows": {
    "directory": ".agent/workflows"
  },
  "mcp": {
    "enabled": true,
    "servers": ["filesystem", "firebase"]
  }
}

Archivo de Reglas

Ubicación: .antigravity/rules.md

# Reglas de Synkra AIOX para AntiGravity

## Sistema de Agentes
- Usa @nombre-agente o flujos de trabajo para activación
- Sigue las definiciones de flujos de trabajo para tareas complejas

## Estándares de Desarrollo
- Escribe código limpio y probado
- Sigue patrones existentes
- Incluye manejo de errores completo

Definiciones de Flujos de Trabajo

Ubicación: .agent/workflows/

# dev-workflow.yaml
name: Flujo de Trabajo del Desarrollador
trigger: "@dev"
agent: dev
steps:
  - name: analizar
    action: read_story
    input: "${story_path}"
  - name: implementar
    action: write_code
    context: "${analyze.output}"
  - name: probar
    action: run_tests

Uso Básico

Iniciando AntiGravity

# Iniciar en el proyecto actual
antigravity start

# Iniciar con flujo de trabajo específico
antigravity run dev-workflow

Activando Agentes

Vía @mención:

@dev implementa la funcionalidad de autenticación de usuarios

@qa revisa este módulo por problemas de seguridad

@architect diseña el gateway de API

Vía Flujo de Trabajo:

antigravity workflow run dev --input "implementar funcionalidad de autenticación"

Comandos de Agente

*help              # Mostrar comandos disponibles
*workflow list     # Listar flujos de trabajo disponibles
*workflow run X    # Ejecutar flujo de trabajo X
*exit              # Salir del agente actual

Uso Avanzado

Orquestación de Flujos de Trabajo

Crea flujos de trabajo complejos multi-agente:

# feature-implementation.yaml
name: Implementación de Funcionalidad
description: Funcionalidad completa desde historia hasta despliegue

stages:
  - name: planificación
    agent: architect
    steps:
      - analyze_requirements
      - create_design_doc

  - name: implementación
    agent: dev
    depends_on: planificación
    steps:
      - implement_feature
      - write_tests

  - name: calidad
    agent: qa
    depends_on: implementación
    steps:
      - run_tests
      - security_review

  - name: documentación
    agent: dev
    depends_on: calidad
    steps:
      - update_docs
      - create_changelog

Integración MCP

AntiGravity tiene soporte MCP nativo:

{
  "mcp": {
    "servers": {
      "filesystem": {
        "enabled": true
      },
      "firebase": {
        "enabled": true,
        "project": "tu-proyecto-firebase"
      },
      "bigquery": {
        "enabled": true,
        "dataset": "tu-dataset"
      }
    }
  }
}

Servicios de Google Cloud

Integración directa con GCP:

@dev Despliega esta función a Cloud Functions

@devops Configura Cloud Run para este servicio

@architect Diseña usando Firestore para almacenamiento de datos

Encadenamiento de Agentes

Encadena múltiples agentes en un flujo de trabajo:

chain:
  - agent: analyst
    task: "Analizar requisitos"
    output: requirements

  - agent: architect
    task: "Diseñar solución"
    input: "${requirements}"
    output: design

  - agent: dev
    task: "Implementar solución"
    input: "${design}"

Características Específicas de AntiGravity

Panel de Flujos de Trabajo

Accede al editor visual de flujos de trabajo:

antigravity dashboard

Integración con Firebase

# Usar Firebase en flujos de trabajo
firebase:
  firestore:
    collection: "projects/${project_id}/tasks"
  storage:
    bucket: "project-assets"

Cloud Functions

Despliega funciones impulsadas por agentes:

// functions/agent-handler.js
const { AntiGravity } = require('@google/antigravity');

exports.handleRequest = AntiGravity.createFunction({
  agent: 'dev',
  workflow: 'code-review'
});

Sincronización de Agentes

Cómo Funciona

flowchart LR
    Source["AIOX Core<br/>.aiox-core/development/agents"] --> Parser["Analizador de Agentes"]
    Parser --> Transform["Transformador AntiGravity"]
    Transform --> Agents[".antigravity/agents/"]
    Transform --> Workflows[".agent/workflows/"]

Comandos de Sincronización

# Sincronizar todos los agentes y flujos de trabajo
npm run sync:ide

# Sincronizar para AntiGravity
npm run sync:ide -- --ide antigravity

Formato de Agente

AntiGravity usa un formato híbrido:

# .antigravity/agents/dev.yaml
name: dev
displayName: Desarrollador
description: Desarrollador Full Stack Senior

persona:
  role: Desarrollador Full Stack
  expertise:
    - TypeScript/JavaScript
    - Node.js, React
    - Diseño de bases de datos
    - Despliegue en la nube

workflow:
  default: dev-workflow
  triggers:
    - "@dev"
    - "desarrollar"
    - "implementar"

Limitaciones Conocidas

Limitaciones Actuales

Limitación	Solución Alternativa
Cuenta de Google requerida	Usar cuentas de servicio
Configuración compleja de flujos	Usar plantillas
Soporte IDE limitado	Enfocado en CLI

AntiGravity vs Claude Code

Aspecto	AntiGravity	Claude Code
Sistema de Flujos	Nativo	Herramienta Task
Nativo en la Nube	Google	Cualquiera
MCP	Nativo	Nativo
CLI	Sí	Sí

Solución de Problemas

Problemas Comunes

Fallo de Autenticación

Error: Unable to authenticate

Solución:

antigravity auth logout
antigravity auth login

Flujo de Trabajo No Encontrado

Error: Workflow 'xyz' not found

Solución:

# Listar flujos de trabajo disponibles
antigravity workflow list

# Verificar directorio de flujos de trabajo
ls .agent/workflows/

Agente No Reconocido

Error: Unknown agent '@xyz'

Solución:

# Resincronizar agentes
npm run sync:ide

# Verificar configuración de agente
cat .antigravity/antigravity.json

Registros

# Ver registros de AntiGravity
antigravity logs

# Modo detallado
antigravity --verbose start

Preguntas Frecuentes

P: ¿Necesito Google Cloud? R: Las funciones básicas funcionan sin él, pero la integración completa requiere una cuenta de GCP.

P: ¿Puedo usar modelos que no sean de Google? R: AntiGravity usa principalmente los modelos de Google, pero algunas configuraciones permiten modelos externos.

P: ¿Cuál es la diferencia entre agentes y flujos de trabajo? R: Los agentes son personas con experiencia; los flujos de trabajo orquestan acciones de agentes en secuencias.

Migración

De Claude Code a AntiGravity

Tus agentes en .aiox-core/ son portables

Inicializa AntiGravity:

npx @anthropic/aiox init --ide antigravity

Los archivos de flujo de trabajo se generan automáticamente

De AntiGravity a Otros IDEs

Los agentes de AIOX permanecen en .aiox-core/
Inicializa para el IDE destino
Las configuraciones específicas de la plataforma se generan

Recursos Adicionales

Synkra AIOX - Guía de Plataforma AntiGravity v1.0

FilesExpand file tree

antigravity.md

Latest commit

History

antigravity.md

File metadata and controls

Guía AIOX para AntiGravity

Descripción General

¿Qué es AntiGravity?

¿Por qué usar AIOX con AntiGravity?

Comparación con Otras Plataformas

Requisitos

Requisitos del Sistema

Requisitos de Cuenta

Instalación

Paso 1: Instalar AntiGravity

Paso 2: Autenticarse

Paso 3: Instalar AIOX

Paso 4: Verificar Instalación

Configuración

Configuración Principal

Archivo de Reglas

Definiciones de Flujos de Trabajo

Uso Básico

Iniciando AntiGravity

Activando Agentes

Comandos de Agente

Uso Avanzado

Orquestación de Flujos de Trabajo

Integración MCP

Servicios de Google Cloud

Encadenamiento de Agentes

Características Específicas de AntiGravity

Panel de Flujos de Trabajo

Integración con Firebase

Cloud Functions

Sincronización de Agentes

Cómo Funciona

Comandos de Sincronización

Formato de Agente

Limitaciones Conocidas

Limitaciones Actuales

AntiGravity vs Claude Code

Solución de Problemas

Problemas Comunes

Fallo de Autenticación

Flujo de Trabajo No Encontrado

Agente No Reconocido

Registros

Preguntas Frecuentes

Migración

De Claude Code a AntiGravity

De AntiGravity a Otros IDEs

Recursos Adicionales