knowledge-recall

Recuperar conocimiento guardado

Lee las convenciones compartidas. Este flujo de trabajo es de solo lectura.

1. Busca con knowledge_grep({consulta}), incluyendo personas, proyectos y páginas cuya identidad almacenada exacta no se conozca aún: palabras literales, all por defecto; prueba una variante concisa, any, o phrase cuando sea útil. No hay embeddings, regex, recorrido de grafos ni síntesis del lado del servidor. Reduce por tipo/kind de ontología cuando sea apropiado; usa knowledge_records y paginación para un inventario, no una búsqueda clasificada que pretenda ser exhaustiva.
2. Usa knowledge_lookup({consulta}) solo para un ID de registro exacto ya conocido, título completo o alias declarado. No realiza búsqueda por palabras clave. Si devuelve missing, recurre a knowledge_grep antes de concluir que no existe ningún registro relevante. Conserva ambiguous como ambigüedad e inspecciona los candidatos en lugar de elegir uno.
3. Inspecciona los resultados relevantes con knowledge_record. Lee suficiente contexto para respaldar la respuesta. Los metadatos compactos se incluyen por defecto; solicita includeEvidence: true para localizadores de fuente, fragmentos y soporte de atribución, y metadataView: "full" para campos de dominio arbitrarios. Las conexiones por defecto son identidades/puntos finales/incertidumbre compactos; solicita view: "full" solo para metadatos/evidencia más ricos, e includeCards: true con vista completa para prosa. Sigue la paginación de cuerpo/evidencia/conexión según sea necesario. Compara el hash/revisión de la cita del resultado con la relectura. Reinicia en caso de cambios en lugar de combinar revisiones incompatibles. Usa includeReferences solo para conexiones estructuradas declaradas; los enlaces en prosa no llenan esa lista automáticamente.
4. Responde a partir de los pasajes recuperados. En el chat de Control UI, cita títulos legibles enlazados a la página dedicada del Knowledge record usando el contrato de enlace de chat de las convenciones compartidas. Conserva los localizadores de fuente relevantes y propaga la evidencia original, no solo el resumen generado. Etiqueta la síntesis y los desacuerdos. Usa explícitamente filtros de historial de ciclo de vida para preguntas históricas; no presentes material obsoleto como actual.
5. Distingue entre "sin coincidencias" y lecturas inaccesibles, inválidas, incompletas o fallidas. Sigue los offsets de resultados con filtros sin cambios y, para búsqueda por palabras clave, compara index.snapshot. Si un límite de paginación de la API impide agotar los resultados, reduce la consulta o indica el límite de cobertura. No afirmes que al vault le falta algo solo porque una lista corta clasificada no lo contenía.

La recuperación en sí es de solo lectura. Si la política de memoria de Knowledge seleccionada requiere recordar información nueva realmente duradera, usa knowledge-capture por separado. No vuelvas a guardar resúmenes recuperados como nueva evidencia ni enriquezcas entidades meramente porque aparecieron en una respuesta.

Preguntas temporales

Usa knowledge_chronicle_day para un día/semana, knowledge_chronicle_since para un rango de ocurrencia, knowledge_timeline para los registros fechados de una entidad o un timeField elegido, y knowledge_chronicle_last_seen para el contexto fechado más reciente. Resuelve una entidad a un ID de página estable primero. Las menciones fechadas no prueban asistencia. Para consultas de palabras clave/inventario agrega since/until y timeField a knowledge_grep o knowledge_records. occurred_at responde cuándo sucedió algo; recorded_at y updated_at responden cuándo se crearon/cambiaron los registros. Nunca sustituyas uno por el otro. Resuelve las fechas relativas de la consulta con la zona horaria del usuario, conservando offsets explícitos; las consultas de día aceptan una zona horaria IANA. Los valores solo de fecha de origen se quedan solo de fecha. Sigue nextOffset con filtros sin cambios y el snapshot devuelto. Temporal eligibility="include_inactive" incluye material obsoleto/expirado, nunca registros retirados ni una reconstrucción del estado pasado del sistema. Last-seen usa occurredOnOrBefore para el límite de ocurrencia; no pases asOf ni historical. Usa includeSources=true para identidades de fuente deduplicadas en páginas temporales. Las líneas de tiempo solo en markdown y los registros sin fecha no se infieren, y la falta de coincidencias no prueba ausencia.

Lectura enfocada de fuentes

Usa knowledge_evidence_read con el id del registro y el path/sha256 observado para leer un pasaje UTF-8 exacto retenido. Proporciona inclusive startLine/endLine cuando se conozcan. Sigue nextCursor con id/path/hash sin cambios y omite o repite los límites de línea. Un nextCursor nulo completa el pasaje. En contraste, record.nextEvidenceOffset solo completa la lista de citas; excerptTruncated aún requiere lectura de la fuente. La herramienta verifica bytes y límites de línea, no la verdad de una interpretación. Usa knowledge_attachment para originales binarios. Nunca infieras una revisión completa a partir de un fragmento o un verificador estructural exitoso.

La frescura de la consulta distingue queriedAt de scannedAt; los resultados de palabras clave también tienen indexedAt. Un escaneo reutilizado conserva su tiempo de observación. Compara los valores de snapshot solo entre páginas con filtros de consulta y elegibilidad sin cambios.