knowledge-recall

Lembrar conhecimento salvo

Leia as convenções compartilhadas. Este fluxo de trabalho é somente leitura.

1. Pesquise com knowledge_grep({query}), incluindo para pessoas, projetos e páginas cuja identidade exata armazenada não é conhecida: palavras literais, all por padrão; tente uma variante concisa, any ou phrase quando útil. Não há embeddings, regex, travessia de grafo ou síntese no servidor disponível. Restrinja por tipo/kind ontológico quando apropriado; use knowledge_records e paginação para um inventário, não uma busca ranqueada fingindo ser exaustiva.
2. Use knowledge_lookup({query}) apenas para um ID de registro exato já conhecido, título completo ou alias declarado. Ele não realiza busca por palavras-chave. Se retornar missing, recorra ao knowledge_grep antes de concluir que nenhum registro relevante existe. Preserve ambiguous como ambiguidade e inspecione candidatos em vez de escolher um.
3. Inspecione resultados relevantes com knowledge_record. Leia contexto suficiente para embasar a resposta. Metadados compactos são incluídos por padrão; solicite includeEvidence: true para localizadores de fonte, trechos e suporte de atribuição, e metadataView: "full" para campos de domínio arbitrários. Conexões padrão são identidades/pontos finais/incerteza compactas; solicite view: "full" apenas para metadados/evidências mais ricos, e includeCards: true com visualização completa para prosa. Siga a paginação de corpo/evidências/conexões conforme necessário. Compare o hash/revisão de citação do resultado com a leitura de retorno. Reinicie em caso de alterações em vez de combinar revisões incompatíveis. Use includeReferences apenas para conexões estruturadas declaradas; links em prosa não preenchem essa lista automaticamente.
4. Responda com base nas passagens recuperadas. No chat da Interface de Controle, cite títulos legíveis vinculados à página dedicada de registro do Knowledge usando o contrato de link de chat das convenções compartilhadas. Retenha localizadores de fonte relevantes e propague evidências originais, não apenas o resumo gerado. Rotule síntese e discordâncias. Use filtros de histórico de ciclo de vida explicitamente para perguntas históricas; não apresente material substituído como atual.
5. Diferencie nenhuma correspondência de leituras inacessíveis, inválidas, incompletas ou com falha. Siga os deslocamentos de resultado com filtros inalterados e, para busca por palavras-chave, compare index.snapshot. Se um limite de paginação de API impedir esgotar os resultados, restrinja a consulta ou declare o limite de cobertura. Não afirme que o vault carece de algo apenas porque uma lista ranqueada curta não o continha.

A própria recuperação (recall) é somente leitura. Se a política de memória do Knowledge selecionada exigir lembrar informações novas genuinamente duráveis, use knowledge-capture separadamente. Não salve novamente resumos recuperados como novas evidências ou enriqueça entidades meramente porque apareceram em uma resposta.

Perguntas temporais

Use knowledge_chronicle_day para um dia/semana, knowledge_chronicle_since para um intervalo de ocorrência, knowledge_timeline para registros datados de uma entidade ou um campo de tempo escolhido, e knowledge_chronicle_last_seen para o contexto datado mais recente. Resolva uma entidade para um ID de página estável primeiro. Menções datadas não comprovam participação. Para consultas de palavras-chave/inventário, adicione since/until e timeField a knowledge_grep ou knowledge_records. occurred_at responde quando algo aconteceu; recorded_at e updated_at respondem quando os registros foram criados/alterados. Nunca substitua um pelo outro. Resolva datas de consulta relativas com o fuso horário do usuário, preservando deslocamentos explícitos; consultas de dia aceitam um fuso horário IANA. Valores de data de origem permanecem apenas data. Siga nextOffset com filtros inalterados e snapshot retornado. Elegibilidade temporal="include_inactive" inclui material substituído/expirado, nunca registros retirados ou uma reconstrução do estado passado do sistema. Last-seen usa occurredOnOrBefore para o limite de ocorrência; não passe asOf ou historical. Use includeSources=true para identidades de fonte desduplicadas em páginas temporais. Linhas do tempo apenas em markdown e registros sem data não são inferidos, e nenhuma correspondência não comprova ausência.

Leitura focada de fonte

Use knowledge_evidence_read com o id do registro e o caminho/sha256 observado para ler uma passagem exata retida em UTF-8. Forneça inclusive startLine/endLine quando conhecido. Siga nextCursor com id/caminho/hash inalterados e omita ou repita limites de linha. Um nextCursor nulo completa a passagem. Em contraste, record.nextEvidenceOffset completa apenas a lista de citações; excerptTruncated ainda requer leitura da fonte. A ferramenta verifica bytes e limites de linha, não a verdade de uma interpretação. Use knowledge_attachment para originais binários. Nunca infira revisão completa de um trecho ou de um verificador estrutural bem-sucedido.

Atualização da consulta distingue queriedAt de scannedAt; resultados de palavras-chave também têm indexedAt. Uma varredura reutilizada retém seu tempo de observação. Compare valores de snapshot apenas entre páginas com filtros de consulta e elegibilidade inalterados.