Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Contexto é a informação que um modelo de IA usa para produzir sua próxima resposta. Gerenciamento de contexto é a prática de fornecer ao modelo as informações certas no momento certo. Isso importa porque a IA não funciona apenas a partir da sua intenção. Ela funciona a partir do texto, arquivos, capturas de tela, logs, exemplos e histórico de conversa disponíveis em sua janela de contexto.

​
O que é uma janela de contexto?

Um modelo de IA tem um limite de quanta informação pode considerar de uma vez. Esse limite é chamado de janela de contexto. A janela de contexto pode incluir:
  • Seu prompt
  • Mensagens anteriores na conversa
  • Arquivos ou código que o modelo pode ver
  • Mensagens de erro e logs
  • Capturas de tela, imagens ou referências de design
  • Instruções do projeto, como replit.md
  • Resultados de ferramentas de etapas anteriores
O modelo usa esse contexto para decidir o que gerar a seguir.

​
Por que as janelas de contexto são importantes

Se os detalhes importantes não estiverem no contexto, o modelo pode adivinhar. Se houver muitas informações não relacionadas no contexto, o modelo pode se concentrar na coisa errada. Por exemplo, este prompt oferece pouco contexto: 
Melhore a página de cadastro.
Este prompt fornece contexto útil: 
Melhore a página de cadastro para fundadores de primeira viagem que estão decidindo se devem entrar na lista de espera.
Mantenha os campos atuais. Torne a proposta de valor mais clara acima do formulário.
Não altere a seção de preços.
O segundo prompt informa ao modelo para quem é a página, o que melhorar, o que preservar e o que está fora do escopo.

​
Os tamanhos das janelas de contexto variam

Modelos de IA diferentes podem lidar com diferentes quantidades de contexto. Janelas de contexto maiores podem considerar mais texto de uma vez, mas maior nem sempre é melhor. Contexto relevante ainda importa mais do que despejar todos os detalhes na conversa. Exemplos de tamanhos públicos de janelas de contexto:
Família de modelosExemplo de janela de contexto
GPT-4.1Até 1 milhão de tokens
Claude Sonnet 4.5Até 200.000 tokens
Gemini 2.5 ProAté 1 milhão de tokens
Esses números mudam ao longo do tempo e não garantem que todo produto exponha o limite completo do modelo. A lição prática é estável: mantenha as informações importantes claras e focadas.

​
Tipos de contexto

Tipo de contextoExemplo
Objetivo”Esta landing page deve coletar inscrições para lista de espera.”
Público”Isso é para proprietários de restaurantes ocupados.”
Restrições”Mantenha a paleta de cores atual e os campos do formulário.”
Não-objetivos”Não adicione pagamentos ainda.”
ExemplosUma captura de tela, mockup, dados de amostra ou página de concorrente.
Estado do projetoO arquivo atual, componente, mensagem de erro ou fluxo do usuário.
Definição de pronto”Um visitante pode enviar o formulário e ver uma mensagem de agradecimento.”

​
Contexto fresco e contexto persistente

Algum contexto pertence à conversa atual. Use-o quando estiver pedindo uma mudança específica, depurando um problema ou dando feedback sobre um resultado recente. Outro contexto deve persistir em todo o projeto. Use contexto persistente para estilo de código, diretrizes de marca, convenções de nomenclatura, regras de produto reutilizáveis e restrições que o Agent deve lembrar entre sessões de trabalho. No Replit, replit.md é uma forma de fornecer ao Agent contexto persistente do projeto.

​
Quando o contexto fica ruidoso

Conversas longas podem derivar. Se um thread misturou muitas decisões não relacionadas, o Agent pode prestar atenção a contextos antigos que não importam mais. Inicie um novo thread quando:
  • Você muda para um recurso não relacionado
  • A conversa tem muitas direções abandonadas
  • O Agent continua aplicando restrições antigas
  • Você quer um plano limpo para uma nova área
Quando começar do zero, resuma o contexto importante em vez de presumir que o Agent sabe o que ainda importa. 
Contexto: este projeto é um app de lista de espera para personal trainers locais.
O fluxo principal é landing page → formulário de cadastro → mensagem de confirmação.
Para este thread, apenas melhore a mensagem de confirmação e o texto de acompanhamento.

​
Equívocos comuns

  • “Mais contexto é sempre melhor.” Contexto relevante é melhor. Contexto demais e não relacionado pode distrair o modelo.
  • “O modelo se lembra de tudo perfeitamente.” A IA usa o contexto disponível, mas você deve reafirmar restrições importantes quando elas importam.
  • “Contexto é apenas texto.” Capturas de tela, arquivos, dados, designs, logs e exemplos também podem ser contexto.

​
Para onde ir a seguir

Introdução à IA

Aprenda como os modelos de linguagem funcionam e como os agentes de IA usam modelos com ferramentas para agir.

Construir com o Agent

Aprenda como adicionar contexto enquanto trabalha com o Agent.

Prompts eficazes

Veja exemplos de prompts que incluem contexto útil.

replit.md

Aprenda como fornecer contexto persistente de projeto.