Open Knowledge Format: De Markdown-standaard voor AI-agenten

AI-agenten zijn slechts zo slim als de context die je ze geeft.

De meeste teams lopen tegen dezelfde muur aan. Je hebt een bekwaam model en een solide framework. Maar de agent weet niets over jouw organisatie. Het kent je databasetabellen, je metriekformules of je incident runbooks niet.

Deze kennis is verspreid over Notion, Slack en wiki's. Om dit aan een agent te geven, bouw je meestal voor elke afzonderlijke bron een aangepaste integratie.

Het Open Knowledge Format (OKF) verandert dit.

OKF is een leverancier-neutrale specificatie. Het verpakt je kennis als eenvoudige markdown-bestanden. Elke agent kan het lezen zonder aangepaste SDK's of propriëtaire tools.

Hoe het werkt: Een OKF-bundel is een directory met markdown-bestanden. Elk bestand vertegenwoordigt een concept, zoals een tabel, een metriek of een API.

Waarom dit effectief is:

  • Identiteit via bestandspaden: Het bestandspad is de ID. Er is geen database of register nodig.
  • Kennisgrafen via links: Markdown-links creëren relaties tussen concepten. Dit verandert een map in een navigeerbare graaf.
  • Geen tooling vereist: Het bestandssysteem is de API. Je hebt geen nieuwe software nodig om het te gebruiken.

Hoe je het gebruikt:

  • Data-teams: Documenteer tabellen en metrieken zodat agenten nauwkeurige SQL schrijven.
  • SRE-teams: Schrijf runbooks zodat agenten incidenten kunnen diagnosticeren.
  • Platform-teams: Lever API-definities aan zodat agenten endpoints begrijpen.

OKF is geen vervanging voor RAG of MCP.

  • Gebruik OKF voor stabiele, gecureerde kennis zoals schema's en runbooks.
  • Gebruik RAG voor grote, ongestructureerde documentarchieven.
  • Gebruik MCP voor live data en tool-verbindingen.

Dit formaat maakt deel uit van de Apache 2.0-licentie. Het is goedkoop om te distribueren en voorkomt vendor lock-in. Je kennis leeft in je git-repository en blijft leesbaar voor elke tool.

Begin klein. Kies één team met rommelige documentatie. Schrijf drie OKF-bestanden en wijs een agent naar deze bestanden.

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

Optionele leercommunity: https://t.me/GyaanSetuAi