Cómo hacer que los agentes de IA citen fuentes en tu base de conocimiento

Un agente puede escribir una frase fluida, concreta y falsa, y se ve exactamente igual que otra que copió de una fuente. Una vez guardada en tus notas, nada distingue la una de la otra.

En una base de conocimiento que escriben agentes, esa frase no se queda quieta. La siguiente sesión la lee como contexto y la repite. Un resumen la recoge. Un mes después aparece en cuatro notas y parece un hecho asentado. Nadie la inventó a propósito, y nadie sabe de dónde salió.

Una cita lo resuelve en el momento en que resulta más barato. Cuando el agente escribe la afirmación, sabe qué archivo o qué página leyó. Dejarlo registrado cuesta una línea. Reconstruirlo después obliga a volver a leer todas las fuentes. Y una regla que exige una fuente para cada afirmación cambia lo que escribe el agente: cuando no hay fuente, tiene que decirlo en lugar de rellenar el hueco.

Esta guía configura las citas a mano, en frontmatter sencillo que cualquier agente puede escribir. Después de cada paso, una nota breve explica el mismo paso en Knowtarium, una base de conocimiento con cifrado de extremo a extremo que creamos para notas escritas por personas y agentes juntos.

Puedes exigir fuentes en dos niveles. La mayoría de las bases de conocimiento necesitan los dos.

Un buen punto de partida: cada documento enumera sus fuentes, y cada frase con un número, una fecha, un nombre o una cita remite a una de ellas. Las opiniones y tu propio razonamiento no necesitan nota al pie, pero deberían leerse como opiniones.

En Knowtarium

Los dos niveles aparecen en Knowtarium. Las fuentes del documento se muestran en Details, dentro de sus propiedades, junto a quién lo escribió (y, en las carpetas con revisión activada, quién lo comprobó), y cada nota al pie del texto es una cita que muestra su fuente cuando la señalas.

(se abre a tamaño completo en una pestaña nueva) (se abre a tamaño completo en una pestaña nueva)

Podrías inventarte tu propio formato de citas, pero con uno publicado todas las herramientas y todos los agentes lo leen igual. El Open Knowledge Format (OKF), una especificación abierta publicada por Google Cloud, registra la procedencia en un campo sources y vincula las afirmaciones con él mediante notas al pie:

---
type: Metric
title: Churn
generated: { by: claude-code/2.1, at: 2026-09-26T08:10:00Z }
stale_after: 2026-12-31T00:00:00Z
sources:
  - id: billing-export
    resource: /references/billing-2026-09.csv
    title: Exportación de facturación, septiembre de 2026
    author: process:billing-sync
    last_modified: 2026-09-25T23:00:00Z
  - id: pricing-decision
    resource: /decisions/2026-07-01-annual-plans.md
    title: Pasar la facturación a planes anuales
---
 
El churn mensual bajó al 2,4 % en septiembre.[^billing-export]
La bajada llegó tras el paso a planes anuales.[^pricing-decision]
 
[^billing-export]: Exportación de facturación, septiembre de 2026
[^pricing-decision]: Pasar la facturación a planes anuales

Cada entrada de sources necesita un resource: una URL, una ruta dentro de la base de conocimiento o un archivo en una carpeta references/. Los demás campos son opcionales:

• id: una clave estable. La especificación dice que debe estar presente siempre que el cuerpo cite la fuente.
• title: una etiqueta legible.
• author: quién o qué produjo la fuente, como un actor del tipo human:maya o process:billing-sync.
• last_modified: cuándo cambió por última vez la propia fuente.
• usage_count: con qué frecuencia se usó la fuente durante un periodo indicado en un campo hermano usage_window.

La etiqueta de la nota al pie es la clave de unión. La especificación explica por qué es un id y no una posición como “fuente 2”: los agentes reescriben estos documentos constantemente, y una referencia numerada apunta a la fuente equivocada en cuanto alguien reordena la lista. Un id con nombre sobrevive.

Cuando un resource apunta a otro documento de la base de conocimiento, ese enlace es el linaje: quien lo lea puede seguirlo hasta las fuentes de ese documento. OKF registra estas señales, no una puntuación de confianza. Lee las reglas completas en la especificación de OKF.

Los agentes siguen el archivo de instrucciones que leen al empezar una sesión: AGENTS.md en la mayoría de las herramientas, CLAUDE.md en Claude Code. Añade una sección de fuentes:

## Fuentes
 
- Cada número, fecha, nombre, cita y decisión necesita una fuente.
- Añade cada fuente a `sources` con un `id` corto y estable y un `resource`.
- Cítala justo después de la afirmación con una nota al pie: [^el-id].
- Cita solo fuentes que hayas abierto en esta sesión. Nunca inventes
  una URL ni un título.
- Copia los números exactamente como los da la fuente. No redondees.
- Guarda en references/ una copia de las páginas web y exportaciones que cites.
- Si no encuentras una fuente, no hagas la afirmación. Ponla en
  "## Preguntas abiertas" con lo que necesitarías para confirmarla.
- Nunca cambies el `id` de una fuente cuando un documento ya la cita.

Dos de estas reglas hacen casi todo el trabajo. “Cita solo fuentes que hayas abierto” impide que el agente cite lo que recuerda que decía una página. “Si no encuentras una fuente, no hagas la afirmación” le da un sitio donde poner una suposición que no sean tus notas. La plantilla completa está en nuestra guía de AGENTS.md para una base de conocimiento.

Guarda copias de lo que citas. Las páginas web cambian y las exportaciones se sobrescriben. Con una copia guardada en references/, una cita se puede seguir comprobando el año que viene.

Las reglas reducen las citas incorrectas, pero no las eliminan. Un agente puede citar una fuente real para una afirmación que la fuente no hace. Por eso conviene comprobar las citas aparte, en dos pasadas.

1. La pasada mecánica

Cada nota al pie debe coincidir con un id de sources, y cada id debería citarse en algún sitio. Puedes ver las dos listas desde la terminal:

# etiquetas de notas al pie citadas en el cuerpo
$ grep -o "\[\^[a-z0-9-]*\]" metrics/churn.md | sort -u
 
# ids declarados en el frontmatter
$ grep -E "^  - id:" metrics/churn.md

2. La pasada de lectura

Después, haz que otra sesión de agente lea cada afirmación frente a su fuente. Empiézala desde cero, sin el contexto de la sesión que escribió, para que lea el documento como lo haría alguien de fuera. Un agente completamente distinto, como Codex comprobando el trabajo de Claude Code, es todavía mejor.

Comprueba las citas de metrics/churn.md. No cambies el documento.
 
1. Para cada nota al pie, busca la entrada de sources con el mismo id.
   Informa de las notas al pie sin entrada y de las entradas que nadie cita.
2. Abre cada resource. Informa de los que no existan.
3. Para cada afirmación citada, copia el pasaje de la fuente que
   la respalda, o di que no encuentras ninguno.
4. Informa de las afirmaciones con números, fechas o nombres que no citan nada.
 
Si todas las afirmaciones se sostienen, añádete a `verified` con la
hora UTC actual. Si no, enumera los problemas y detente.

El último paso registra la comprobación. En OKF, una entrada verified de un agente hace que el documento pase a machine-confirmed. Cuando lo lees tú y añades tu propia entrada human:, pasa a human-reviewed:

verified:
  - { by: second-agent/1.0, at: 2026-09-26T09:02:00Z }  # el agente que comprueba
  - { by: human:maya, at: 2026-09-26T10:30:00Z }        # tú, después de leerlo

Una cita es cierta a fecha de cuando alguien la comprobó. Da a los documentos con números una fecha stale_after, y registra last_modified en las fuentes que sabes que cambian. Cuando la exportación de septiembre se sustituya por la de octubre, la nota de churn debería volver a comprobarse, no darse por buena sin más. Un documento caduca en cuanto la hora actual supera su stale_after, lo haya verificado quien lo haya verificado.

Knowtarium lee el campo sources y las notas al pie que apuntan a él, y te los pone delante mientras lees. El formato no cambia en nada: las citas son el mismo OKF sencillo que tus agentes ya escriben, guardado con cifrado de extremo a extremo en tu espacio de trabajo.

• Cada afirmación, rastreada. Señala una cita para ver la fuente que hay detrás, quién la creó y cuándo cambió por última vez; síguela, y la fuente queda marcada en los detalles del documento.
• Propiedades, no YAML en bruto. El frontmatter se muestra arriba del documento: quién lo escribió (y, en las carpetas con revisión activada, quién lo comprobó), cuándo caduca y de dónde salió.
• Un grafo de tus enlaces. Muestra lo que ha caducado y, con la revisión activada, puede colorear los documentos por nivel de confianza, para que las notas sin verificar destaquen. Los enlaces a documentos que nadie ha escrito todavía aparecen como fantasmas.
• Búsqueda de texto completo. Encuentra mientras escribes todos los documentos que mencionan un número o una fuente, con el texto coincidente a la vista. La búsqueda se ejecuta en tu navegador, porque no podemos leer tus notas (los agentes que conectas ven lo que leen).

(se abre a tamaño completo en una pestaña nueva) (se abre a tamaño completo en una pestaña nueva)

Cuando cambia una fuente o un número

Las citas importan sobre todo cuando algo cambia. Si un agente reescribe la nota de churn, el cambio queda firmado y marcado en el documento, con su diff y un Undo; en una carpeta con revisión activada, espera como diff hasta que lo apruebes. Si corriges tú mismo un número en una carpeta así, la edición espera la comprobación de un agente: cuando se lo pides, tu agente lee el diff, sigue los enlaces y los documentos que comparten una fuente, y corrige o señala cualquier sitio donde todavía aparezca el valor antiguo.

Knowtarium no llama a ninguna IA por sí mismo; los agentes que ya usas se conectan por MCP y se encargan de escribir y de comprobar. Mira todas las funciones.