Open Knowledge Format: Standar Markdown untuk Agen AI

Agen AI hanya sepintar konteks yang Anda berikan kepada mereka.

Sebagian besar tim menghadapi kendala yang sama. Anda memiliki model yang mumpuni dan kerangka kerja yang solid. Namun, agen tersebut tidak tahu apa-apa tentang organisasi Anda. Ia tidak mengetahui tabel basis data, formula metrik, atau buku panduan insiden (runbooks) Anda.

Pengetahuan ini tersebar di Notion, Slack, dan wiki. Untuk memberikannya kepada agen, Anda biasanya harus membangun integrasi khusus untuk setiap sumber.

Open Knowledge Format (OKF) mengubah hal ini.

OKF adalah spesifikasi netral vendor. OKF mengemas pengetahuan Anda sebagai file markdown biasa. Agen apa pun dapat membacanya tanpa perlu SDK khusus atau alat berpemilik (proprietary tools).

Cara kerjanya: Bundel OKF adalah sebuah direktori berisi file-file markdown. Setiap file mewakili sebuah konsep seperti tabel, metrik, atau API.

Mengapa ini efektif:

  • Identitas melalui jalur file: Jalur file adalah ID-nya. Tidak diperlukan basis data atau registri.
  • Graf pengetahuan melalui tautan: Tautan Markdown menciptakan hubungan antar konsep. Ini mengubah sebuah folder menjadi graf yang dapat dinavigasi.
  • Tidak memerlukan alat tambahan: Sistem file adalah API-nya. Anda tidak memerlukan perangkat lunak baru untuk menggunakannya.

Cara menggunakannya:

  • Tim data: Dokumentasikan tabel dan metrik agar agen dapat menulis SQL yang akurat.
  • Tim SRE: Tulis buku panduan (runbooks) agar agen dapat mendiagnosis insiden.
  • Tim platform: Sediakan definisi API agar agen memahami endpoint.

OKF bukanlah pengganti RAG atau MCP.

  • Gunakan OKF untuk pengetahuan yang stabil dan terkurasi seperti skema dan buku panduan.
  • Gunakan RAG untuk arsip dokumen besar yang tidak terstruktur.
  • Gunakan MCP untuk data langsung (live data) dan koneksi alat.

Format ini merupakan bagian dari lisensi Apache 2.0. Format ini murah untuk diterapkan dan mencegah ketergantungan pada vendor (vendor lock-in). Pengetahuan Anda tersimpan di repositori git Anda dan tetap dapat dibaca oleh alat apa pun.

Mulailah dari hal kecil. Pilih satu tim dengan dokumentasi yang berantakan. Tulis tiga file OKF dan arahkan agen ke file-file tersebut.

Sumber: https://dev.to/suhas_mallesh/open-knowledge-format-okf-the-markdown-standard-your-ai-agents-have-been-waiting-for-3mfb

Komunitas belajar opsional: https://t.me/GyaanSetuAi