컨텍스트 참조 — 정확한 인용

Hermes 에이전트 시리즈에 다시 오신 것을 환영합니다! 오늘은 에이전트를 훨씬 더 유용하게 만들어 주는 기능에 대해 알아보겠습니다: 컨텍스트 참조(Context References). 에이전트가 정보를 얻은 정확한 위치를 가리킬 수 있다면 얼마나 좋을까요? 마치 제대로 된 연구 논문의 인용처럼 말이죠. 바로 그런 기능입니다.

컨텍스트 참조란 무엇인가?

컨텍스트 참조는 책의 각주와 같다고 생각하면 됩니다. 에이전트가 문서, 대화, 파일을 처리할 때 이제 특정 정보가 어디서 왔는지 기억할 수 있습니다. 단순히 “하늘이 파랗다”라고 말하는 대신 “하늘이 파랗다 (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] (채팅 UI에서 보기 좋게 렌더링)
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

당신: “우리가 합의한 실행 항목이 뭐였지?”

에이전트: “회의 노트에 따르면 다음과 같이 합의했습니다:

Q3 예산 확정 (meeting-notes.md, 15번째 줄에서 인용)
고객 데모 일정 잡기 (meeting-notes.md, 22번째 줄에서 인용)
프로젝트 타임라인 업데이트 (meeting-notes.md, 28번째 줄에서 인용)“

각 항목에 고유한 인용이 있는 게 보이시죠? 이것이 컨텍스트 참조의 역할입니다.

구성 우선순위 참고 사항

설정은 다음 순서로 적용된다는 점을 기억하세요:

CLI 인자 — 최우선 순위
config.yaml — 기본 구성 파일
.env — 비밀 정보 전용
기본 제공 기본값 — 폴백

따라서 명령별로 컨텍스트 참조 설정을 재정의할 수 있습니다:

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

마무리

컨텍스트 참조는 에이전트를 “블랙박스”에서 투명하고 검증 가능한 어시스턴트로 바꿔줍니다. 연구를 하든, 코드를 디버깅하든, 아니면 단순히 에이전트의 답변을 더 신뢰하고 싶든, 이 기능은 증거를 제공합니다.

직접 문서로 시험해 보고 모든 답변에 출처가 함께 제공될 때 얼마나 자신감이 생기는지 느껴보세요. 나중에 “그 사실이 어디서 왔지?“라고 기억하려 애쓰는 미래의 당신이 분명 감사할 것입니다.

인용하며 즐거운 시간 되세요! 🎯