Tham Chiếu Ngữ Cảnh — Trích Dẫn Chính Xác

Chào mừng bạn quay lại với chuỗi bài viết về Hermes Agent! Hôm nay chúng ta sẽ khám phá một tính năng giúp agent của bạn trở nên hữu ích hơn rất nhiều: tham chiếu ngữ cảnh. Nếu bạn từng ước agent của mình có thể chỉ ra chính xác nơi nó lấy thông tin — giống như một bài nghiên cứu khoa học có trích dẫn vậy — thì đây chính là tính năng dành cho bạn.

Tham Chiếu Ngữ Cảnh Là Gì?

Hãy nghĩ về tham chiếu ngữ cảnh như chú thích cuối trang trong một cuốn sách. Khi agent của bạn xử lý một tài liệu, một cuộc trò chuyện, hoặc một tập tin, nó có thể ghi nhớ nơi mà các thông tin cụ thể đến từ. Thay vì chỉ nói “bầu trời màu xanh”, nó có thể nói “bầu trời màu xanh (từ weather_report.md, dòng 42)”.

Đây là một bước ngoặt lớn cho:

• Các tác vụ nghiên cứu — xác minh nguồn ngay lập tức
• Đánh giá mã nguồn — truy vết nơi phát sinh lỗi
• Công việc pháp lý hoặc tuân thủ — chứng minh sự kiện đến từ đâu
• Các cuộc trò chuyện dài — nhớ tin nhắn nào chứa chi tiết quan trọng

Cách Hoạt Động

Phép màu xảy ra ở hậu trường. Khi bạn cung cấp cho agent tài liệu, lịch sử trò chuyện, hoặc tập tin, Hermes tự động theo dõi nguồn gốc của từng phần nội dung. Bạn không cần làm gì đặc biệt — nó tự hoạt động.

Đây là một ví dụ đơn giản:

hermes chat --with file:contract.pdf

Đặt câu hỏi như “Điều khoản chấm dứt hợp đồng là gì?” và agent sẽ trả lời kèm trích dẫn chỉ đến phần cụ thể trong file PDF.

Các Tùy Chọn Cấu Hình Mới

Bản cập nhật mới nhất mang đến những cách mạnh mẽ để kiểm soát cách hoạt động của tham chiếu ngữ cảnh. Tất cả đều nằm trong tập tin ~/.hermes/config.yaml của bạn.

Bật và Tắt

Theo mặc định, tham chiếu ngữ cảnh được bật cho nội dung dạng tập tin. Nhưng bạn có thể kiểm soát chúng theo từng phiên:

context_references:
  enabled: true              # công tắc chính
  include_line_numbers: true # thêm số dòng vào trích dẫn
  max_citations: 5           # giới hạn số tham chiếu mỗi phản hồi

Định Dạng Trích Dẫn

Bạn có thể chọn cách trích dẫn hiển thị trong phản hồi:

context_references:
  format: markdown  # tùy chọn: markdown, plain, json

• markdown — [nguồn: file.md, dòng 12] (hiển thị đẹp trong giao diện chat)
• plain — (file.md:12) (gọn gàng, phù hợp cho terminal)
• json — đầu ra có cấu trúc cho mục đích lập trình

Làm Việc với Phiên

Tham chiếu ngữ cảnh phát huy sức mạnh trong các phiên làm việc dài. Agent nhớ tin nhắn nào đã giới thiệu một sự kiện, kể cả nhiều giờ sau đó:

hermes chat --session research-project

Hỏi “Lúc trước chúng ta biết gì về giá cả?” và nhận được trích dẫn chỉ đến chính xác tin nhắn từ hai giờ trước.

Mẹo Thực Hành

1. Sử Dụng Tên Tập Tin Mô Tả

Trích dẫn bao gồm tên tập tin, vì vậy hãy đặt tên có ý nghĩa:

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

Tốt hơn nhiều so với file1.txt, phải không?

2. Kết Hợp với Bộ Nhớ

Tham chiếu ngữ cảnh hoạt động tuyệt vời với hệ thống bộ nhớ của Hermes. Khi agent lưu trữ thứ gì đó trong memories/, nó cũng ghi lại nguồn. Sau này, khi nhớ lại thông tin đó, nó có thể cho bạn biết dữ liệu ban đầu đến từ đâu.

3. Kiểm Tra Cấu Hình Của Bạn

Sau khi cập nhật Hermes, hãy chạy:

hermes config check
hermes config migrate

Điều này đảm bảo bạn có tất cả các tùy chọn mới nhất.

Một Ví Dụ Nhanh

Hãy xem nó hoạt động thực tế:

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

Bạn: “Chúng ta đã thống nhất những mục hành động nào?”

Agent: “Dựa trên biên bản cuộc họp, bạn đã đồng ý:

1. Chốt ngân sách quý 3 (từ meeting-notes.md, dòng 15)
2. Lên lịch demo cho khách hàng (từ meeting-notes.md, dòng 22)
3. Cập nhật tiến độ dự án (từ meeting-notes.md, dòng 28)“

Thấy cách mỗi mục có trích dẫn riêng không? Đó chính là tham chiếu ngữ cảnh đang làm nhiệm vụ của mình.

Nhắc Lại Về Thứ Tự Ưu Tiên Cấu Hình

Hãy nhớ, các thiết lập được giải quyết theo thứ tự sau:

1. Đối số CLI — ưu tiên cao nhất
2. config.yaml — tập tin cấu hình chính của bạn
3. .env — chỉ dành cho bí mật
4. Giá trị mặc định tích hợp — dự phòng

Vì vậy bạn có thể ghi đè cài đặt tham chiếu ngữ cảnh theo từng lệnh:

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

Tổng Kết

Tham chiếu ngữ cảnh biến agent của bạn từ một “hộp đen” thành một trợ lý minh bạch, có thể kiểm chứng. Dù bạn đang nghiên cứu, gỡ lỗi mã nguồn, hay chỉ muốn tin tưởng vào câu trả lời của agent hơn, tính năng này cung cấp cho bạn bằng chứng.

Hãy thử với tài liệu của riêng bạn và cảm nhận sự tự tin tăng lên khi mỗi câu trả lời đều đi kèm nguồn gốc. Bản thân bạn trong tương lai — đang cố nhớ sự kiện đó đến từ đâu — sẽ cảm ơn bạn.

Chúc bạn trích dẫn vui vẻ! 🎯