Skip to main content

Scratchpad

PARA AGENTES DE IAChatGPTClaude

Uma área temporária de memória de trabalho na janela de contexto do modelo, onde o agente registra seus raciocínios intermediários, planos, dúvidas e conclusões antes de invocar ferramentas. Oculta da visão do usuário final para manter a limpeza da interface.

1. Visão geral do conceito e propósito

Ao resolver uma equação matemática complexa ou planejar um itinerário de viagem intricado, raramente você escreve a versão final diretamente:

  • Você pega um rascunho (uma folha de papel).
  • Realiza cálculos intermediários, risca opções incorretas, desenha setas.
  • E somente quando a resposta fecha — transfere o resultado final para o formulário oficial.

A Inteligência Artificial precisa desse mesmo "rascunho".

O Scratchpad do Agente (Agent Scratchpad) é um campo interno para o monólogo da modelo:

  • Aqui o agente mantém em mente: "O que já fiz? Qual é o meu próximo passo? Por que a requisição anterior retornou um array vazio?".
  • Assim que o rascunho contém a conclusão correta, o agente executa a ação ou formula a resposta final para o humano.

Analogia prática: uma zona privada de raciocínio, onde a IA tem permissão para duvidar, errar e analisar seus próprios passos.

2. Como o scratchpad funciona por baixo dos panos

┌─────────────────────────────────────────────────────────────┐
│                 JANELA DE CONTEXTO DO AGENTE                │
├─────────────────────────────────────────────────────────────┤
│ 👤 SOLICITAÇÃO HUMANA: «Atualize o status do cliente #12 para VIP» │
├─────────────────────────────────────────────────────────────┤
│ 🧠 RASCUNHO OCULTO (<scratchpad>):                          │
│    «Sim, preciso encontrar o cliente 12. Primeiro, vou      │
│    verificar se esse ID existe no sistema usando a função   │
│    get_client.                                              │
│    Chamando get_client(12)...                               │
│    Vejo o resultado: valor total de compras do cliente é    │
│    150.000 UAH (hryvnias ucranianas).                       │
│    De acordo com as regras, isso corresponde ao status VIP. │
│    Agora posso chamar set_status('VIP') com segurança.»     │
├─────────────────────────────────────────────────────────────┤
│ 💬 RESPOSTA FINAL PARA O USUÁRIO:                           │
│    «Status do cliente #12 atualizado com sucesso para VIP!» │
└─────────────────────────────────────────────────────────────┘

3. Por que o scratchpad aumenta drasticamente a precisão do agente

  1. Proteção contra ações impulsivas: sem o rascunho, a modelo tenta chamar uma função logo na primeira palavra e frequentemente insere parâmetros inventados ou incompletos.
  2. Controle do histórico de ações: no scratchpad, o agente registra a lista de sites já verificados para evitar loops com os mesmos links.
  3. Facilidade de debug para o desenvolvedor: se o agente agir de forma estranha, o engenheiro abre os logs do scratchpad e vê literalmente qual linha de raciocínio levou a modelo à conclusão incorreta.

4. Conclusão prática

Se você está criando seu próprio agente, sempre adicione ao system prompt a exigência de manter um rascunho: "Antes de invocar qualquer ferramenta, obrigatoriamente escreva seu raciocínio e plano dentro de um bloco <thought>...</thought>". Isso reduz a quantidade de erros em 40–50%.

/ Perguntas FrequentesSchema.org FAQPage

FAQ: Scratchpad

Como os transformers geram respostas token por token, o modelo não consegue 'pensar em silêncio' sem emitir palavras. O scratchpad permite que o modelo gere várias frases de análise da situação antes de invocar comandos perigosos ou irreversíveis (como transferências de fundos ou exclusão de arquivos).
/ Links internos

Termos relacionados

Todos os termos
Agents & MCP

Ciclo de Ação do Agente (Thought ➔ Action ➔ Observation / ReAct)

Padrão algorítmico fundamental para o funcionamento de agentes autônomos (conhecido como ReAct: Reasoning + Acting). Consiste em um ciclo contínuo de três etapas: 1) Thought (Pensamento) — análise da situação; 2) Action (Ação) — invocação de uma ferramenta; 3) Observation (Observação) — análise do resultado e ajuste do plano.

Ler termo
Prompts & RAG

A Magia da Frase \"Pense Passo a Passo\" (Step-by-Step)

Técnica lendária de engenharia de prompts (Zero-Shot Chain-of-Thought). A adição da frase mágica \"Pense passo a passo\" força a rede neural a desdobrar uma cadeia de cálculos intermediários, reduzindo a quantidade de erros lógicos em 50–70%.

Ler termo
Modelos & Inferência

Orçamento de Raciocínio (Thinking Budget em Novos Modelos)

Novo parâmetro dos modelos modernos de raciocínio híbrido (Claude 3.7 Sonnet, OpenAI o1/o3). Permite que o usuário defina independentemente o limite de tokens ou segundos que a inteligência artificial pode gastar no raciocínio interno antes da resposta final.

Ler termo