Open Knowledge Format: Standard Markdown untuk Ejen AI

Ejen AI hanya sepintar konteks yang anda berikan kepada mereka.

Kebanyakan pasukan menghadapi halangan yang sama. Anda mempunyai model yang berkemampuan dan rangka kerja yang mantap. Namun, ejen tersebut tidak tahu apa-apa tentang organisasi anda. Ia tidak mengetahui jadual pangkalan data, formula metrik, atau runbook insiden anda.

Pengetahuan ini bertebaran di Notion, Slack, dan wiki. Untuk memberikannya kepada ejen, anda biasanya perlu membina integrasi tersuai bagi setiap sumber.

Open Knowledge Format (OKF) mengubah perkara ini.

OKF adalah spesifikasi neutral vendor. Ia membungkus pengetahuan anda sebagai fail markdown biasa. Mana-mana ejen boleh membacanya tanpa memerlukan SDK tersuai atau alatan proprietari.

How it works: Satu bundle OKF ialah direktori fail markdown. Setiap fail mewakili satu konsep seperti jadual, metrik, atau API.

Why this is effective:

  • Identiti melalui laluan fail: Laluan fail adalah ID tersebut. Tiada pangkalan data atau daftar diperlukan.
  • Graf pengetahuan melalui pautan: Pautan Markdown mencipta hubungan antara konsep. Ini menukarkan folder menjadi graf yang boleh dilayari.
  • Tiada alatan diperlukan: Sistem fail adalah API tersebut. Anda tidak memerlukan perisian baharu untuk menggunakannya.

How to use it:

  • Pasukan data: Dokumentasikan jadual dan metrik supaya ejen dapat menulis SQL yang tepat.
  • Pasukan SRE: Tulis runbook supaya ejen dapat mendiagnosis insiden.
  • Pasukan platform: Hantar definisi API supaya ejen memahami endpoint.

OKF bukanlah pengganti kepada RAG atau MCP.

  • Gunakan OKF untuk pengetahuan yang stabil dan terkurasi seperti skema dan runbook.
  • Gunakan RAG untuk arkib dokumen yang besar dan tidak berstruktur.
  • Gunakan MCP untuk data langsung dan sambungan alatan.

Format ini adalah sebahagian daripada lesen Apache 2.0. Ia murah untuk diedarkan dan mengelakkan kuncian vendor (vendor lock-in). Pengetahuan anda tersimpan dalam repositori git anda dan kekal boleh dibaca oleh mana-mana alatan.

Bermula secara kecil-kecilan. Pilih satu pasukan dengan dokumentasi yang tidak teratur. Tulis tiga fail OKF dan halakan ejen ke arahnya.

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

Optional learning community: https://t.me/GyaanSetuAi