Références Contextuelles — Citations Précises

Bon retour dans notre série sur Hermes Agent ! Aujourd’hui, on plonge dans une fonctionnalité qui rend votre agent nettement plus utile : les références contextuelles. Si vous avez déjà rêvé que votre agent puisse pointer exactement d’où il tient une information — comme un vrai article de recherche avec ses citations — cette fonctionnalité est faite pour vous.

Qu’est-ce que les Références Contextuelles ?

Pensez aux références contextuelles comme à des notes de bas de page dans un livre. Lorsque votre agent traite un document, une conversation ou un fichier, il peut désormais mémoriser d’où proviennent les informations spécifiques. Au lieu de simplement dire « le ciel est bleu », il peut dire « le ciel est bleu (extrait de weather_report.md, ligne 42) ».

C’est un véritable changement de jeu pour :

• Les tâches de recherche — vérifier les sources instantanément
• Les revues de code — tracer où un bug a été introduit
• Le travail juridique ou de conformité — prouver d’où vient un fait
• Les longues conversations — se souvenir quel message contenait un détail clé

Comment ça Marche

La magie opère en coulisses. Lorsque vous fournissez à votre agent des documents, un historique de discussion ou des fichiers, Hermes suit automatiquement l’origine de chaque élément de contenu. Vous n’avez rien à faire de spécial — ça fonctionne tout seul.

Voici un exemple simple :

hermes chat --with file:contract.pdf

Posez une question comme « Quelle est la clause de résiliation ? » et l’agent répondra avec une citation pointant vers la section exacte du PDF.

Les Nouvelles Options de Configuration

La dernière mise à jour apporte de puissantes nouvelles façons de contrôler le comportement des références contextuelles. Tout se trouve dans votre fichier ~/.hermes/config.yaml.

Activation et Désactivation

Par défaut, les références contextuelles sont activées pour le contenu basé sur des fichiers. Mais vous pouvez les contrôler par session :

context_references:
  enabled: true              # interrupteur principal
  include_line_numbers: true # ajouter les numéros de ligne aux citations
  max_citations: 5           # limiter le nombre de références par réponse

Formats de Citation

Vous pouvez choisir comment les citations apparaissent dans les réponses :

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

• markdown — [source: file.md, ligne 12] (s’affiche joliment dans les interfaces de chat)
• plain — (file.md:12) (compact, idéal pour les terminaux)
• json — sortie structurée pour une utilisation programmatique

Travailler avec les Sessions

Les références contextuelles brillent dans les sessions de longue durée. L’agent se souvient quel message a introduit un fait, même des heures plus tard :

hermes chat --session research-project

Demandez « Qu’avons-nous appris sur la tarification tout à l’heure ? » et obtenez une citation pointant vers le message exact d’il y a deux heures.

Conseils Pratiques

1. Utilisez des Noms de Fichiers Descriptifs

La citation inclut le nom du fichier, alors rendez-les explicites :

hermes chat --with docs/rapport-financier-T3.md

Mieux que fichier1.txt, non ?

2. Combinez avec la Mémoire

Les références contextuelles fonctionnent à merveille avec le système de mémoire d’Hermes. Lorsque l’agent stocke quelque chose dans memories/, il enregistre aussi la source. Plus tard, quand il rappelle ce souvenir, il peut vous dire d’où l’information provenait à l’origine.

3. Vérifiez Votre Configuration

Après avoir mis à jour Hermes, exécutez :

hermes config check
hermes config migrate

Cela garantit que vous disposez de toutes les dernières options disponibles.

Un Exemple Rapide

Voyons ça en action :

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

Vous : « Quelles actions avons-nous convenues ? »

Agent : « D’après les notes de réunion, vous avez convenu de :

1. Finaliser le budget du T3 (extrait de notes-reunion.md, ligne 15)
2. Planifier la démo client (extrait de notes-reunion.md, ligne 22)
3. Mettre à jour le calendrier du projet (extrait de notes-reunion.md, ligne 28) »

Vous voyez comme chaque élément a sa propre citation ? C’est ça, les références contextuelles au travail.

Rappel sur la Priorité de Configuration

N’oubliez pas, les paramètres sont résolus dans cet ordre :

1. Arguments CLI — priorité la plus élevée
2. config.yaml — votre fichier de configuration principal
3. .env — pour les secrets uniquement
4. Paramètres par défaut intégrés — solution de repli

Vous pouvez donc remplacer les paramètres de références contextuelles par commande :

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

Pour Conclure

Les références contextuelles transforment votre agent d’une « boîte noire » en un assistant transparent et vérifiable. Que vous fassiez de la recherche, du débogage de code, ou que vous souhaitiez simplement accorder plus de confiance aux réponses de votre agent, cette fonctionnalité vous apporte les preuves.

Essayez avec vos propres documents et voyez à quel point vous vous sentez plus confiant quand chaque réponse est accompagnée d’une source. Vous-même, dans le futur — en essayant de vous rappeler d’où venait ce fait — vous remercierez.

Bonne citation ! 🎯