Memórias

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 de computador do ChatGPT, utilize /memories para escolher se uma conversa pode utilizar memórias locais ou contribuir para memórias futuras. Em Definições > Personalização, utilize Ativar memórias do Codex para ativar ou desativar a funcionalidade na máquina selecionada. Utilize Permitir memórias de conversas assistidas por ferramentas para escolher se as conversas que utilizam ferramentas MCP ou pesquisa na Web podem contribuir para futuras memórias.

Para repor o armazenamento de memórias da máquina selecionada, selecione Eliminar memórias do Codex e confirme. Na máquina local, esta ação também limpa o Computer History quando essa funcionalidade está disponível.

Gira a memória do ChatGPT em Definições > Personalização. O ChatGPT Work utiliza as definições de memória disponíveis para a sua conta e o seu espaço de trabalho; não utiliza um repositório de memórias local do Codex nem controlos de memória locais.

No Codex CLI, utilize /memories numa sessão interativa para controlar se a conversa atual pode utilizar memórias locais existentes ou servir de fonte para futuras memórias. Consulte Configurar memórias locais se o comando não estiver disponível.

A extensão para IDE utiliza o repositório de memórias local do anfitrião Codex ligado. Quando as memórias estão ativadas nesse anfitrião, utilize os mesmos controlos ao nível da conversa que no Codex CLI.

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 de computador do ChatGPT, abra Definições > Personalização e ative Ativar memórias do Codex.

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.