Lanjut ke konten
Samkarsa Logbook

Ketik untuk mencari…

↑↓untuk navigasi
Esc

MCP v1.0.0-036: Universal URL Reader & Multi-Source Web Intelligence pada VibesChat

Peningkatan kapabilitas VibesChat dengan integrasi Universal URL Reader, auto-fallback dokumen logbook docs.samkarsa.com, dan eliminasi penolakan tautan luar.

2mnt baca

Sebelumnya pada VibesChat, ketika pengguna menyertakan tautan dokumen web (seperti tautan rilis logbook di docs.samkarsa.com, regulasi pemerintah, atau portal harga pasar), AI agen memberikan penolakan generik:

“Terkait aksesibilitas ke tautan tersebut, sistem saya saat ini tidak memiliki otorisasi untuk melakukan crawling atau membaca konten secara langsung dari domain eksternal docs.samkarsa.com…”

Penyelidikan arsitektur membuktikan bahwa penolakan tersebut disebabkan ketiadaan tool pembaca konten URL pada ReAct Reasoning Loop di mcp-server. Sistem sebelumnya hanya dilengkapi pencarian kata kunci sempit (web_search via DuckDuckGo), tanpa adanya modul pengekstraksi isi dokumen web (content extractor).

Pembaruan v1.0.0-036 menghadirkan arsitektur Dual-Track URL Retrieval yang tangguh dan aman:

  • Sanitasi HTML Tingkat Tinggi: Menyingkirkan elemen <script>, <style>, <nav>, <footer>, <header>, dan iklan pelacak, lalu mengonversi struktur heading (<h1>–<h6>) dan paragraf ke dalam format Markdown padat terstruktur (dibatasi maksimum 4.500 karakter untuk efisiensi token LLM).
  • Auto-Fallback Cerdas untuk docs.samkarsa.com: Secara otomatis mendeteksi dan mencoba variasi rute Astro (seperti toleransi terhadap format /posts/id/<slug> vs /posts/<slug>/ serta trailing slashes).
  • In-Memory TTL Cache (15 Menit): Mencegah pemanggilan HTTP berulang dalam sesi percakapan yang sama.

  • Mendaftarkan tool resmi fetch_url_content(url: string) ke dalam daftar kemampuan agen ReAct.
  • Menegakkan aturan Reasoning: Jika input kueri pengguna menyertakan tautan http:// atau https://, ReAct engine secara otomatis mengutamakan pemanggilan tool ini sebelum memberikan ulasan.
  • Menerapkan Smart Early Stop: Siklus ReAct segera berhenti dan melanjutkan ke sintesis saat konten URL berhasil diekstrak dalam 1 iterasi.

  • Regex pendeteksi URL mengekstrak tautan secara paralel saat kueri masuk.
  • Sistem prompt diperbarui secara eksplisit dengan instruksi: Dilarang menolak tautan web. AI diinstruksikan untuk menganalisis intisari dokumen dan mengaitkannya langsung dengan data keuangan serta operasional Toko Sembako Kusuma.

Pengujian dilakukan secara langsung di kontainer produksi VPS (mcp-backend-prod):

  1. Uji Tautan Logbook: Input kueri: "Tolong pelajari dan ringkas intisari dari tautan ini: https://docs.samkarsa.com/posts/id/jualan-v1-5-0-086-audit-accounting-reports-and-accounts-payable-anomaly/".
    • Waktu Respon: ReAct selesai dalam 1.666 ms (1 iterasi) dan sintesis selesai dalam 3.696 ms (Total < 6 detik).
    • Hasil Analisis: AI berhasil merangkum temuan audit PSAK (kepatuhan 88%), mengidentifikasi selisih utang Rp 2,08 Juta, menjelaskan akar masalah double cash deduction, serta memberikan 3 rekomendasi taktis tanpa satupun penolakan akses.
  2. Uji Dokumen Web Eksternal: Uji pembacaan halaman publik berhasil mengekstrak judul, struktur teks, dan membuang elemen non-konten secara bersih.

  • Service mcp-backend berhasil dikompilasi ulang dan berjalan aktif di VPS (http://76.13.19.28:3000).
  • Fitur Universal URL Reader telah aktif sepenuhnya dan siap digunakan oleh pengguna di antarmuka VibesChat Blonjo.