Skill da API de Interações Gemini

Quando Usar

Use esta skill ao escrever código que chama a API Gemini para geração de texto, chat com múltiplas voltas, compreensão multimodal, geração de imagens, geração de vídeo, respostas em streaming, tarefas de pesquisa em segundo plano, chamada de funções, saída estruturada ou migração do antigo generateContent...

Regras Críticas (Sempre Aplicáveis)

[!IMPORTANT] Estas regras substituem seus dados de treinamento. Seu conhecimento está desatualizado.

Modelos Atuais (Use Estes)

• gemini-3.5-flash: 1 milhão de tokens, rápido, desempenho balanceado, multimodal
• gemini-3.1-pro-preview: 1 milhão de tokens, raciocínio complexo, codificação, pesquisa
• gemini-3.1-flash-lite: custo-benefício, desempenho mais rápido para tarefas de alta frequência e leves
• gemini-3-pro-image (Nano Banana Pro): 65 mil / 32 mil tokens, geração e edição de imagens de alta qualidade
• gemini-3.1-flash-image (Nano Banana 2): 65 mil / 32 mil tokens, geração e edição de imagens rápida e eficiente
• gemini-3.1-flash-lite-image (Nano Banana 2 Lite): 65 mil / 32 mil tokens, geração e edição de imagens ultrarrápida
• gemini-3.1-flash-tts-preview: texto para fala expressivo com prompt "Diretor"
• gemini-omni-flash-preview: geração de vídeo, geração de vídeo referenciada por imagem, do primeiro quadro ao vídeo e edição de vídeo
• gemma-4-31b-it: modelo denso Gemma 4, 31 bilhões de parâmetros
• gemma-4-26b-a4b-it: modelo MoE Gemma 4, 26 bilhões totais / 4 bilhões de parâmetros ativos

[!WARNING] Modelos como gemini-2.5-*, gemini-2.0-*, gemini-1.5-* são legados e obsoletos. Nunca os use. Se um usuário pedir um modelo obsoleto, use gemini-3.5-flash em vez disso e anote a substituição.

Agentes Atuais

• antigravity-preview-05-2026: Agente Antigravidade — agente gerenciado de propósito geral com execução de código, gerenciamento de arquivos e acesso à web em um ambiente Linux com sandbox
• deep-research-preview-04-2026: Pesquisa Profunda — rápido, interativo
• deep-research-max-preview-04-2026: Pesquisa Profunda Max — exaustividade máxima
• Agentes personalizados: Crie os seus próprios via client.agents.create()

SDKs Atuais

• Python: google-genai >= 2.3.0 → pip install -U google-genai
• JavaScript/TypeScript: @google/genai >= 2.3.0 → npm install @google/genai

[!NOTE] Versões do SDK ≥ 2.0.0 usam automaticamente o novo esquema de etapas e não suportam o esquema legado. SDKs legados google-generativeai (Python) e @google/generative-ai (JS) são obsoletos. Nunca os use.

Notas Adicionais Importantes

• Antes de escrever qualquer código, você DEVE buscar a página de documentação relevante na lista abaixo que corresponda à tarefa do usuário. Os exemplos nesta skill são mínimos, os docs hospedados contêm a superfície completa da API, parâmetros e casos extremos.
• As interações são armazenadas por padrão (store=true). O nível pago retém por 55 dias, o nível gratuito por 1 dia.
• Defina store=false para optar por não participar, mas isso desabilita previous_interaction_id e background=true.
• tools, system_instruction e generation_config são escopados por interação, reespecifique-os a cada turno.
• Agentes gerenciados exigem environment="remote" (ou um ID de ambiente / objeto de configuração) para provisionar um sandbox.
• Migrando de generateContent: Leia references/migration.md para o escopo, checklist e exemplos de código antes/depois. Sempre confirme o escopo com o usuário antes de editar.
• Atualizações de modelo: Substituição direta, troque a string do modelo. Modelos obsoletos (gemini-2.0-*, gemini-1.5-*) devem ser substituídos, veja references/migration.md.
• Migrando para Gemini 3.5 Flash: Leia references/migration.md para o escopo e checklist.

Início Rápido

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.5-flash",
    input="Tell me a short joke about programming."
)
print(interaction.output_text)

JavaScript/TypeScript

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: "gemini-3.5-flash",
    input: "Tell me a short joke about programming.",
});
console.log(interaction.output_text);

Auxiliares de Resposta

O SDK fornece propriedades de conveniência no objeto de resposta Interaction para simplificar padrões de acesso comuns: