Referencias de Contexto — Citas Precisas

¡Bienvenido de nuevo a nuestra serie sobre Hermes Agent! Hoy nos sumergimos en algo que hace que tu agente sea muchísimo más útil: las referencias de contexto. Si alguna vez deseaste que tu agente pudiera señalar exactamente dónde obtuvo la información —como un buen artículo de investigación con citas— esta es la función para ti.

¿Qué Son las Referencias de Contexto?

Piensa en las referencias de contexto como notas al pie en un libro. Cuando tu agente procesa un documento, una conversación o un archivo, ahora puede recordar de dónde provienen piezas específicas de información. En lugar de solo decir “el cielo es azul”, puede decir “el cielo es azul (de informe_meteorologico.md, línea 42)”.

Esto cambia las reglas del juego para:

• Tareas de investigación — verifica fuentes al instante
• Revisiones de código — rastrea dónde se introdujo un error
• Trabajo legal o de cumplimiento — demuestra de dónde proviene un dato
• Conversaciones largas — recuerda qué mensaje contenía un detalle clave

Cómo Funciona

La magia ocurre tras bambalinas. Cuando le das a tu agente documentos, historial de chat o archivos, Hermes rastrea automáticamente el origen de cada pieza de contenido. No necesitas hacer nada especial — simplemente funciona.

Aquí tienes un ejemplo sencillo:

hermes chat --with file:contrato.pdf

Haz una pregunta como “¿Cuál es la cláusula de terminación?” y el agente responderá con una cita que apunta a la sección exacta del PDF.

Las Nuevas Opciones de Configuración

La última actualización trae formas nuevas y potentes de controlar cómo se comportan las referencias de contexto. Todas viven en tu archivo ~/.hermes/config.yaml.

Activar y Desactivar

Por defecto, las referencias de contexto están activadas para contenido basado en archivos. Pero puedes controlarlas por sesión:

context_references:
  enabled: true              # interruptor principal
  include_line_numbers: true # añade números de línea a las citas
  max_citations: 5           # limita cuántas referencias por respuesta

Formatos de Cita

Puedes elegir cómo aparecen las citas en las respuestas:

context_references:
  format: markdown  # opciones: markdown, plain, json

• markdown — [fuente: archivo.md, línea 12] (se renderiza bien en interfaces de chat)
• plain — (archivo.md:12) (compacto, ideal para terminales)
• json — salida estructurada para uso programático

Trabajar con Sesiones

Las referencias de contexto brillan en sesiones de larga duración. El agente recuerda qué mensaje introdujo un dato, incluso horas después:

hermes chat --session proyecto-investigacion

Pregunta “¿Qué aprendimos antes sobre los precios?” y obtén una cita que apunta al mensaje exacto de hace dos horas.

Consejos Prácticos

1. Usa Nombres de Archivo Descriptivos

La cita incluye el nombre del archivo, así que haz que sean significativos:

hermes chat --with docs/informe-financiero-Q3.md

Mejor que archivo1.txt, ¿verdad?

2. Combínalo con la Memoria

Las referencias de contexto funcionan de maravilla con el sistema de memoria de Hermes. Cuando el agente guarda algo en memories/, también registra la fuente. Después, cuando recupera ese recuerdo, puede decirte de dónde provino originalmente la información.

3. Revisa tu Configuración

Después de actualizar Hermes, ejecuta:

hermes config check
hermes config migrate

Esto asegura que tengas todas las opciones más recientes disponibles.

Un Ejemplo Rápido

Veámoslo en acción:

hermes chat --with ~/notas/notas-reunion.md

Tú: “¿Qué acciones acordamos?”

Agente: “Según las notas de la reunión, acordaste:

1. Finalizar el presupuesto del Q3 (de notas-reunion.md, línea 15)
2. Programar la demo con el cliente (de notas-reunion.md, línea 22)
3. Actualizar el cronograma del proyecto (de notas-reunion.md, línea 28)“

¿Ves cómo cada elemento tiene su propia cita? Eso son las referencias de contexto haciendo su trabajo.

Recordatorio de Precedencia de Configuración

Recuerda, los ajustes se resuelven en este orden:

1. Argumentos de CLI — prioridad más alta
2. config.yaml — tu archivo de configuración principal
3. .env — solo para secretos
4. Valores predeterminados integrados — respaldo

Así que puedes anular la configuración de referencias de contexto por comando:

hermes chat --with file:informe.pdf --set context_references.format=plain

Conclusión

Las referencias de contexto convierten a tu agente de una “caja negra” en un asistente transparente y verificable. Ya sea que estés investigando, depurando código o simplemente quieras confiar más en las respuestas de tu agente, esta función te da las pruebas.

Pruébalo con tus propios documentos y mira cuánta más confianza sientes cuando cada respuesta viene con una fuente. Tu yo del futuro —tratando de recordar de dónde salió ese dato— te lo agradecerá.

¡Felices citas! 🎯