Memórias

As memórias permitem que o ChatGPT e o Codex transportem contexto útil de trabalhos anteriores para trabalhos futuros. A versão Web do ChatGPT utiliza a memória do ChatGPT, enquanto os clientes locais do Codex utilizam um armazenamento local de memórias e controlos separados.

Mantenha as orientações obrigatórias da equipa em AGENTS.md ou em documentação adicionada ao repositório. Considere as memórias uma camada útil de recuperação, e não a única fonte de regras que têm de ser sempre aplicadas.

Na aplicação ChatGPT para computador, utilize /memories para escolher se uma conversa pode utilizar memórias locais ou contribuir para memórias futuras. Faça a gestão da funcionalidade em Settings > Personalization quando precisar de a ativar ou desativar.

O Chronicle é uma funcionalidade exclusiva da aplicação para computador que ajuda o Codex a recuperar contexto de trabalho recente do seu ecrã para criar memória.

Como funcionam as memórias locais do Codex

Depois de ativar as memórias, o Codex pode transformar contexto útil de conversas anteriores elegíveis em ficheiros de memória locais. O Codex ignora sessões ativas ou de curta duração, omite segredos dos campos de memória gerados e atualiza as memórias em segundo plano, em vez de o fazer imediatamente no final de cada conversa.

As memórias podem não ser atualizadas imediatamente após o fim de uma conversa. O Codex aguarda até que uma conversa esteja inativa há tempo suficiente para evitar resumir trabalho que ainda está em curso.

A geração de memórias também pode ignorar uma execução em segundo plano quando a percentagem restante do limite de utilização do Codex está abaixo do limiar configurado, para que o Codex não consuma quota quando estiver perto de um limite.

Armazenamento local de memórias

O Codex armazena as memórias no seu diretório principal do Codex. Por predefinição, este é ~/.codex. Consulte Localizações de configuração e estado para saber como o Codex utiliza CODEX_HOME.

Os principais ficheiros de memória encontram-se em ~/.codex/memories/ e incluem resumos, entradas persistentes, dados introduzidos recentemente e elementos comprovativos de conversas anteriores.

Considere estes ficheiros como estado gerado. Pode inspecioná-los ao resolver problemas ou antes de partilhar o seu diretório principal do Codex, mas não dependa da sua edição manual como principal meio de controlo.

Controlar as memórias locais por conversa

Na aplicação ChatGPT para computador e na TUI do Codex, utilize /memories para controlar o comportamento da memória na conversa atual. As opções ao nível da conversa permitem decidir se a conversa atual pode utilizar memórias existentes e se o Codex pode utilizar a conversa para gerar memórias futuras.

As opções ao nível da conversa não alteram as suas definições globais de memória.

Rever as memórias locais

Não armazene segredos nas memórias. O Codex omite segredos dos campos de memória gerados, mas deve, ainda assim, rever os ficheiros de memória antes de partilhar o seu diretório principal do Codex ou artefactos de memória gerados.

Configurar as memórias locais

As memórias locais do Codex estão desativadas por predefinição. Na aplicação ChatGPT para computador, abra Settings > Personalization e ative Enable memories.

Para configurar através de um ficheiro de configuração, adicione o sinalizador da funcionalidade a config.toml:

[features]
memories = true

Para conhecer as localizações dos ficheiros de configuração e a lista completa de definições relacionadas com memórias, consulte Noções básicas de configuração e a referência de configuração.

As definições comuns específicas de memórias incluem:

• memories.generate_memories: controla se as conversas recém-criadas podem ser armazenadas como dados de entrada para a geração de memórias.
• memories.use_memories: controla se o Codex introduz memórias existentes em sessões futuras.
• memories.disable_on_external_context: quando definido como true, exclui da geração de memórias as conversas que utilizaram contexto externo, como chamadas de ferramentas MCP, pesquisa na Web ou pesquisa de ferramentas. A chave anterior memories.no_memories_if_mcp_or_web_search continua a ser aceite como alias.
• memories.min_rate_limit_remaining_percent: controla a percentagem mínima restante do limite de utilização do Codex necessária para iniciar a geração de memórias.
• memories.extract_model: substitui o modelo utilizado para a extração de memória por conversa.
• memories.consolidation_model: substitui o modelo utilizado para a consolidação global de memórias.