Gemini 2.5 Flash-Lite: escrevendo um briefing claro para um jogo de vocabulário

O Google adicionou o Gemini 2.5 Flash-Lite à sua família de modelos como prévia em 17 de junho de 2025. O lançamento estável chegou em 22 de julho de 2025, com foco em processamento rápido e econômico para tarefas como tradução e classificação. Uma maneira útil de conhecer o modelo é fornecer a ele um pequeno software para construir — e descrever exatamente como esse software deve se comportar. 1

Meu exemplo foi um jogo de vocabulário com dez questões. Em 2 de novembro de 2026, uma solicitação através da API Crazyrouter retornou um arquivo HTML completo em cerca de 18,1 segundos. Eu havia fornecido as questões, respostas, explicações e requisitos de interação em chinês. A primeira versão precisou de correções locais antes de se tornar a demonstração vinculada abaixo.

A parte útil do exercício foi decidir o que “fazer um quiz” realmente significava. Qual resposta conta? O que acontece depois da última questão? O que um jogador deve ver quando não há erros? Essas decisões pertencem ao brief, mesmo em um jogo pequeno.

Dê ao Gemini 2.5 Flash-Lite o material e as decisões de que ele precisa

Um modelo de IA gera uma resposta a partir das instruções e do material que você envia. Uma API permite que um aplicativo troque essas mensagens com o modelo. Aqui, o Crazyrouter forneceu a conexão, e o Gemini 2.5 Flash-Lite produziu a página e a lógica do jogo.

O Google documenta entradas de texto, imagem, áudio, vídeo e PDF para este modelo, com saída em texto. O suporte de cada provedor a essas entradas precisa ser verificado separadamente. Minha solicitação usou apenas texto. HTML, estilos e JavaScript podem ser retornados como texto, portanto uma resposta em texto pode conter uma pequena página web inteira. [3]

Forneci um banco de questões em vez de pedir ao modelo que também inventasse a lição. Cada item já tinha quatro alternativas, uma resposta correta e uma explicação. Isso me deu uma referência para verificar a página gerada. O experimento avaliou como o modelo montou um material pronto em um jogo; não avaliou a criação independente de conteúdo curricular.

Um brief útil reúne vários tipos de decisão. Veja como eu explicaria as usadas neste projeto; estes são resumos em inglês dos requisitos originais, não a redação de um prompt em inglês testado separadamente.

Parte do brief Decisão a tornar explícita
Material de aprendizagem Usar as questões, os gabaritos e as explicações fornecidos.
Envio da resposta Aceitar uma resposta por questão e depois bloquear as alternativas.
Fim de uma rodada Mostrar o resultado e deixar clara a próxima ação.
Prática das questões erradas Incluir apenas as questões erradas e calcular uma nova pontuação máxima.
Entrega do arquivo Retornar um único arquivo HTML completo, sem imagens ou fontes externas.

Especificar esses detalhes também mostra o que examinar depois. Um pedido de um “quiz limpo e envolvente” deixa espaço para uma página bonita que lida mal com o fim de uma rodada.

Descreva ao Gemini 2.5 Flash-Lite os caminhos menos óbvios

A maioria das pessoas se lembra de descrever uma resposta correta. Os outros caminhos merecem a mesma atenção.

Neste jogo, uma resposta correta vale dez pontos e uma resposta errada não vale nenhum. Se um jogador acerta sete questões, o resultado é 70. Repetir os três erros cria uma rodada menor que vale 30 pontos. Recomeçar o quiz completo precisa restaurar as dez questões e apagar o resultado anterior.

Essas regras estão ligadas entre si. “Quero praticar meus erros” exige uma definição de quais questões entram nessa rodada, quantos pontos estão disponíveis e o que acontece depois. Uma rodada perfeita também precisa de uma resposta útil, porque não há nada para praticar.

O primeiro arquivo gerado acertou os principais casos de pontuação. No entanto, faltavam quatro requisitos: o último botão ainda dizia “Próxima questão”, a revisão das respostas omitia as explicações, a tela de pontuação máxima não tinha uma mensagem explícita de que não houve erros, e o título do feedback não indicava a palavra correta.

Esses detalhes tinham sido solicitados. A ausência deles é um motivo para comparar a saída com o brief, mesmo quando a resposta está completa. Um prompt mais longo, por si só, não comprovaria que o jogo resultante estava correto.

Corrigi as quatro omissões localmente, sem outra chamada ao modelo. Também adicionei proteções de estado, ajustei o comportamento do teclado e revisei os estilos para telas estreitas. O arquivo original passou em sete de onze verificações automatizadas; o arquivo corrigido passou nas onze no jsdom, que simula os elementos da página e executa seus scripts. A aparência em um navegador real e a interação por toque no celular continuam sem verificação.

Para uma mudança futura, descreva o que passa a ser diferente. Adicionar um cronômetro, por exemplo, exigiria uma regra para as questões sem resposta quando o tempo acabar. O jogo compartilhado não tem cronômetro; este é um exemplo de decisão a resolver antes de pedir esse recurso.

Leia o resultado do Gemini 2.5 Flash-Lite como um arquivo que você vai manter

A solicitação usou o ID de modelo gemini-2.5-flash-lite e retornou HTTP 200. A geração terminou normalmente, sem atingir o limite de saída. A medição de 18,1 segundos cobre essa única solicitação, excluindo preparação, inspeção e correções.

Você pode experimentar o jogo de vocabulário corrigido ou baixar o código-fonte HTML. As frases estão em inglês; os controles, as traduções e as explicações permanecem em chinês simplificado. “开始闯关” inicia o quiz, “下一题” passa para a próxima questão e “查看成绩” abre o resultado.

Depois de salvo, o arquivo contém tudo de que esta versão precisa para fazer as perguntas e calcular a pontuação. A resposta de um jogador não volta para o modelo. Atualizar a página não cria uma nova lição, e o jogo não guarda nenhum histórico de aprendizagem entre sessões.

Isso dá à próxima revisão um ponto de partida claro. Você pode trocar o banco de questões preservando as interações, ou traduzir a interface mantendo a lição. Qualquer uma dessas mudanças exige sua própria revisão. Não executei um novo teste de geração em inglês nem criei uma interface em inglês para esta demonstração.

Outros usos pequenos incluem extrair um conjunto fixo de campos de um aviso ou classificar mensagens em categorias definidas. O Google lista a extração simples de dados e a classificação entre as tarefas previstas para o modelo. A mesma preparação se aplica: decida quais informações precisam ser mantidas e como é um resultado válido. Esses usos não foram testados neste experimento com o jogo. [3]

Conecte o Gemini 2.5 Flash-Lite e envie seu próprio brief

Verifique o acesso ao modelo antes de preparar uma solicitação grande. Em 2 de novembro de 2026, a documentação da Gemini Developer API do Google limita os modelos 2.5 a usuários que já os utilizavam ativamente. O Google Cloud lista separadamente 20 de outubro de 2026 como data de aposentadoria deste modelo e observa que a Gemini API segue um ciclo de vida diferente. A disponibilidade é específica do serviço que você usa. 3

Confirmei o modelo na lista de modelos da minha conta do Crazyrouter antes de gerar o jogo. A página do modelo Gemini 2.5 Flash-Lite é um lugar para verificar as informações de conexão e, depois, os modelos disponíveis para a sua própria conta.

Em um cliente que aceite uma conexão personalizada compatível com OpenAI, insira sua chave de API do Crazyrouter, defina a Base URL como https://api.crazyrouter.com/v1 e selecione gemini-2.5-flash-lite. Uma chamada HTTP direta usa POST para https://api.crazyrouter.com/v1/chat/completions, autenticação Bearer e um corpo de requisição em JSON. Coloque as instruções e o material em messages; o texto retornado fica em message.content dentro do primeiro item de choices. [4]

Envie o banco de questões preparado junto com as regras de comportamento e peça um documento HTML completo. Salve o documento retornado com a extensão .html, removendo qualquer explicação ou formatação Markdown ao redor. Mantenha a chave de API na configuração privada do seu cliente ou servidor, fora do arquivo que você entrega aos jogadores.

Antes de compartilhar sua versão, pegue cada frase do brief e encontre onde a página a cumpre. Se “revisar a explicação” não tiver conteúdo correspondente na tela, você tem uma mudança específica a fazer. Um brief que ajuda a encontrar essa omissão já está fazendo um trabalho útil.


Fontes verificadas em 2 de novembro de 2026:

[1] Google: Anúncio da prévia do Flash-Lite, 17 de junho de 2025.

[2] Google Developers Blog: Lançamento estável, 22 de julho de 2025.

[3] Google AI for Developers: Documentação do Gemini 2.5 Flash-Lite.

[4] Crazyrouter: Documentação da API e formato da solicitação.

[5] Google Cloud: Especificações e ciclo de vida do modelo.