Cómo se vincula todo
Qué registros conectan las herramientas (mensajes, personas, chats, archivos, menciones, notas, tareas, hechos, documentos de Drive, etiquetas), quién crea cada vínculo y qué ejecutar cuando falta uno.
Puedes pedirle a tu agente todo sobre una persona, o los mensajes que respaldan una decisión, porque las herramientas guardan vínculos entre registros. Esta página explica qué vínculos existen, quién crea cada uno (la herramienta, tú o tu agente) y cómo seguirlos. Después podrás saber por qué falta un vínculo y qué comando lo añade. La búsqueda y los vínculos trabajan con lo que ya está en el almacén local, así que descarga antes el historial: Buscar.
La idea
tg, max, memo y drive guardan sus registros en un único almacén local en tu ordenador. Un registro de una herramienta puede vincularse con uno de otra. Un vínculo es una de dos cosas:
- Parte del propio registro. Un mensaje tiene un chat y un remitente.
- Un vínculo guardado entre dos registros. Una nota trata de una persona. Un hecho se respalda con mensajes.
Las identidades nunca se unen por adivinar a partir de los nombres. Cada vínculo guardado anota quién lo creó.
Una referencia nombra cualquier registro
Cada resultado lleva una referencia: un nombre corto y con tipo del registro. Úsala en el siguiente comando.
| Referencia | A qué apunta |
|---|---|
msg:telegram/1/77/42 | Un mensaje: mensajería, cuenta, chat, mensaje |
chat:telegram/1/77 | Un chat de una cuenta |
contact:telegram/501 | Un contacto de una mensajería |
person:7 | Una persona, con todas las cuentas que vinculaste a ella |
organization:3, project:4, task:5 | Tus organizaciones, proyectos y tareas |
note:12, document:3 | Una nota, o un archivo de una carpeta de notas o de Drive |
memory:8, fact:9 | Un recuerdo o un hecho |
Una referencia de mensaje incluye la cuenta, así que el mismo número en otra cuenta es otro mensaje. El campo que contiene la referencia se llama ref en la mayoría de las respuestas. Algunas lo llaman locator, y una lista de Drive lo llama reference. Copia el valor, no el nombre del campo.
tg personal messages context "msg:telegram/1/77/42" --threadMensajes, chats y personas
Un mensaje pertenece a un chat y tiene un remitente. El remitente es una identidad: una cuenta en una mensajería. Una persona es una o varias identidades.
Solo tú unes identidades en una misma persona. El mismo nombre o el mismo dominio de correo nunca bastan.
tg personal contacts link "Kai Sample" max:KaiDespués, contacts timeline sigue a la persona entre mensajerías. Muestra lo que escribió, dónde la mencionaron, y sus chats, correos, reuniones y tareas, de lo más reciente a lo más antiguo, solo desde el almacén.
tg personal contacts timeline "Kai Sample" --since-time 2026-10-01 --limit 20La herramienta también anota quién participó en qué (remitente, destinatario, participante, responsable, autor, mencionado, vinculado). Por eso «todo sobre Kai» es una sola consulta y no un recorrido por todos los mensajes.
Respuestas y conversaciones
Cada mensaje puede apuntar al mensaje anterior al que responde. Cada puntero dice de dónde viene:
- La mensajería. Una respuesta explícita. Gana sobre todo lo demás.
- Una regla de la herramienta. Un mensaje que menciona a alguien, o que continúa al mismo remitente.
- Tu agente. Una respuesta que guardó tras leer el chat. Guardarla requiere el permiso de perfil
conversations.links.
conversations build une esos punteros en conversaciones de un chat. messages context con --thread sigue la cadena desde un mensaje en lugar de mostrar sus vecinos en el tiempo. Un vínculo que quedó desactualizado tras una edición o un borrado se muestra, pero no se sigue. Al reconstruir, las conversaciones reciben ids nuevos, así que conserva la referencia msg: del mensaje, no el id de la conversación. Cómo se construye el grafo: Cómo funciona la búsqueda.
Archivos, notas de voz e imágenes
- Un archivo pertenece a un mensaje, un correo o una reunión. Su texto extraído se queda con él, así que
content:encuentra el mensaje que llevaba el archivo. - La transcripción de una nota de voz pertenece al mensaje, así que
transcript:encuentra ese mensaje. - Una imagen se encuentra por el chat que la rodea o por lo que muestra. Ambas vías se explican en Qué se indexa.
Menciones
Una mención es un teléfono, una dirección de correo, un enlace, un enlace a un documento de Google o el nombre de una persona que conoces, encontrados con reglas en el texto de mensajes, archivos y transcripciones. Cada mención empieza como found. Después la confirmas (linked) o la rechazas (dismissed).
mentions listmuestra lo encontrado.mentions show <id>muestra el texto alrededor de una.mentions confirm <id> person:7indica a quién pertenece un teléfono o una dirección, o a qué persona se refiere un nombre. Para un teléfono o una dirección sirven tantoperson:comoorganization:. Un documento de Google guardado no necesita argumento.mentions reject <id>descarta ese valor en todas partes y en las sincronizaciones posteriores. Un enlace normal no se puede confirmar, solo rechazar.mentions rebuildlee los mensajes guardados antes de que existieran las menciones.mentions rebuild person-namevuelve a buscar nombres cuando añades o renombras personas.
Ambas anotan quién decidió. Si las ejecuta un agente, la decisión se guarda a nombre del agente; --as-owner la guarda como tuya.
La búsqueda encuentra las menciones como se hayan escrito: phone:, email:, url: y domain: miran el valor, y mentions:"person:7" encuentra los mensajes que mencionan a una persona, organización o documento confirmados. Estos comandos están en las últimas versiones de tg y max; comprueba las tuyas con mentions --help. Más: Qué se indexa.
Notas, tareas, hechos y recuerdos
memo guarda los registros sobre todo lo anterior que escribes tú o escribe tu agente.
- Una nota trata de una persona, un chat, una tarea o un documento. Un enlace
[[Kai Sample]]en una nota se convierte en un vínculo con esa persona en cuanto hay en el almacén alguien con ese nombre o nombre de usuario. Un nombre en texto normal no es un vínculo. - Una tarea puede nacer de un mensaje. Una tarea de pregunta se vincula con el mensaje que la respondió.
- Un hecho (una afirmación, una pregunta, una decisión o una promesa) guarda vínculos con su evidencia: los mensajes, notas o documentos que lo respaldan. Una decisión nueva puede reemplazar a una anterior. Un hecho que añade tu agente queda como propuesto hasta que lo aceptes.
- Un recuerdo es una conclusión con evidencia y un estado de revisión. Un cambio en la fuente puede dejarlo obsoleto.
Etiquetas
Una etiqueta se pone en cualquier registro: un mensaje, un chat, una persona, un documento, una nota, una tarea. tag:work encuentra un mensaje que tiene la etiqueta, un mensaje en un chat que la tiene y un mensaje de una persona que la tiene. Una etiqueta en una carpeta de Drive llega a cada documento de dentro.
tg personal tags add work --chat "Book club"Documentos de Drive
drive importa documentos al mismo almacén. Un documento puede llevar etiquetas, notas, hechos y recuerdos, y vincularse con una persona (drive relationships, drive tags). drive documents list --person person:7 lista los documentos vinculados a esa persona.
Quién crea un vínculo
| Vínculo | Lo crea |
|---|---|
| Un mensaje en su chat, con su remitente | La herramienta, al guardar el mensaje |
| Una respuesta | La mensajería |
| Una respuesta supuesta (mención, mismo remitente) | Una regla de la herramienta |
| Una respuesta elegida | Tu agente, con conversations.links |
| Un teléfono, correo, enlace, documento o nombre en un texto | Una regla de la herramienta, como found |
| Una mención confirmada o rechazada | Tú o tu agente, con su nombre anotado |
| Dos identidades, una persona | Tú, con contacts link |
| Una etiqueta | Tú, con tags add |
| Una nota, tarea o hecho sobre un registro | Tú o tu agente mediante memo |
| Un hecho de un agente | Tu agente, como propuesto; tú lo aceptas |
Cada vínculo guardado anota su origen: file (escrito en un archivo de notas), owner (añadido por ti), suggested (propuesto, aún sin confirmar) o message (escrito en un mensaje guardado).
Usar los vínculos en una pregunta
Cuatro peticiones que un agente puede responder gracias a los vínculos. Sustituye los nombres por los tuyos.
Usa tg CLI. Encuentra el mensaje donde acordamos la fecha de entrega y muestra los mensajes de alrededor como una sola conversación.Usa tg CLI. ¿De quién es el teléfono +1 555 010 0100? Muestra dónde aparece y propón una persona.Usa tg CLI. Muestra todo sobre Kai Sample del último mes, en todas las mensajerías que vinculé a esa persona.Usa memo. ¿Qué tarea nació del mensaje sobre la factura y qué mensaje la respondió?Si falta un vínculo
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| La cronología de una persona muestra una sola mensajería | Las identidades no están vinculadas | contacts link, y vuelve a preguntar |
--thread solo muestra vecinos en el tiempo | No hay conversaciones construidas para el chat | conversations build --chat "Book club" |
| No se encuentra un teléfono o correo de un mensaje antiguo | El mensaje se guardó antes de que existieran las menciones | mentions rebuild |
| No se encuentra el nombre de un contacto nuevo | Las menciones se construyeron antes de que existiera la persona | mentions rebuild person-name |
| No se encuentran palabras dentro de un archivo | No se extrajo el texto del archivo | attachments extract |
| Un chat no tiene mensajes | Nunca se descargó el historial | messages sync |
Siguiente: Busca con eficacia muestra cómo elegir el comando y acotar una búsqueda. Las columnas del almacén que sostienen estos vínculos están en el modelo de datos.
Qué se indexa
Qué tipos de contenido permiten buscar las herramientas (texto, archivos, páginas web, notas de voz, imágenes), qué necesita cada uno y qué no sale de tu ordenador.
Busca con eficacia
Cómo elegir el comando de búsqueda, acotar antes de buscar, paginar los resultados y mantener la salida corta, con una tabla de filtros habituales y los errores que cuestan una búsqueda.