Skip to Content
DocumentaçãoPlataformasAntigravity

Guia AIOS para AntiGravity

🌐 EN | PT | ES


Plataforma de Desenvolvimento Agêntico do Google - Arquitetura Baseada em Workflows


Visão Geral

O que é o AntiGravity?

AntiGravity é a plataforma de desenvolvimento agêntico do Google que permite que desenvolvedores construam e orquestrem workflows com IA. Ele apresenta uma abordagem única baseada em workflows para ativação de agentes e integração profunda com serviços do Google Cloud.

Por que usar AIOS com AntiGravity?

O AntiGravity oferece capacidades distintas:

  • Sistema de Workflows: Orquestre interações complexas de agentes
  • Integração Google Cloud: Firebase nativo, serviços GCP
  • MCP Nativo: Suporte integrado ao Model Context Protocol
  • Ativação @mention: Ativação padrão de agentes
  • Workflows Multi-Agente: Encadeie agentes juntos

Comparação com Outras Plataformas

RecursoAntiGravityClaude CodeCursor
Sistema de WorkflowSimTask ToolComposer
Google Cloud NativoSimNãoNão
Suporte MCPNativoNativoConfig
Encadeamento de AgentesSimSubagentesNão

Requisitos

Requisitos de Sistema

RequisitoMínimoRecomendado
RAM4GB8GB+
Espaço em Disco1GB2GB+
Node.js18.0+20.0+

Requisitos de Conta

  • Conta Google Cloud
  • Acesso AntiGravity (via Google AI)
  • Projeto Firebase (opcional, para integrações)

Instalação

Passo 1: Instalar o AntiGravity

# Instalar via npm npm install -g @google/antigravity # Ou usar o instalador do Google curl -fsSL https://get.antigravity.dev | sh

Passo 2: Autenticar

# Login com conta Google antigravity auth login # Ou configurar service account export GOOGLE_APPLICATION_CREDENTIALS="caminho/para/credentials.json"

Passo 3: Instalar o AIOS

cd seu-projeto npx @anthropic/aios init # Selecione "AntiGravity" quando solicitado

Passo 4: Verificar a Instalação

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

Estrutura esperada:

projeto/ ├── .antigravity/ │ ├── rules.md # Regras principais │ ├── antigravity.json # Configuração │ └── agents/ # Definições de agentes └── .agent/ └── workflows/ # Definições de workflow ├── dev-workflow.yaml ├── qa-workflow.yaml └── ...

Configuração

Configuração Principal

Localização: .antigravity/antigravity.json

{ "version": "1.0", "project": "nome-do-seu-projeto", "agents": { "default": "dev", "available": ["dev", "qa", "architect", "pm", "po", "analyst"] }, "workflows": { "directory": ".agent/workflows" }, "mcp": { "enabled": true, "servers": ["filesystem", "firebase"] } }

Arquivo de Regras

Localização: .antigravity/rules.md

# Regras Synkra AIOS para AntiGravity ## Sistema de Agentes - Use @nome-agente ou workflows para ativação - Siga definições de workflow para tarefas complexas ## Padrões de Desenvolvimento - Escreva código limpo e testado - Siga padrões existentes - Inclua tratamento abrangente de erros

Definições de Workflow

Localização: .agent/workflows/

# dev-workflow.yaml name: Workflow do Desenvolvedor trigger: "@dev" agent: dev steps: - name: analyze action: read_story input: "${story_path}" - name: implement action: write_code context: "${analyze.output}" - name: test action: run_tests

Uso Básico

Iniciando o AntiGravity

# Iniciar no projeto atual antigravity start # Iniciar com workflow específico antigravity run dev-workflow

Ativando Agentes

Via @mention:

@dev implemente a feature de autenticação de usuário @qa revise este módulo para problemas de segurança @architect projete o API gateway

Via Workflow:

antigravity workflow run dev --input "implementar feature de auth"

Comandos de Agente

*help # Mostrar comandos disponíveis *workflow list # Listar workflows disponíveis *workflow run X # Executar workflow X *exit # Sair do agente atual

Uso Avançado

Orquestração de Workflow

Crie workflows multi-agente complexos:

# feature-implementation.yaml name: Implementação de Feature description: Feature completa da story ao deployment stages: - name: planning agent: architect steps: - analyze_requirements - create_design_doc - name: implementation agent: dev depends_on: planning steps: - implement_feature - write_tests - name: quality agent: qa depends_on: implementation steps: - run_tests - security_review - name: documentation agent: dev depends_on: quality steps: - update_docs - create_changelog

Integração MCP

O AntiGravity tem suporte MCP nativo:

{ "mcp": { "servers": { "filesystem": { "enabled": true }, "firebase": { "enabled": true, "project": "seu-projeto-firebase" }, "bigquery": { "enabled": true, "dataset": "seu-dataset" } } } }

Serviços Google Cloud

Integração direta com GCP:

@dev Faça deploy desta função para Cloud Functions @devops Configure Cloud Run para este serviço @architect Projete usando Firestore para armazenamento de dados

Encadeamento de Agentes

Encadeie múltiplos agentes em um workflow:

chain: - agent: analyst task: "Analisar requisitos" output: requirements - agent: architect task: "Projetar solução" input: "${requirements}" output: design - agent: dev task: "Implementar solução" input: "${design}"

Recursos Específicos do AntiGravity

Dashboard de Workflow

Acesse o editor visual de workflow:

antigravity dashboard

Integração Firebase

# Use Firebase em workflows firebase: firestore: collection: "projects/${project_id}/tasks" storage: bucket: "project-assets"

Cloud Functions

Faça deploy de funções com agentes:

// functions/agent-handler.js const { AntiGravity } = require('@google/antigravity'); exports.handleRequest = AntiGravity.createFunction({ agent: 'dev', workflow: 'code-review' });

Sincronização de Agentes

Como Funciona

Comandos de Sincronização

# Sincronizar todos os agentes e workflows npm run sync:ide # Sincronizar para AntiGravity npm run sync:ide -- --ide antigravity

Formato de Agente

O AntiGravity usa um formato híbrido:

# .antigravity/agents/dev.yaml name: dev displayName: Desenvolvedor description: Desenvolvedor Full Stack Sênior persona: role: Desenvolvedor Full Stack expertise: - TypeScript/JavaScript - Node.js, React - Design de banco de dados - Deploy em nuvem workflow: default: dev-workflow triggers: - "@dev" - "desenvolver" - "implementar"

Limitações Conhecidas

Limitações Atuais

LimitaçãoSolução Alternativa
Conta Google necessáriaUse service accounts
Configuração complexa de workflowUse templates
Suporte limitado a IDEsFoco em CLI

AntiGravity vs Claude Code

AspectoAntiGravityClaude Code
Sistema de WorkflowNativoTask Tool
Cloud NativoGoogleQualquer
MCPNativoNativo
CLISimSim

Troubleshooting

Problemas Comuns

Falha de Autenticação

Error: Unable to authenticate

Solução:

antigravity auth logout antigravity auth login

Workflow Não Encontrado

Error: Workflow 'xyz' not found

Solução:

# Listar workflows disponíveis antigravity workflow list # Verificar diretório de workflows ls .agent/workflows/

Agente Não Reconhecido

Error: Unknown agent '@xyz'

Solução:

# Ressincronizar agentes npm run sync:ide # Verificar config do agente cat .antigravity/antigravity.json

Logs

# Ver logs do AntiGravity antigravity logs # Modo verbose antigravity --verbose start

FAQ

P: Preciso do Google Cloud? R: Recursos básicos funcionam sem ele, mas integração completa requer conta GCP.

P: Posso usar modelos não-Google? R: AntiGravity usa principalmente modelos do Google, mas algumas configurações permitem modelos externos.

P: Qual a diferença entre agentes e workflows? R: Agentes são personas com expertise; workflows orquestram ações de agentes em sequências.


Migração

Do Claude Code para AntiGravity

  1. Seus agentes em .aios-core/ são portáveis
  2. Inicialize AntiGravity:
    npx @anthropic/aios init --ide antigravity
  3. Arquivos de workflow são gerados automaticamente

Do AntiGravity para Outras IDEs

  1. Agentes AIOS permanecem em .aios-core/
  2. Inicialize para a IDE de destino
  3. Configs específicas da plataforma são geradas

Recursos Adicionais


Synkra AIOS - Guia da Plataforma AntiGravity v1.0