Gerenciar a memória do espaço de trabalho

Este guia mostra como trabalhar com o armazenamento de conhecimento de um espaço de trabalho.

O mais importante a saber antes de começar: a interface de memória é uma superfície de revisão, não de criação. Fatos e políticas são gravados pelos agentes — por meio de propose_fact e propose_policy, com supersede_fact e supersede_policy para substituí-los. remember grava um item de camada quente limitado à sessão que consolidate_memory pode mais tarde promover a fato. As decisões de reuniões gravadas são coletadas no domínio decisions; não há coleta em execuções de agente concluídas. O que você faz aqui é ler o que eles gravaram, corrigir, desativar ou excluir.

A memória fica em Configurações → Espaço de trabalho → Memória (/workspaces/<id>/settings/memory). Ela não é um destino de primeiro nível na barra lateral.

As três abas

A página tem exatamente três abas. Fatos e Políticas mostram uma contagem ao vivo; o grafo não:

Fatos — todos os fatos do espaço de trabalho, com uma contagem dos que não foram substituídos
Políticas — regras normativas agrupadas por domínio, com uma contagem das ativas
Grafo de conhecimento — uma tela interativa de domínios, tópicos, fatos e políticas

Domínios não são algo que você cria. Um domínio passa a existir quando um agente grava nele o primeiro fato ou a primeira política; não há nenhum controle de criação de domínio em lugar algum da interface.

Revisar e corrigir um fato

Abra a aba Fatos.
Use a caixa de pesquisa para restringir a lista. É um filtro simples de substring sobre o domínio, o tópico e o conteúdo de cada fato — sem índice de palavras-chave, sem ranking.
Use o filtro de escopo para mostrar todos os escopos, somente fatos de todo o espaço de trabalho ou os fatos de um repositório.
Use o alternador de ordenação para ordenar por recência ou por confiança.
Clique no controle de edição de um fato.

A caixa de diálogo de edição permite alterar:

Domínio — mover um fato entre domínios
Tópico — seu rótulo curto
Conteúdo — o texto do conhecimento
Confiança — um controle deslizante em passos de 5%

Salve para gravá-lo de volta. Não existe botão Adicionar fato; a caixa de diálogo só abre em uma linha existente.

Ver fatos substituídos

A aba Fatos tem um interruptor Mostrar substituídos. Os fatos substituídos ficam ocultos por padrão e são revelados por esse interruptor, que é onde vive a trilha de auditoria — substituir nunca exclui.

Excluir um fato

Use o controle de exclusão de um fato e confirme. É uma exclusão real, não uma substituição: use-a para fatos que simplesmente não deveriam ter sido gravados e deixe que os agentes substituam os fatos cujo conteúdo avançou.

Gerenciar políticas

A aba Políticas agrupa as políticas ativas por domínio e rebaixa as inativas para uma seção ao final. Por política, você pode:

Editar
Excluir
Desativar / Ativar — a opção reversível e geralmente a certa. Somente políticas ativas chegam aos prompts dos agentes.

Como nos fatos, não há controle de criação.

Explorar o grafo de conhecimento

A aba Grafo de conhecimento dispõe domínios, tópicos, fatos e políticas como uma tela de nós navegável — desloque, aplique zoom e arraste os nós. Tocar em um nó abre seu painel de detalhes, a partir do qual as mesmas caixas de diálogo de edição podem ser acessadas. É a forma mais rápida de ver quais domínios estão de fato povoados.

Editar a memória de trabalho de um agente

A memória de trabalho é um bloco de anotações privado de cada agente, injetado no prompt dele no momento do despacho. Os agentes a gravam sozinhos com record_observation e update_my_notes, mas você pode lê-la e editá-la diretamente:

Configurações → Espaço de trabalho → Agentes → selecione o agente → a aba Memória.

Concessões de acesso

As concessões de acesso à memória mapeiam o papel de um agente para uma permissão (none, read, write) por domínio. Grave-as com as operações memory_access_grant.*.

Duas coisas a entender sobre como elas são resolvidas:

As leituras são fail-open. Sem linha de concessão para um par (role, domain), a permissão efetiva é read. A única gravação que lança erro sem write é propose_policy. As gravações de fatos não são condicionadas a concessão.
As concessões têm como chave o papel do agente. As ferramentas de proposição assumem general quando agent_role está ausente. Uma concessão gravada para outro papel não vincula esses agentes; uma concessão general vincula.

A pesquisa não é a mesma em toda parte

Três coisas diferentes se chamam “pesquisa de memória” e elas não concordam entre si:

Onde	O que faz
A caixa de pesquisa da aba Fatos	Filtro de substring sobre os fatos já carregados no cliente
A operação RPC `memory_fact.search`	Somente busca por palavra-chave no FTS5 — um cliente leve não consegue enviar um embedding de consulta, então a busca híbrida permanece interna ao host
A ferramenta `search_memory` do lado do agente	`keyword`, `semantic` ou `hybrid` (o padrão). A híbrida funde quatro vozes: lexical, semântica, temporal e de grafo

Então um agente e a página Memória não vão classificar a mesma consulta da mesma forma. Quando você estiver verificando o que um agente consegue de fato recuperar, pergunte ao agente.

Embeddings

Os fatos recebem embeddings no momento da gravação, e somente quando o modelo de embeddings no dispositivo está instalado. Verifique o status dele em Configurações → Servidor → Diagnóstico e privacidade → Busca semântica. Instale o modelo antes que os agentes comecem a gravar memória se você quiser recuperação semântica.