Configuração do agente de programação e recursos para desenvolvedores

Os agentes de programação de IA dependem de dados de treinamento que são interrompidos em uma data definida. Por isso, os agentes costumam sugerir modelos descontinuados (gemini-1.5), SDKs mais antigos (google-generativeai) ou padrões de código desatualizados.

Conectar seu agente aos recursos oficiais para desenvolvedores do Gemini ajuda a escrever código preciso usando modelos atuais, o SDK google-genai e a API Interactions.

Você pode dar ao seu agente de programação acesso à documentação e às regras do Gemini de quatro maneiras:

Resumo dos recursos do agente

Instalar habilidades do agente do Gemini

As habilidades do agente fornecem ao seu agente de programação regras procedimentais, nomes de modelos atuais e padrões de código do SDK. Em vez de adicionar instruções longas ao comando, o agente carrega cada habilidade apenas quando necessário. Isso ajuda seu agente a evitar SDKs descontinuados e usar padrões modernos do Gemini.

As habilidades funcionam com o servidor MCP do Gemini Docs. Se o agente não tiver o servidor MCP instalado, a skill vai voltar para llms.txt. Para saber mais sobre como as skills funcionam, leia o guia de skills da API Gemini.

Instalar com a CLI (skills.sh ou Context7)

Instale habilidades usando skills.sh (recomendado) ou Context7:

# List all available skills in the repository
npx skills add google-gemini/gemini-skills --list

# Install a specific skill globally with skills.sh
npx skills add google-gemini/gemini-skills --skill <skill-name> --global

# Or install with Context7
npx ctx7 skills install /google-gemini/gemini-skills <skill-name>

Habilidades disponíveis

gemini-api-dev

Habilidade para criar aplicativos com a API Interactions e os SDKs oficiais da API Gemini (google-genai para Python e @google/genai para TypeScript). Esta habilidade abrange:

• Geração de texto, conversa multiturno, streaming, saídas estruturadas e chamadas de função
• Geração de imagens, conversão de texto em voz (TTS) e entradas multimodais
• Gerenciamento de estado de conversação do lado do servidor, execução em segundo plano, pesquisa avançada e agentes gerenciados
• Nomes de modelos atuais e migração de código legado generateContent ou google-generativeai

npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

gemini-live-api-dev

Habilidade para criar aplicativos de streaming de áudio e vídeo em tempo real com a API Gemini Live. Esta habilidade abrange:

• Gerenciamento de sessão do WebSocket, tokens de cliente efêmeros e retomada de sessão
• Streaming de áudio, vídeo e texto com detecção de atividade de voz (VAD) e suporte a interrupção
• Raciocínio em segundo plano (pensamento extenso), chamadas de ferramentas assíncronas não bloqueadoras, transcrição e tradução instantânea de fala

npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

gemini-omni-flash-api

Habilidade para gerar e editar vídeos com o Gemini Omni Flash usando a API Interactions. Inclui scripts auxiliares (upload_file.py, generate_video.py, prep_video.py, inspect_video.py) e aborda:

• Geração de texto para vídeo e criação de comandos
• Transições do primeiro e do último frame e geração de vídeo guiada por referência
• Extensões de vídeo e fluxos de trabalho de pré-processamento de mídia

npx skills add google-gemini/gemini-skills --skill gemini-omni-flash-api --global

Montar habilidades em agentes gerenciados

Ao executar agentes gerenciados remotos com a API Interactions, é possível montar o repositório google-gemini/gemini-skills no espaço de trabalho do agente. Consulte o guia de habilidades da API Gemini para mais detalhes:

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-09-2026",
    input="Build a script that generates a 5-second video of a neon cityscape.",
    environment={
        "type": "remote",
        "sources": [
            {
                "type": "repository",
                "source": "https://github.com/google-gemini/gemini-skills",
                "target": ".agents",
            }
        ],
    },
)

Conectar o servidor MCP do Gemini Docs

O servidor MCP público do Gemini Docs (https://gemini-api-docs-mcp.dev) dá ao seu agente acesso em tempo real a todo o site de documentação. Seu agente pode pesquisar e ler páginas de documentação para verificar esquemas de solicitação, limites de modelo e novos recursos:

• gemini_search_docs: pesquisa a documentação da API Gemini por tema ou consulta.
• gemini_get_doc: lê todo o conteúdo Markdown de uma página de documentação específica.

Configuração rápida

Execute este comando no terminal ou na raiz do projeto para configurar automaticamente os agentes de programação detectados:

npx add-mcp "https://gemini-api-docs-mcp.dev"

Configuração por ambiente

$ claude mcp add --transport http geminiDocs https://gemini-api-docs-mcp.dev

{
  "mcpServers": {
    "geminiDocs": {
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

$ codex mcp add geminiDocs --url https://gemini-api-docs-mcp.dev

[mcp_servers.geminiDocs]
url = "https://gemini-api-docs-mcp.dev"

{
  "servers": {
    "geminiDocs": {
      "type": "http",
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

Plug-in da API Gemini

Se você usa o Antigravity, o plug-in da API Gemini é a maneira mais rápida de configurar seu espaço de trabalho. Ele agrupa o servidor MCP do Gemini Docs, todas as habilidades oficiais do Gemini (gemini-api-dev, gemini-live-api-dev, gemini-omni-flash-api) e ferramentas de chave de API em um único download.

• Instalar no Antigravity (interface): acesse Configurações > Personalizações > Criar com plug-ins do Google e baixe a API Gemini.
• Instalar com a CLI:bash agy plugin install https://github.com/google-gemini/gemini-skills

Documentação legível por máquina

As páginas da Web padrão incluem tags HTML, barras de navegação e scripts que ocupam espaço na janela de contexto. O ai.google.dev fornece endpoints legíveis por máquina para que agentes e scripts possam buscar Markdown limpo diretamente:

• Índice llms.txt (https://ai.google.dev/gemini-api/docs/llms.txt): lista todas as páginas de documentação da API Gemini com links para cada uma delas.
• URLs diretos do Markdown (.md.txt): adicione .md.txt a qualquer URL de documentação em ai.google.dev (por exemplo, https://ai.google.dev/gemini-api/docs/coding-agents.md.txt) para receber uma fonte Markdown limpa de comandos salvos, regras de AGENTS.md ou scripts automatizados.

Regras de projeto recomendadas (AGENTS.md)

Um arquivo de regras do projeto (AGENTS.md, .cursorrules ou CLAUDE.md) define regras básicas que são carregadas no início de cada sessão do agente. Adicione estas diretrizes à raiz do projeto para que os agentes de programação usem os modelos e SDKs atuais por padrão:

# Gemini API Guidelines

- Before writing Gemini API code, consult the `geminiDocs` MCP server (`gemini_search_docs` / `gemini_get_doc`) or `https://ai.google.dev/gemini-api/docs/llms.txt`.
- Always use the current Gemini API SDK (`google-genai` for Python, `@google/genai` for TypeScript/JavaScript). Never use legacy SDKs (`google-generativeai` or `@google/generative-ai`).
- Use the Interactions API (`client.interactions.create`) for new applications unless a specific feature requires `generateContent`.
- Use current recommended models (see https://ai.google.dev/gemini-api/docs/models) and avoid deprecated models.

Verificar e resolver problemas

Verificar sua configuração

Para testar sua configuração, pergunte ao agente de programação:

Look up the request schema for the Gemini Interactions API in the documentation.

Um agente configurado vai usar gemini_search_docs no servidor MCP geminiDocs e escrever código usando client.interactions.create com o SDK google-genai ou @google/genai.

Comandos de status

Solução de problemas

• Habilidade ou servidor MCP não detectado:reinicie o editor (Cursor ou VS Code) ou a sessão do terminal (Claude Code ou Codex). A maioria dos agentes carrega servidores MCP e habilidades apenas quando são iniciados.
• Conflito de habilidade global:se o agente ignorar uma habilidade instalada globalmente, instale a habilidade na raiz do projeto sem --global: bash npx skills add google-gemini/gemini-skills --skill gemini-api-dev
• Regras ignoradas:verifique se o arquivo AGENTS.md, .cursorrules ou CLAUDE.md está no diretório raiz do projeto.

A seguir

• Guia de habilidades da API Gemini
• Habilidades da API Gemini no GitHub
• API Interactions
• Modelos disponíveis
• Bibliotecas e SDKs