Família Gemini · Nível avançado

Gemini API + Antigravity. 5 agentes em produção.

Não é tutorial de "hello world". É arquitetura, system prompts completos, function calling real e os 5 agentes que eu construiria primeiro pro seu negócio. Plus: lista curada de repos do GitHub que poupam meses.

01 Gemini API · setup em 3 minutos

AI Studio (aistudio.google.com) é o lugar pra começar. Cria a key:

  1. Abre AI Studio → Get API key → cria key.
  2. Salva no .env como GEMINI_API_KEY=....
  3. Instala SDK: pip install google-genai ou npm i @google/genai.
# Python · primeira chamada
from google import genai

client = genai.Client()
response = client.models.generate_content(
    model="gemini-2.5-pro",
    contents="Resume o conceito de MEDDIC em 4 frases pra um SDR brasileiro novato.",
)
print(response.text)

Modelos · qual usar quando

ModeloCusto / 1M tokensQuando usar
gemini-2.5-flash~$0.30 entradaVolume alto: classificação, extração, primeiros toques de SDR.
gemini-2.5-pro~$1.25 entradaDecisão complexa, análise de doc longo, raciocínio.
gemini-2.5-flash-lite~$0.075 entradaTarefa simples em altíssimo volume (filtro de spam, tag).
imagen-4~$0.04 por imagemGeração de imagem na API.
veo-3$$$ — premiumVídeo. Cuidado com cota.

Preços snapshot · Maio/2026 · confira ai.google.dev/pricing antes de produção.

02 Function calling · onde a IA vira agente

Function calling é como você dá ações pra IA. Em vez dela só responder texto, ela retorna "execute essa função com esses parâmetros" — seu código executa, e o resultado volta pra IA.

# Define a função (Python)
def buscar_horarios_disponiveis(data_inicio: str, dias: int) -> list:
    """Busca horários livres na agenda do Dentrix."""
    return dentrix_api.list_slots(data_inicio, dias)

# Passa pro Gemini com tools=[]
config = types.GenerateContentConfig(
    tools=[buscar_horarios_disponiveis],
    system_instruction=SYSTEM_PROMPT,
)

response = client.models.generate_content(
    model="gemini-2.5-pro",
    config=config,
    contents="Cliente: oi, queria marcar consulta na sexta",
)

O Gemini decide sozinho que precisa chamar buscar_horarios_disponiveis, passa parâmetros, recebe a lista e responde ao cliente em português natural. Esse é o coração de qualquer agente em produção.

03 Antigravity · o IDE com agentes do Google

Antigravity é a aposta do Google em agente de coding. É um IDE (descendente do VS Code) onde múltiplos agentes trabalham em paralelo: um escreve, outro testa, outro revisa. O equivalente Google do Claude Code / Cursor.

Setup

  1. Download em antigravity.google · grátis enquanto preview.
  2. Loga com Google. Conecta repo (GitHub).
  3. Abre o painel Manager: você dá brief, ele cria plano e executa em multi-agente.
  4. Configurações úteis: parallel agents = 3, auto-PR = sim, screenshot before/after = sim.

Prompt patterns que funcionam no Antigravity

# Pattern 1 — feature do zero
Adicione um endpoint POST /api/leads que recebe
{nome, email, telefone, fonte}, valida, salva em
postgres (tabela `leads`), dispara webhook pro
Slack do canal #vendas e devolve {id, status}.

Tests: unit + integration.
Documentação: atualiza README na seção API.
Estilo: segue o padrão dos endpoints existentes em
src/api/.

# Pattern 2 — refactor
Refatora src/agents/sdr.py:
- Extrai constantes mágicas pra config
- Cobre com testes (cobertura alvo 80%)
- Adiciona logging estruturado (loguru)
- Mantém API pública intacta

NÃO altera nada fora desse arquivo + seus tests.

# Pattern 3 — bug fix com investigação
Há um bug: clientes do tipo "premium" não recebem
o lembrete 24h antes. Investiga, identifica a
causa raiz (não fica no sintoma), e corrige.
Adiciona um test que cobre esse cenário.

04 5 agentes profundos · arquitetura + prompt completo

UC-01 · Profundo

Agente SDR · qualifica, marca reunião, escala lead quente

Stack: Gemini Pro · function calling · Calendar API · Slack webhook Volume: 500-2000 visitas/mês ROI: substitui SDR inbound de R$ 5-8k/mês

Arquitetura

3 funções: buscar_contexto_visitante (pega referrer, UTM, página), marcar_reuniao (calendar), escalar_pra_slack (lead quente).

System prompt

Você é o Bernie, SDR de IA da 10XAI. Recebe visitante
no site e qualifica usando MEDDIC adaptado + Challenger.

REGRAS DE TOM (não negociáveis):
- Português brasileiro de operador. Curto.
- Nunca diz "olá". Sempre "oi".
- Sem "gostaria", "espero que", "ótimo dia".
- Pergunta concreta, nunca dupla.
- Respostas ≤ 2 linhas até qualificar.

FRAMEWORK MEDDIC:
- Metric: que dor mensurável o visitante tem?
- Economic buyer: ele decide ou influencia?
- Decision criteria: que sinais ele usa pra escolher?
- Decision process: quem mais precisa ouvir sim?
- Identify pain: dor real, não declarada
- Champion: ele é o cara?

FLUXO:
1. Cumprimento de 1 linha + pergunta de qualificação 1.
2. Adapta as próximas 3-5 perguntas conforme respostas.
3. Quando tiver MEDDIC ≥ 4/6 itens claros → escala
   pra Slack via tool escalar_pra_slack().
4. Se visitante pedir reunião explicitamente → use
   tool marcar_reuniao() com horários reais do
   Bernardo.
5. Se objeção dura → cite caso real (DM Bernie pra
   passar transcrição).

NUNCA invente caso, número ou cliente.

Funções (function calling)

def marcar_reuniao(email: str, horario_iso: str, duracao_min: int) -> dict:
    """Cria evento no Google Calendar do Bernardo e envia convite."""

def escalar_pra_slack(resumo: str, score_meddic: int, contato: dict) -> None:
    """Posta no canal #leads-quentes com resumo + score."""

def buscar_contexto_visitante(session_id: str) -> dict:
    """Retorna referrer, UTM, páginas visitadas, tempo no site."""

Métricas de sucesso

UC-02 · Profundo

Automação de marketing · calendário + posts + ads

Stack: Gemini Pro · Veo 3 · Imagen 4 · n8n · Buffer/Make Volume: 30 posts/mês em 4 canais ROI: substitui agência de R$ 8-15k/mês

Arquitetura

Pipeline mensal: pilares → calendário 30 dias → geração de copy → geração de imagem/vídeo → review humano → publicação agendada → loop de performance.

System prompt do orquestrador

Você é o diretor de conteúdo da [empresa]. Você NÃO
escreve posts — você dirige a geração.

INPUT TODO MÊS:
- 5 pilares de conteúdo (texto colado)
- ICP detalhado
- 10 últimos posts que performaram (com métricas)
- Voz de marca (impressão digital de 5 expressões
  recorrentes, 3 proibidas)
- Eventos do mês (lançamento, evento de mercado,
  feriado)

OUTPUT (sempre):
- Calendário CSV: data, canal, formato, pilar,
  título, hook, copy, CTA, imagem/vídeo (brief),
  hashtags.
- 30 dias completos: 5 posts/semana em 4 canais
  (LinkedIn, Instagram, Facebook, TikTok).
- Cada peça referencia UM pilar de forma explícita.
- 70/20/10: 70% valor, 20% caso/prova, 10% oferta.

REGRAS:
- Nunca repete hook idêntico em 30 dias.
- A cada 7 posts, 1 obrigatoriamente quebra padrão
  (formato/tom/ângulo).
- Hashtags: 5 max, mistura genérica + nicho.
- NUNCA usa "olá", "espero", "gostaria"  (PT-BR de
  verdade).

Funções

def gerar_imagem(brief: str, formato: str) -> str:
    """Chama Imagen 4. Retorna URL da imagem gerada."""

def gerar_video_b_roll(brief: str, duracao_s: int) -> str:
    """Chama Veo 3. Retorna URL do vídeo gerado."""

def agendar_post(canal: str, datetime_iso: str, conteudo: dict) -> None:
    """Agenda no Buffer/Make."""

def ler_performance_ultimos_30d() -> dict:
    """Retorna métricas dos últimos posts."""

Métricas

UC-03 · Profundo

Cadência de vendas · e-mail + LinkedIn + WhatsApp

Stack: Gemini Pro · Smartlead/Instantly · Phantombuster · Z-API Volume: 200-500 contatos/semana ROI: substitui SDR outbound

Arquitetura · cadência de 7 dias úteis

DiaCanalTipo
D1 09:00E-mailHook + 1 sinal específico do prospect
D2 14:00LinkedInConnection request com nota personalizada
D4 10:30WhatsAppFollow-up casual (se aceitou no LI)
D5 09:00E-mailRecap + caso real anexado
D7 16:00E-mail"Última tentativa" com valor concreto
D9 11:00LinkedInDM curta de "encerro o follow-up"

System prompt da copy

Você gera copy de cadência outbound B2B em PT-BR.
NUNCA roda template — sempre personaliza com sinal
real do prospect.

INPUTS POR PROSPECT:
- Nome, cargo, empresa
- 2-5 sinais públicos: vagas abertas, mudança de
  cargo, post recente, notícia da empresa
- ICP fit score (1-5)

OUTPUT POR TOQUE:
- 1 ângulo (não repete os anteriores da cadência)
- 1 referência ao sinal real (parafraseada, sem
  citar literalmente — pra não soar stalker)
- 1 pergunta concreta no fim (não "vamos conversar?")

REGRAS:
- E-mail D1: 60-80 palavras. Subject ≤ 5 palavras.
- WhatsApp: ≤ 30 palavras, tom de "amigo de mercado".
- LinkedIn nota: 280 chars max.
- Nunca diz "olá", "espero", "gostaria", "rapidinha".
- Sempre PT-BR brasileiro.

SE prospect responde:
- Positivo → escala marcar reunião.
- Negativo → registra motivo, encerra cadência.
- Ambíguo → 1 follow-up de qualificação.

Métricas

UC-04 · Profundo

Prospecção · ICP + enriquecimento + ranking

Stack: Gemini Flash · Apollo/Clay · LinkedIn Sales Nav · Pinecone Volume: 500-2000 contatos/semana ROI: 8x mais rápido que SDR manual

Arquitetura

4 etapas: filtro inicial (Apollo) → enriquecimento (Clay + scraping) → scoring de fit (Gemini) → ranking por intent signal.

System prompt do scorer

Você é avaliador de fit ICP. Recebe um perfil
enriquecido (empresa + decisor + sinais públicos)
e retorna SCORE 0-100 + JUSTIFICATIVA em 2 linhas.

CRITÉRIOS ICP DA 10XAI (ajusta pro seu):
- Empresa: 10-200 funcionários, B2B ou B2B2C
- Setor: SaaS, agências, clínicas, educação
- Sinal de dor: contratou recentemente SDR/atendente,
  reclamação pública sobre tempo de resposta,
  expansão recente
- Decisor: founder, COO, head de ops, head de
  vendas
- Sinais de POOR fit: empresa muito grande (>500
  func), setor regulado pesado (banco/jurídico
  enterprise), recente injeção VC (vai escalar
  diferente)

OUTPUT JSON:
{
  "score": 0-100,
  "rationale": "2 linhas em PT-BR",
  "top_signal": "o sinal mais forte de fit/no-fit",
  "next_action": "outreach|skip|nurture"
}

NUNCA enviesa por nome de empresa famosa.
Score baseado SÓ em fit, não em "seria legal".

Métricas

UC-05 · Profundo

Dev agent · feature do brief ao PR

Stack: Antigravity · GitHub · sandbox isolado Volume: 5-15 PRs/semana ROI: substitui contratação de mid-level dev

Workflow real

  1. Brief: issue do GitHub com critério de aceitação claro.
  2. Antigravity abre branch, lê o repo inteiro, propõe plano.
  3. Você revisa o plano (1 min). Aprova ou ajusta.
  4. Executa em paralelo: agent A escreve, agent B escreve tests, agent C revisa.
  5. Roda CI. Se quebra, agent corrige até passar.
  6. Abre PR com descrição auto-gerada + screenshots before/after.
  7. Você revisa em 5 min e dá merge.

System prompt do agente

Você é dev sênior. Você não escreve "código que
funciona" — escreve código que vai pra produção.

REGRAS NÃO NEGOCIÁVEIS:
1. Lê TODO o repo antes de propor mudança.
   Identifica padrões existentes. Segue os padrões.
2. Nada de "vou adicionar uma lib nova" sem
   justificar por que não dá pra fazer com o que
   já existe.
3. Cobertura de teste obrigatória pro novo código.
   Mantém ou melhora cobertura do repo.
4. Documentação inline em ENGLISH (padrão de
   indústria), explicação de PR em PT-BR.
5. Commits semânticos: feat: / fix: / refactor: /
   test: / docs:.
6. NUNCA hard-coda config. Sempre via env var.
7. NUNCA quebra API pública sem deprecation
   gradual.

ANTES DO PR:
- Roda lint e formata
- Roda tests inteiros, não só o novo
- Verifica que não há secrets vazando
- Atualiza CHANGELOG.md

05 Repos GitHub que valem clonar

Snapshot Maio/2026. Stars envelhecem rápido — confirma no github.com/trending e github-ranking. Link direto pra clonar.

Frameworks de agentes

Framework canônico pra orquestração de LLM. Suporte forte ao Gemini. Caro de aprender, mas é onde a documentação tá.
★ 100k+
Melhor escolha pra RAG (NotebookLM caseiro). Conectores prontos pra Drive, Notion, Slack.
★ 40k+
Multi-agente, roles e tasks. Fácil de prototipar (SDR + closer + research).
★ 35k+
Microsoft entrou pesado. Multi-agente com loops de conversação. Acoplado ao stack Azure mas roda standalone.
★ 35k+
Agent Development Kit do próprio Google. Integração de primeira com Gemini + Vertex.
★ 8k+

Aplicações de exemplo (clonar e adaptar)

Notebooks oficiais com receitas. Bom ponto de partida pra function calling, multimodal, agentes.
★ 10k+
Chatbot full-stack pronto. Bom esqueleto pra Care Engine caseiro.
★ 35k+
Clone do ChatGPT/Claude self-hosted. Suporta Gemini. Bom pra deployment interno de time.
★ 25k+
Automação visual (Zapier open source). Nodes nativos pra Gemini, OpenAI, Anthropic. Self-host grátis.
★ 80k+
UI moderna pra chatbots multi-modelo. Plugin ecosystem grande.
★ 50k+

Dev tools / agentes de coding

Agent de coding open-source. Rival do Devin. Suporta Gemini.
★ 38k+
Pair programming CLI. Lê seu repo, edita por instrução. Muito bom pra desenvolvedor solo.
★ 25k+
Extension VS Code pra agente autônomo. Aprova/rejeita ação por ação.
★ 28k+

Image & Video

UI nodal pra pipeline de imagem. Permite encadear Imagen + edição + upscale + outras.
★ 65k+
Modelos de imagem/vídeo open. Útil pra rodar local quando não dá pra usar API.
★ 25k+

06 Otimização de custo · sem perder qualidade

07 Checklist · pronto pra produção

A regra que vale ouro
Ship não é "lançou" — é "monitorado, com kill switch, com on-call". Os 5 agentes acima são fáceis de montar em 2 semanas. Difícil é deixar rodando 6 meses sem virar dívida. Investe nos 30 dias de tuning depois do go-live — vale mais que qualquer feature.
Próximo nível

Você acabou de ler o manual. Agora dá para ver rodando.

Este playbook ensina você a operar a ferramenta. A biblioteca de agentes mostra o passo seguinte: processos inteiros que rodam sozinhos, cada um com o system prompt pronto para copiar e organizados pela sua indústria. E se você preferir desenhar o seu em vez de adaptar um genérico, são 15 minutos de conversa — sem deck, sem proposta, só o desenho.