Memórias

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

Mantenha as orientações obrigatórias da equipa em AGENTS.md ou na documentação incluída no repositório. Considere as memórias uma camada útil de recordação, não a única fonte das 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 Definições > Personalização quando precisar de a ativar ou desativar.

O Histórico do computador é uma funcionalidade da aplicação para macOS que transforma a atividade nas aplicações e nos sites permitidos em memórias e numa cronologia que o ChatGPT e o Codex podem consultar.

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, oculta segredos nos campos de memória gerados e atualiza as memórias em segundo plano, em vez de o fazer imediatamente no fim de cada conversa.

As memórias podem não ser atualizadas assim que uma conversa termina. O Codex aguarda até que uma conversa esteja inativa durante 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 estiver abaixo do limiar configurado, para que o Codex não consuma a quota quando estiver próximo de um limite.

Armazenamento local de memórias

O Codex armazena as memórias no diretório inicial do Codex. Por predefinição, é ~/.codex. Consulte Localizações da configuração e do 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 recentes e provas de apoio de conversas anteriores.

Considere estes ficheiros como estado gerado. Pode inspecioná-los ao resolver problemas ou antes de partilhar o diretório inicial do Codex, mas não dependa da edição manual destes ficheiros como principal forma 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 das memórias 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 definições globais de memória.

Rever as memórias locais

Não guarde segredos nas memórias. O Codex oculta segredos nos campos de memória gerados, mas deve ainda assim rever os ficheiros de memória antes de partilhar o diretório inicial 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 Definições > Personalização e ative Ativar memórias.

Para uma configuração baseada no ficheiro de configuração, adicione o sinalizador da funcionalidade a config.toml:

[features]
memories = true

Para conhecer as localizações do ficheiro 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 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 memories.no_memories_if_mcp_or_web_search mais antiga continua a ser aceite como alias.
• memories.min_rate_limit_remaining_percent: controla a percentagem restante mínima do limite de utilização do Codex necessária antes do início da geração de memórias.
• memories.extract_model: substitui o modelo utilizado na extração de memórias por conversa.
• memories.consolidation_model: substitui o modelo utilizado na consolidação global de memórias.