Glossário
85 termos de “Memória e Estado de Agente”. Passe o cursor sobre a primeira ocorrência na lição para ver a definição.
| Termo | Definição | Fonte |
|---|---|---|
| sem estado | A propriedade de que o servidor não mantém nenhum estado privado por sessão entre uma chamada de API e a próxima, então toda requisição deve carregar o histórico completo da conversa por conta própria. | Using the Messages API |
| janela de contexto | O contêiner que guarda tudo o que o modelo de fato consegue ver em uma requisição: o system prompt, cada mensagem no array messages, as definições de ferramentas e a própria saída do modelo no turno. | Context windows |
| system prompt | Texto enviado com a requisição que define o papel e o comportamento do modelo; os docs oficiais o listam como um dos componentes que conta para a janela de contexto. | Context windows |
| definições de ferramentas | O name, description e input_schema que você passa ao modelo para descrever cada ferramenta disponível; os docs afirmam que contam para a janela de contexto da mesma requisição. | Context windows |
| raciocínio estendido | O conteúdo de raciocínio que o modelo produz ao gerar a resposta deste turno; os docs afirmam que conta para o uso da janela de contexto deste turno. | Context windows |
| usage | O campo na resposta da API que informa quantos tokens de entrada e saída a requisição de fato consumiu. | Context windows |
| context rot | O fenômeno nomeado nos docs oficiais onde a acurácia e a recuperação se degradam conforme a contagem de tokens na janela cresce. | Context windows |
| acúmulo | O comportamento padrão em que o histórico de conversa se empilha na janela de contexto turno após turno, crescendo e nunca encolhendo a menos que algo ativamente o limpe. | Context windows |
| reenvio | O mecanismo real por trás da palavra “memória” — toda requisição reenvia as mensagens de histórico anteriores ao modelo verbatim, em vez do modelo armazenar ou lembrar de algo por conta própria. | Using the Messages API |
| múltiplas sessões | O escopo de informação que tem que sobreviver a uma única conversa e durar entre sessões independentes, o que enfiá-la no array messages atual não consegue alcançar. | Context windows |
| Messages API | A API na qual este curso se apoia; seus docs oficiais afirmam claramente que é sem estado e que você sempre envia o histórico de conversa completo com cada requisição. | Using the Messages API |
| acrescentar | A forma mais simples de gerenciar o histórico de conversa — depois de cada turno, anexe as novas mensagens ao final do array messages existente e envie o array inteiro de novo no próximo turno. | Context windows |
| truncagem | Cortar de vez o lote mais antigo de mensagens quando a janela está quase cheia e manter apenas os N mais recentes — simples de implementar, mas o que descarta se foi irreversivelmente. | Context windows |
| compactação | O mecanismo oficial que destila o conteúdo de uma janela de contexto em um resumo de alta fidelidade, deixando o agente continuar com degradação mínima de desempenho quando a conversa fica longa. | Context engineering: memory, compaction, and tool clearing |
| resumo de alta fidelidade | O que a compactação produz — uma versão destilada que substitui a longa sequência de histórico bruto e fica à frente da janela, mantendo o que aconteceu e o que foi concluído enquanto descarta o detalhe palavra-por-palavra. | Context engineering: memory, compaction, and tool clearing |
| limiar de disparo | O nível de uso da janela no qual um mecanismo oficial começa automaticamente a compactar ou limpar resultados de ferramentas. | Context engineering: memory, compaction, and tool clearing |
| limpeza de resultados de ferramenta | O mecanismo oficial voltado ao inchaço do próprio uso de ferramenta — descarta resultados antigos e rebuscáveis enquanto mantém o registro de que a chamada aconteceu. | Context engineering: memory, compaction, and tool clearing |
| rebuscável | O qualificador que decide o que a limpeza pode descartar — conteúdo que a ferramenta retornou que ficou obsoleto e pode ser obtido de novo chamando a mesma ferramenta com os mesmos argumentos. | Context engineering: memory, compaction, and tool clearing |
| 150K tokens | O limiar de disparo padrão da compactação — a compactação dispara automaticamente quando o uso da janela atinge este nível. | Context engineering: memory, compaction, and tool clearing |
| 100K tokens | O limiar de disparo padrão da limpeza de resultados de ferramenta, menor que os 150K da compactação, refletindo seu papel de entrar mais cedo contra a fonte única de inchaço da saída de ferramenta. | Context engineering: memory, compaction, and tool clearing |
| 50K tokens | O piso imposto pelo servidor para o limiar de disparo da compactação — o valor configurado deve ser pelo menos este grande, então o limiar não pode ser baixado arbitrariamente. | Compaction |
| últimas 3 chamadas | A política de retenção padrão da limpeza de resultados de ferramenta — os resultados completos das últimas três chamadas de ferramenta ficam intactos, e resultados de ferramentas mais antigos são limpos. | Context engineering: memory, compaction, and tool clearing |
| modelo mental | A divisão de trabalho de três vias do Cookbook para lidar com inchaço de contexto — compactação para uma janela que cresceu demais, limpeza para dados obsoletos e rebuscáveis dentro dela, memória para sobreviver entre sessões. | Context engineering: memory, compaction, and tool clearing |
| uso da janela | A medida de quanta capacidade de janela de contexto o histórico de conversa atual ocupa; é o que você verifica para decidir se truncar, compactar ou limpar. | Context engineering: memory, compaction, and tool clearing |
| transcrição inteira | O escopo da compactação — mensagens do usuário, mensagens do assistente, chamadas de ferramenta, resultados de ferramentas e até blocos de compactação anteriores são todos achatados no novo resumo. | Context engineering: memory, compaction, and tool clearing |
| ida e volta | Uma troca completa de chamada de ferramenta — a mensagem assistant carregando tool_use mais a mensagem user carregando o tool_result correspondente — a menor unidade que o fatiamento de histórico pode tratar como atômica. | Handle tool calls |
| tool_use_id | O identificador ligando um bloco tool_result de volta ao bloco tool_use que o produziu; a limpeza substitui o conteúdo do resultado mas deixa este id no lugar. | Handle tool calls |
| memória externa | Armazenamento que não está preso ao ciclo de vida de uma única conversa — geralmente um arquivo em disco — então informação escrita lá ainda pode ser lida depois que a sessão termina. | Context engineering: memory, compaction, and tool clearing |
| arquivo de memória | Um arquivo mantido em disco para carregar informação entre sessões — CLAUDE.md sendo o caso representativo — que pode ser carregado no contexto no todo ou em parte quando uma sessão começa. | How Claude remembers your project |
| carregado na janela de contexto | O processo pelo qual o conteúdo de um arquivo de memória é lido do disco e injetado em uma requisição específica, tornando-o visível ao modelo para aquele turno. | How Claude remembers your project |
| comentários HTML de nível de bloco | Conteúdo embrulhado em <!-- --> dentro de um arquivo CLAUDE.md; os docs afirmam que é removido antes do conteúdo ser injetado no contexto do agente. | How Claude remembers your project |
| Auto memory | Memória escrita pelo próprio modelo conforme a conversa avança, estruturada como um arquivo de índice mais arquivos de tópico sob demanda, complementando o CLAUDE.md escrito por humanos. | How Claude remembers your project |
| arquivo de índice | A primeira camada da estrutura de duas camadas da Auto memory — MEMORY.md, por exemplo — que armazena resumos de entrada por tópico em vez do conteúdo completo de cada tópico. | How Claude remembers your project |
| recuperação sob demanda | Carregar apenas os resumos de entrada do índice no início da sessão, e ler um arquivo de memória de tópico específico apenas quando a tarefa atual de fato precisa dele. | How Claude remembers your project |
| MEMORY.md | O arquivo de índice da Auto memory; a regra oficial é que apenas suas primeiras 200 linhas ou primeiros 25KB, o que vier primeiro, carregam no início de cada conversa. | How Claude remembers your project |
| CLAUDE.md | Um arquivo de memória de projeto escrito por humanos carregado por inteiro no contexto no início de toda sessão; a meta de tamanho oficial é abaixo de 200 linhas, com um limite rígido de 4 MiB. | How Claude remembers your project |
| 200 linhas | A meta de tamanho oficial recomendada para um arquivo CLAUDE.md; passar disso consome mais contexto e reduz a aderência do agente às instruções. | How Claude remembers your project |
| 4 MiB | O limite rígido genuíno para CLAUDE.md — um arquivo até este tamanho é carregado por inteiro, e qualquer coisa maior é ignorada inteiramente. | How Claude remembers your project |
| /compact | O comando de compactação no Claude Code; os docs notam que um CLAUDE.md na raiz do projeto sobrevive a ele, sendo relido do disco e reinjetado na sessão depois. | How Claude remembers your project |
| verificação de limite | Lógica de verificação de caminho adicionada à ferramenta de leitura/escrita de um arquivo de memória para que a ferramenta não possa ser convencida a ler ou escrever arquivos fora do diretório de memória. | How Claude remembers your project |
| diretório irmão de mesmo prefixo | O diretório que derrota uma verificação de prefixo de string pura — /project/memory-evil compartilha o prefixo /project/memory e então passa startsWith, mesmo que esteja inteiramente fora da raiz de memória. | How Claude remembers your project |
| path.sep | A constante do Node para o separador de caminho da plataforma, usada na condição de limite segura abs.startsWith(ROOT + path.sep) para que apenas caminhos começando com “raiz mais separador” combinem. | How Claude remembers your project |
| estado estruturado | Progresso de tarefa expresso através de campos fixos — uma lista de todos com marcadores de status explícitos — que o código hospedeiro pode analisar de forma confiável, em oposição ao progresso descrito em prosa. | Track todos |
| lista de todos | Uma tarefa de múltiplas etapas dividida em um conjunto de itens, cada um carregando um campo de status explícito, então o agente e o código hospedeiro conseguem rastrear progresso juntos. | Track todos |
| ciclo de vida | As quatro etapas pelas quais um todo passa desde o momento em que é identificado até não ser mais necessário: criado, ativado, concluído, removido. | Track todos |
| pending | O primeiro estado no ciclo de vida de um todo — o item foi identificado e adicionado à lista, mas o trabalho nele não começou. | Track todos |
| in_progress | O segundo estado no ciclo de vida de um todo — quando o trabalho de fato começa, o status muda de pending para este valor. | Track todos |
| completed | O terceiro estado no ciclo de vida de um todo — o status definido quando a tarefa termina com sucesso. | Track todos |
| deleted | O quarto estado no ciclo de vida de um todo — um todo que não é mais necessário é removido definindo seu status para este valor em uma chamada TaskUpdate. | Track todos |
| ferramenta de acompanhamento de tarefas | A ferramenta que deixa um agente criar e atualizar status de todos, então o progresso de tarefa aparece no fluxo de mensagens como chamadas de ferramenta estruturadas. | Track todos |
| chamada de ferramenta estruturada | A forma na qual uma mudança de status de acompanhamento de tarefa aparece no fluxo de mensagens — uma chamada identificável e independentemente analisável em vez de uma linha de prosa. | Track todos |
| checkpoint | O estado de uma tarefa em um ponto no tempo escrito como dado e persistido em algum lugar fora do tempo de vida da sessão, então a execução pode retomar depois de uma interrupção. | Track todos |
| recuperabilidade | A habilidade, depois de um reinício de processo, de ler o checkpoint mais recente e continuar de onde o trabalho parou em vez de começar do zero. | Track todos |
| idempotente | A propriedade de uma operação que produz o mesmo resultado não importa quantas vezes rode, então rerodá-la não causa efeitos colaterais extras. | Track todos |
| TaskUpdate | A chamada de ferramenta usada para mudar o status de um todo; toda etapa do ciclo de vida, remoção incluída, passa por ela. | Track todos |
| MemoryTrap | Uma vulnerabilidade real divulgada por pesquisadores da Cisco descrevendo como uma rotina aparentemente inofensiva — clonar um repo, aprovar uma instalação de dependência — vira injeção de prompt persistente. | Memory Is a Feature. It Is Also an Attack Surface |
| ASI06 | O identificador de categoria de risco da OWASP para segurança de agente cobrindo Envenenamento de Memória & Contexto, a classe para a qual o MemoryTrap mapeia. | Memory Is a Feature. It Is Also an Attack Surface |
| memória persistente | Armazenamento que um agente lê e confia entre sessões; porque é carregada automaticamente e repetidamente, qualquer coisa escrita lá molda comportamento futuro, não apenas uma resposta. | Memory Is a Feature. It Is Also an Attack Surface |
| injeção de prompt persistente | No que um fluxo de trabalho de desenvolvedor rotineiro virou no MemoryTrap — conteúdo injetado que não fica confinado a um turno mas é escrito onde será recarregado e reconfiado em sessões futuras. | Memory Is a Feature. It Is Also an Attack Surface |
| memória desatualizada | Conteúdo em memória persistente que era uma vez correto mas não mais se aplica, e ainda é executado como uma regra atualmente válida simplesmente porque está parado na memória. | Memory Is a Feature. It Is Also an Attack Surface |
| superfícies confiáveis | Lugares como memória, hooks e configuração que o sistema carrega repetidamente como fonte confiável, então conteúdo malicioso atingindo-as pode ser explorado repetidas vezes. | Memory Is a Feature. It Is Also an Attack Surface |
| raciocínio futuro | O que um atacante de fato influencia uma vez que conteúdo malicioso atinge uma superfície confiável — não esta única resposta, mas o raciocínio do modelo entre muitas sessões futuras. | Memory Is a Feature. It Is Also an Attack Surface |
| configuração de hooks | A configuração global que, ao lado da memória persistente, conteúdo malicioso também atingiu no caso MemoryTrap — outro armazenamento que o sistema carrega e confia repetidamente. | Memory Is a Feature. It Is Also an Attack Surface |
| camada de instrução altamente confiável | A camada que o conteúdo malicioso do MemoryTrap influenciou através do system prompt — uma fonte de instruções que o sistema concede alto grau de confiança. | Memory Is a Feature. It Is Also an Attack Surface |
| envenenamento de memória | Conteúdo malicioso ativamente escrito em memória persistente ou outra superfície confiável, então armazenamento que deveria ser confiável em vez disso carrega o payload de um atacante. | Memory Is a Feature. It Is Also an Attack Surface |
| credenciais | Chaves, senhas e tokens de acesso — conteúdo que, uma vez escrito em um arquivo de memória carregado automaticamente, é reexposto na janela toda sessão sem benefício correspondente. | Memory Is a Feature. It Is Also an Attack Surface |
| texto bruto não confiável | Conteúdo de arquivo, texto web e saída de dependência que um agente lê ao fazer uma tarefa — dados de entrada para aquela única tarefa, não algo para ser copiado verbatim em memória persistente. | Memory Is a Feature. It Is Also an Attack Surface |
| Regras e fatos estáveis e confirmados | Conteúdo de uma fonte claramente confiável que um humano confirmou — convenções de estilo de código, uma causa raiz estabelecida por investigação real — o tipo que vale a pena escrever em memória persistente. | Memory Is a Feature. It Is Also an Attack Surface |
| ferramentas de leitura/escrita de memória | O par de ferramentas (read_memory / write_memory) que deixa um agente escrever conteúdo que vale a pena manter para além da janela e recuperar o que armazenou antes. | How Claude remembers your project |
| raiz de memória | O diretório dedicado aos arquivos de memória (MEMORY_ROOT no código); toda operação que as ferramentas de leitura/escrita de memória realizam está confinada a ele. | How Claude remembers your project |
| write_memory | A ferramenta que escreve texto em um arquivo sob a raiz de memória; sua descrição especifica o limite do “que armazenar” que a Lição 5 estabeleceu. | How Claude remembers your project |
| orientação em nível de prompt | Uma regra expressa apenas na descrição de uma ferramenta, que guia a tendência comportamental do modelo mas não é imposta por código da forma que uma verificação de caminho é. | Memory Is a Feature. It Is Also an Attack Surface |
| reinjeção de memória entre sessões | Lógica que ativamente lê arquivos de memória quando uma nova sessão começa e injeta seu conteúdo como uma mensagem inicial, então a memória está na janela desde o primeiríssimo turno. | How Claude remembers your project |
| compactação feita à mão | A implementação de ensino simplificada de compactação deste curso — disparar em um orçamento de caracteres, dividir o histórico em limites de ida-e-volta completos, depois fazer uma chamada ao modelo para gerar o resumo. | Context engineering: memory, compaction, and tool clearing |
| compact_20260112 | O identificador para o recurso de compactação nativa da Anthropic, disparando a 150K tokens por padrão — o mecanismo que a versão feita à mão da lição meramente imita. | Context engineering: memory, compaction, and tool clearing |
| clear_tool_uses_20250919 | O identificador para o recurso de limpeza de resultados de ferramenta nativa da Anthropic, disparando a 100K tokens por padrão e mantendo os resultados das últimas 3 chamadas. | Context engineering: memory, compaction, and tool clearing |
| orçamento de caracteres | Uma aproximação de ensino grosseira que mede uso de tokens por contagem de caracteres para decidir se o histórico precisa de compactação; não é uma contagem precisa de tokens. | Context engineering: memory, compaction, and tool clearing |
| splitKeepingToolPairs | O ajudante que decide onde cortar o histórico para compactação, recuando o ponto de corte até que um par tool_use / tool_result não esteja mais dividido entre o resumo e a porção mantida. | Handle tool calls |
| mensagem de resumo | A mensagem única que uma compactação feita à mão produz para substituir o histórico anterior, emendada à frente do array messages. | Context engineering: memory, compaction, and tool clearing |
| chamada de resumo | A chamada extra ao modelo que uma compactação feita à mão faz para gerar o resumo — um dos custos concretos de compactar. | Context engineering: memory, compaction, and tool clearing |
| conteúdo de placeholder | O texto substituto que uma função de limpeza feita à mão troca pelo conteúdo de tool_result antigo além da contagem a manter, deixando o tool_use_id intocado. | Context engineering: memory, compaction, and tool clearing |
| contagem a manter | O número de chamadas de ferramenta mais recentes cujos resultados completos são preservados pela limpeza; resultados além dela são substituídos por conteúdo de placeholder, ecoando o padrão nativo de 3. | Context engineering: memory, compaction, and tool clearing |
| poda de histórico | A capacidade que esta lição adiciona ao loop de execução para que uma conversa longa não inche para sempre, cobrindo tanto compactação feita à mão quanto limpeza de resultados de ferramenta. | Context engineering: memory, compaction, and tool clearing |
| TOOLS | A tabela única registrando o schema e a função de implementação de cada ferramenta; o loop deriva toolSchemas e toolHandlers dela. | How tool use works |
| loop com memória | O loop terminado que esta lição constrói — o loop de execução do curso de tool calling com leitura/escrita de memória, reinjeção de memória, compactação feita à mão e limpeza de resultados de ferramenta todos encaixados. | How tool use works |