O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Guia para desenvolvedores do Gemini 3.6 Flash

O Gemini 3.6 Flash é um modelo de alta velocidade e custo-benefício da família Gemini 3. Projetado para oferecer recursos agênticos quase profissionais sem comprometer o desempenho ou o valor, o modelo agora está em disponibilidade geral (GA) para desenvolvedores que usam a API Gemini e para empresas que usam a Gemini Enterprise Agent Platform.

Este documento aborda as novidades do 3.6 Flash, como ele se encaixa na família de modelos do Gemini, como migrar para o 3.6 Flash e oferece um guia de início rápido para usar o 3.6 Flash.

Como ele se encaixa na família Gemini?

O Gemini 3.6 Flash é o principal modelo de trabalho agêntico da família Gemini 3. Ele preenche a lacuna entre os modelos Gemini Pro de raciocínio profundo e os modelos Gemini Flash-Lite de alta capacidade de processamento. Em comparação com o Gemini 3.5 Flash, o 3.6 Flash oferece uma qualidade significativamente maior na orquestração de ferramentas em várias etapas, na refatoração de código full-stack e no raciocínio visual, usando menos tokens e turnos de raciocínio. Ele oferece recursos quase no nível do Pro com a velocidade e o preço do Flash.

Especificações e comparações de modelos

A tabela a seguir é uma comparação que abrange algumas das especificações entre o 3.6 Flash, o 3.5 Flash e o 3.1 Pro:

	Gemini 3.6 Flash	Gemini 3.5 Flash	Gemini 3.1 Pro
ID do modelo	`gemini-3.6-flash`	`gemini-3.5-flash`	`gemini-3.1-pro-preview`
Etapa do lançamento	GA	GA	Visualizar
Tipos de entrada	Texto, imagem, áudio, vídeo	Texto, imagem, áudio, vídeo	Texto, imagem, áudio, vídeo
Tipos de saída	Texto	Texto	Texto
Janela de contexto	1.048.576	1.048.576	1.048.576
Tamanho máximo do token de saída	65.536	65.536	65.536
Regiões compatíveis	Global, multirregional	Global, multirregional, Américas, Europa, Ásia-Pacífico	Global
Níveis de raciocínio disponíveis	`MINIMAL`, `LOW`, `MEDIUM`, `HIGH` (padrão: `MEDIUM`)	`MINIMAL`, `LOW`, `MEDIUM`, `HIGH` (padrão: `MEDIUM`)	`LOW`, `MEDIUM`, `HIGH` (padrão: `HIGH`)
Foco principal	Agentic Workflows de alta eficiência, orquestração em várias etapas e programação full-stack	Tarefas equilibradas, chamada de ferramentas e raciocínio intermediário	Tarefas de raciocínio profundo e alta complexidade

Consulte a página do modelo 3.6 Flash para ver a lista completa de recursos, ferramentas e opções de consumo compatíveis.

O que há de novo no Gemini 3.6 Flash?

O 3.6 Flash é otimizado para orquestração em várias etapas, refatoração de código full-stack e raciocínio geral com uma eficiência de tokens significativamente melhor do que os antecessores.

Atualizações de recursos e desempenho

Confira a seguir a lista de mudanças nos recursos e no desempenho do 3.6 Flash em relação aos modelos anteriores:

Redução de tokens e turnos: consome menos tokens e conclui fluxos de trabalho de várias etapas em menos etapas de raciocínio e turnos de conversa do que o 3.5 Flash.
Geração de código aprimorada: produz um código mais limpo com taxas mais baixas de falha de compilação e revisão em ambientes de criação de aplicativos, prototipagem e agentes de IDE.
Viés de ação reduzido: resolve tarefas de diagnóstico somente leitura sem fazer edições não solicitadas no espaço de trabalho ou mudar o estado prematuramente.
Raciocínio multimodal e espacial: oferece melhor desempenho na interpretação de gráficos, na conversão de plantas visuais e na geração de layouts da Web com vários elementos.
Suporte ao uso do computador: compatível como uma ferramenta integrada para automação UI de agente.
Preferência de estilo de interface: melhor na criação de código funcional, embora os avaliadores humanos tenham preferido os modelos anteriores para apresentação de front-end e layout visual. Isso pode ser mitigado com diretrizes de design explícitas.

Mudanças de comportamento e de parâmetros da API

Confira a seguir a lista de mudanças de comportamento e de parâmetros de API do 3.6 Flash em relação aos modelos anteriores:

Conciso: usa menos etapas de raciocínio do que o 3.5 Flash. Embora isso reduza a latência e o custo na refatoração de código e nos fluxos de trabalho de ferramentas, pode causar saídas antecipadas em acompanhamentos de conversas multiturno estendidos, em que cadeias de iteração mais longas são necessárias.
Inspeção programática antecipada: prefere executar scripts de código de diagnóstico (execute_code) para inspecionar problemas antes de mudar o estado com mais frequência do que o 3.5 Flash. Embora isso melhore a precisão do diagnóstico em refatorações complexas de back-end, às vezes pode levar à execução de etapas extras de inspeção exploratória em tarefas simples de script e Web de front-end, em que a versão anterior geraria código diretamente.
Esforço padrão: mantém o nível de esforço padrão médio introduzido no 3.5 Flash.
Sem substituições de amostragem: valores personalizados para os parâmetros temperature, top-k ou top-p não são mais aceitos. A definição de valores personalizados será ignorada na superfície da API. Em vez disso, use thinking_level ou esquemas JSON estruturados para controlar o determinismo da saída.
Restrições de penalidade de frequência e presença: valores personalizados para esses parâmetros não são mais aceitos. A definição deles agora vai gerar um erro de API ativa.
Não há suporte para solicitações de API em que a última vez de entrada tem um papel de "Modelo".
As interações vazias no histórico de conversas são descartadas.
As assinaturas de pensamento inválidas agora vão produzir erros.
Chamada de função estrita: FunctionResponse precisa corresponder estritamente a id, name e à contagem de execução do FunctionCall anterior. Anexe instruções inline diretamente no texto de resposta da função, separadas por duas novas linhas (\n\n).

Guia de início rápido

Antes de começar, autentique-se na Agent Platform usando o Application Default Credentials (ADC) ou uma chave de API. Consulte Começar a usar a Gemini Enterprise Agent Platform para mais informações.

Nos blocos de código a seguir, substitua PROJECT_ID pelo ID do projeto.

Instalação

Verifique se você está usando o SDK mais recente do google-genai:

pip install --upgrade google-genai

Solicitação básica

Python

from google import genai

client = genai.Client(enterprise=True, project="PROJECT_ID", location="global")

response = client.models.generate_content(
  model="gemini-3.6-flash",
  contents="How does AI work?",
)
print(response.text)

REST

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-3.6-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

Migrar para o 3.6 Flash do 3.5 Flash ou do 3.1 Pro

Para migrar do 3.5 Flash ou do 3.1 Pro para o 3.6 Flash, siga estas etapas:

Atualize o ID do modelo: mude a string do modelo nas chamadas de API para gemini-3.6-flash.
Adapte seu código às novas regras da API da família Gemini 3: o Gemini 3.6 Flash aplica estritamente as regras de parâmetros e as convenções de API estabelecidas em toda a família Gemini 3:
- Remover temperatura, top-K e top-P: remova esses parâmetros personalizados do payload. Embora não gerem um erro, o modelo vai ignorá-los completamente. Em vez disso, use o parâmetro thinking_level ou as saídas estruturadas json_schema para controlar o determinismo da saída.
- Remover penalidades de frequência e presença: remova todas as configurações personalizadas de penalidades de frequência ou presença para evitar que as chamadas de API gerem erros de tempo de execução.
- Verifique se a integração do chat não tenta preencher o modelo: revise as matrizes do histórico de mensagens para garantir que o payload da API não termine com uma vez de usuário ou de modelo vazia. Se o último objeto na matriz de histórico for um papel "model" (API GenerateContent) ou um tipo "model_output" (API Interactions), reestruture a sequência para evitar um erro de validação estrita.
- Use thinking_level: remova instâncias do parâmetro thinking_budget descontinuado e use thinking_level.
- Aplicar convenções estritas de chamada de função: o FunctionResponse precisa corresponder estritamente ao id, ao name e à contagem de execuções do FunctionCall anterior. Se você precisar anexar instruções inline, coloque-as diretamente no texto de resposta da função, separadas por duas linhas novas (\n\n).
Considere as mudanças no fluxo de trabalho:
- Se o aplicativo depende de loops de conversação de vários turnos, teste seus fluxos de trabalho para garantir que a nova concisão de etapas do modelo não acione saídas prematuras.
- Se estiver criando agentes de front-end ou de script básico, monitore chamadas execute_code exploratórias desnecessárias devido ao novo viés do modelo em relação à inspeção programática inicial.

Soluções alternativas para requisitos de texto pré-ferramenta

Se o comando exigir que o modelo gere texto estruturado (XLM, YAML, Json etc.) (por exemplo, <UPDATE>...</UPDATE>) imediatamente antes de fazer uma chamada de ferramenta, ela poderá falhar com um erro Malformed_Function_Call. Para resolver esse problema, use uma das seguintes soluções alternativas:

(Recomendado) Instrua o modelo a colocar as notas pré-ferramenta em uma chamada de função update() dedicada, em vez de texto bruto. Consulte a próxima seção para ver instruções detalhadas de implementação.
Instrua o modelo a escrever notas como cabeçalhos Markdown (por exemplo, # UPDATE, ## PLAN) em vez de texto estruturado.
Não exija que o modelo gere texto antes das chamadas de ferramenta.

Solução recomendada: envolver as notas de trabalho em uma chamada de função dedicada

Em vez da instrução original:

Before calling a tool, in every response you MUST first output a single
`<UPDATE>` part as specified, don't skip this part or any of required sub-tags
within `<UPDATE>`.

Use esta instrução atualizada:

Before calling any other tool, in every response you MUST first call `update`
with all required parameters (previous_step, plan, next_step, external).

Atualize todas as referências ao formato XML antigo de <UPDATE> na solicitação do cliente. Em seguida, adicione a declaração de função correspondente para a função de atualização:

{
  "name": "update",
  "description": "Update working notes (previous step analysis, plan, next step, external note).",
  "parameters": {
    "type": "OBJECT",
    "properties": {
      "previous_step": {
        "type": "STRING",
        "description": "Key findings and outcomes since the previous step."
      },
      "plan": {
        "type": "STRING",
        "description": "The current status of the plan."
      },
      "next_step": {
        "type": "STRING",
        "description": "Brief explanation of the immediate next action according to the plan."
      },
      "external": {
        "type": "STRING",
        "description": "A short, plain-language note shown to the User about what you are ABOUT TO DO next."
      }
    },
    "required": [
      "previous_step",
      "plan",
      "next_step",
      "external"
    ]
  }
}

O modelo vai fazer duas chamadas na mesma etapa: a chamada update() que substitui o XML estruturado e a chamada de função real que ele quer fazer.

Guia para desenvolvedores do Gemini 3.6 Flash Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.