Referensi Konteks — Kutipan yang Presisi

Selamat datang kembali di seri Hermes Agent kita! Hari ini kita akan membahas sesuatu yang membuat agenmu jauh lebih berguna: referensi konteks. Jika kamu pernah berharap agenmu bisa menunjuk tepat ke mana informasi itu didapat—seperti makalah penelitian yang proper dengan kutipan—fitur ini untukmu.

Apa Itu Referensi Konteks?

Bayangkan referensi konteks seperti catatan kaki di sebuah buku. Saat agenmu memproses dokumen, percakapan, atau file, ia kini bisa mengingat dari mana potongan informasi tertentu berasal. Alih-alih hanya berkata “langit itu biru,” ia bisa berkata “langit itu biru (dari weather_report.md, baris 42).”

Ini mengubah segalanya untuk:

• Tugas riset — verifikasi sumber secara instan
• Review kode — lacak di mana bug diperkenalkan
• Pekerjaan hukum atau kepatuhan — buktikan dari mana sebuah fakta berasal
• Percakapan panjang — ingat pesan mana yang memuat detail penting

Cara Kerjanya

Keajaiban terjadi di balik layar. Saat kamu memberi agenmu dokumen, riwayat chat, atau file, Hermes secara otomatis melacak asal setiap konten. Kamu tidak perlu melakukan sesuatu yang istimewa—semuanya berjalan otomatis.

Berikut contoh sederhananya:

hermes chat --with file:contract.pdf

Ajukan pertanyaan seperti “Apa klausul penghentiannya?” dan agen akan merespons dengan kutipan yang menunjuk ke bagian persis di PDF tersebut.

Opsi Konfigurasi Baru

Pembaruan terbaru menghadirkan beberapa cara baru yang powerful untuk mengontrol perilaku referensi konteks. Semuanya ada di file ~/.hermes/config.yaml kamu.

Mengaktifkan dan Menonaktifkan

Secara default, referensi konteks aktif untuk konten berbasis file. Tapi kamu bisa mengontrolnya per-sesi:

context_references:
  enabled: true              # saklar utama
  include_line_numbers: true # tambahkan nomor baris ke kutipan
  max_citations: 5           # batasi jumlah referensi per respons

Format Kutipan

Kamu bisa memilih bagaimana kutipan ditampilkan dalam respons:

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

• markdown — [sumber: file.md, baris 12] (tampil rapi di UI chat)
• plain — (file.md:12) (ringkas, bagus untuk terminal)
• json — output terstruktur untuk penggunaan programatik

Bekerja dengan Sesi

Referensi konteks bersinar dalam sesi yang berjalan lama. Agen mengingat pesan mana yang memperkenalkan sebuah fakta, bahkan berjam-jam kemudian:

hermes chat --session proyek-riset

Tanyakan “Apa yang kita pelajari tentang harga tadi?” dan dapatkan kutipan yang menunjuk ke pesan persis dari dua jam yang lalu.

Tips Praktis

1. Gunakan Nama File yang Deskriptif

Kutipan menyertakan nama file, jadi buatlah bermakna:

hermes chat --with docs/laporan-keuangan-Q3.md

Lebih baik daripada file1.txt, kan?

2. Kombinasikan dengan Memori

Referensi konteks bekerja dengan indah bersama sistem memori Hermes. Saat agen menyimpan sesuatu di memories/, ia juga mencatat sumbernya. Nanti, saat ia mengingat memori itu, ia bisa memberi tahu kamu dari mana informasi itu berasal.

3. Periksa Konfigurasi Kamu

Setelah memperbarui Hermes, jalankan:

hermes config check
hermes config migrate

Ini memastikan kamu memiliki semua opsi terbaru yang tersedia.

Contoh Singkat

Mari kita lihat langsung:

hermes chat --with ~/catatan/notulensi-rapat.md

Kamu: “Apa saja action item yang kita sepakati?”

Agen: “Berdasarkan notulensi rapat, kamu menyepakati:

1. Finalisasi anggaran Q3 (dari notulensi-rapat.md, baris 15)
2. Jadwalkan demo klien (dari notulensi-rapat.md, baris 22)
3. Perbarui timeline proyek (dari notulensi-rapat.md, baris 28)“

Lihat bagaimana setiap item punya kutipannya sendiri? Itulah referensi konteks bekerja.

Pengingat Prioritas Konfigurasi

Ingat, pengaturan diselesaikan dalam urutan ini:

1. Argumen CLI — prioritas tertinggi
2. config.yaml — file konfigurasi utama kamu
3. .env — hanya untuk rahasia
4. Default bawaan — cadangan

Jadi kamu bisa menimpa pengaturan referensi konteks per-perintah:

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

Penutup

Referensi konteks mengubah agenmu dari “kotak hitam” menjadi asisten yang transparan dan dapat diverifikasi. Baik kamu sedang riset, debugging kode, atau hanya ingin lebih percaya pada jawaban agenmu, fitur ini memberimu buktinya.

Coba dengan dokumenmu sendiri dan lihat seberapa lebih percaya dirimu saat setiap jawaban datang dengan sumbernya. Dirimu di masa depan—yang mencoba mengingat dari mana fakta itu berasal—akan berterima kasih.

Selamat mengutip! 🎯