Контекстные ссылки — точные цитаты

С возвращением в нашу серию о Hermes Agent! Сегодня мы погружаемся в то, что делает вашего агента значительно полезнее: контекстные ссылки. Если вы когда-нибудь мечтали, чтобы агент мог указать точно откуда он взял информацию — как в настоящей научной работе со сносками — эта функция для вас.

Что такое контекстные ссылки?

Представьте контекстные ссылки как сноски в книге. Когда ваш агент обрабатывает документ, разговор или файл, он теперь может запоминать, откуда взялась конкретная информация. Вместо простого «небо голубое» он может сказать «небо голубое (из weather_report.md, строка 42)».

Это настоящий прорыв для:

• Исследовательских задач — мгновенная проверка источников
• Ревью кода — отслеживание, где была внесена ошибка
• Юридической или комплаенс-работы — доказательство происхождения факта
• Длинных разговоров — запоминание, какое сообщение содержало ключевую деталь

Как это работает

Волшебство происходит за кулисами. Когда вы передаёте агенту документы, историю чата или файлы, Hermes автоматически отслеживает происхождение каждого фрагмента контента. Вам не нужно делать ничего особенного — всё работает само.

Вот простой пример:

hermes chat --with file:contract.pdf

Задайте вопрос вроде «Что за пункт о расторжении?» — и агент ответит с цитатой, указывающей на точный раздел PDF.

Новые параметры конфигурации

Последнее обновление приносит мощные новые способы управления поведением контекстных ссылок. Все они находятся в вашем файле ~/.hermes/config.yaml.

Включение и отключение

По умолчанию контекстные ссылки включены для контента на основе файлов. Но вы можете управлять ими для каждой сессии:

context_references:
  enabled: true              # главный переключатель
  include_line_numbers: true # добавлять номера строк к цитатам
  max_citations: 5           # ограничение количества ссылок на ответ

Форматы цитат

Вы можете выбрать, как цитаты будут отображаться в ответах:

context_references:
  format: markdown  # варианты: markdown, plain, json

• markdown — [source: file.md, line 12] (красиво отображается в чат-интерфейсах)
• plain — (file.md:12) (компактно, удобно для терминалов)
• json — структурированный вывод для программного использования

Работа с сессиями

Контекстные ссылки особенно хороши в длительных сессиях. Агент помнит, какое сообщение ввело факт, даже спустя часы:

hermes chat --session research-project

Спросите «Что мы узнали о ценообразовании ранее?» — и получите цитату, указывающую на точное сообщение двухчасовой давности.

Практические советы

1. Используйте описательные имена файлов

Цитата включает имя файла, так что делайте их осмысленными:

hermes chat --with docs/Q3-financial-report.md

Лучше, чем file1.txt, правда?

2. Комбинируйте с памятью

Контекстные ссылки прекрасно работают с системой памяти Hermes. Когда агент сохраняет что-то в memories/, он также записывает источник. Позже, когда он вспоминает эту информацию, он может сказать, откуда она изначально взялась.

3. Проверяйте свою конфигурацию

После обновления Hermes выполните:

hermes config check
hermes config migrate

Это гарантирует, что у вас есть все последние опции.

Быстрый пример

Давайте посмотрим, как это работает:

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

Вы: «Какие пункты действий мы согласовали?»

Агент: «Согласно заметкам встречи, вы согласовали:

1. Завершить бюджет на Q3 (из meeting-notes.md, строка 15)
2. Назначить демо для клиента (из meeting-notes.md, строка 22)
3. Обновить таймлайн проекта (из meeting-notes.md, строка 28)»

Видите, у каждого пункта своя цитата? Это контекстные ссылки делают свою работу.

Напоминание о приоритете конфигурации

Помните, настройки разрешаются в следующем порядке:

1. Аргументы CLI — наивысший приоритет
2. config.yaml — ваш основной файл конфигурации
3. .env — только для секретов
4. Встроенные значения по умолчанию — запасной вариант

Так что вы можете переопределять настройки контекстных ссылок для каждой команды:

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

Заключение

Контекстные ссылки превращают вашего агента из «чёрного ящика» в прозрачного, проверяемого помощника. Исследуете ли вы, отлаживаете код или просто хотите больше доверять ответам агента — эта функция даёт вам доказательства.

Попробуйте её со своими документами и почувствуйте, насколько увереннее вы становитесь, когда каждый ответ сопровождается источником. Ваше будущее «я», пытающееся вспомнить, откуда взялся тот факт, скажет вам спасибо.

Удачных цитирований! 🎯