# Cómo se vincula todo (/es/docs/how-things-are-linked)

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](/llms.mdx/docs/es/search/content.md#descarga-primero-el-historial-de-los-chats-pertinentes).

## La idea [#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 [#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.

```sh
tg personal messages context "msg:telegram/1/77/42" --thread
```

## Mensajes, chats y personas [#mensajes-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.

```sh
tg personal contacts link "Kai Sample" max:Kai
```

Despué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.

```sh
tg personal contacts timeline "Kai Sample" --since-time 2026-10-01 --limit 20
```

La 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 [#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](/llms.mdx/docs/es/search-architecture/content.md#3-reconstruir-conversaciones-con-un-grafo-de-mensajes).

## Archivos, notas de voz e imágenes [#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](/llms.mdx/docs/es/what-is-indexed/content.md#im%C3%A1genes).

## Menciones [#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 list` muestra lo encontrado. `mentions show <id>` muestra el texto alrededor de una.
* `mentions confirm <id> person:7` indica 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 tanto `person:` como `organization:`. 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 rebuild` lee los mensajes guardados antes de que existieran las menciones. `mentions rebuild person-name` vuelve 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](/llms.mdx/docs/es/what-is-indexed/content.md#tel%C3%A9fonos-correos-y-enlaces).

## Notas, tareas, hechos y recuerdos [#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 [#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.

```sh
tg personal tags add work --chat "Book club"
```

## Documentos de Drive [#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 [#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 [#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.

> ```text prompt
> Usa tg CLI. Encuentra el mensaje donde acordamos la fecha de entrega y muestra los mensajes de alrededor como una sola conversación.
> ```

> ```text prompt
> Usa tg CLI. ¿De quién es el teléfono +1 555 010 0100? Muestra dónde aparece y propón una persona.
> ```

> ```text prompt
> Usa tg CLI. Muestra todo sobre Kai Sample del último mes, en todas las mensajerías que vinculé a esa persona.
> ```

> ```text prompt
> Usa memo. ¿Qué tarea nació del mensaje sobre la factura y qué mensaje la respondió?
> ```

## Si falta un vínculo [#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](/llms.mdx/docs/es/search-efficiently/content.md) 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](/llms.mdx/docs/es/data-model/content.md#c%C3%B3mo-se-conectan).