व्यावहारिक RAG: गूगल के ओपन नॉलेज फॉर्मेट (OKF) का परीक्षण

यदि आपने एआई एजेंटों को एक वास्तविक कोडबेस में एकीकृत किया है, तो आप शायद वेक्टर सर्च की सीमाओं से परिचित होंगे।

जब आप एक एजेंट को एक एपीआई एंडपॉइंट को रिफैक्टर करने के लिए कहते हैं, तो वह वेक्टर लुकअप के माध्यम से फ़ंक्शन बॉडी को पुनर्प्राप्त करता है। लेकिन इसमें डेटाबेस स्कीमा, प्रमाणीकरण मिडलवेयर लॉजिक और परिनियोजन रनबुक छूट जाते हैं क्योंकि वे वेक्टर स्पेस में पर्याप्त रूप से ओवरलैप नहीं थे।

एजेंट विफल हो जाता है क्योंकि यह संदर्भ के शून्य में काम कर रहा है।

इस "संदर्भ-संयोजन" समस्या को हल करने के लिए, गूगल क्लाउड ने ओपन नॉलेज फॉर्मेट (OKF) विनिर्देश प्रकाशित किया। यह एक स्वतंत्र मानक है जो टेक्स्ट फ़ाइलों की डायरेक्टरी को एक सिमेंटिक नॉलेज ग्राफ़ में बदल देता है जिसे एआई एजेंट पुनरावर्ती रूप से नेविगेट कर सकते हैं।

यहाँ इसके कार्यान्वयन पर मेरा व्यावहारिक दृष्टिकोण दिया गया है।

---

अवधारणा: OKF क्या है?

OKF यह औपचारिक रूप देता है जो कई टीमें पहले से ही कर रही थीं: YAML फ्रंटमैटर के साथ स्वच्छ मार्कडाउन फ़ाइलों के रूप में आंतरिक दस्तावेज़ीकरण को संरचित करना।

किसी जटिल डेटाबेस को पेश करने के बजाय, OKF दो वेब मानकों पर निर्भर करता है:

1. फ़ाइल-स्तरीय मेटाडेटा के लिए YAML फ्रंटमैटर।
2. फ़ाइलों के बीच संबंधों को घोषित करने के लिए मानक मार्कडाउन लिंक।

दस्तावेज़ों को सीधे टेक्स्ट के भीतर लिंक करके, आप अपने दस्तावेज़ीकरण को एक नॉलेज ग्राफ़ में बदल देते हैं। कोई भी एआई एजेंट इन लिंक्स का अनुसरण कर सकता है।

---

एक ठोस उदाहरण

एक साझा यूआई कंपोनेंट लाइब्रेरी रिपॉजिटरी में, आप अपनी OKF नॉलेज बेस को इस तरह संरचित कर सकते हैं:

/knowledge-base
  ├── components/
  │   └── interactive-modal.md
  ├── compliance/
  │   └── wcag-checklist.md
  └── tokens/
      └── theme-palette.md

इनमें से प्रत्येक फ़ाइल एक न्यूनतम फ्रंटमैटर ब्लॉक के साथ शुरू होती है। विनिर्देश बहुत हल्का है; एकमात्र आवश्यक फ़ील्ड type है।

यहाँ interactive-modal.md के लिए YAML हेडर है:

---
type: "ui-component"
title: "Interactive Modal Dialog"
description: "Accessibility-compliant overlay specification supporting dynamic focus trapping and theme tokens."
timestamp: "2026-07-06T12:00:00Z"
tags: ["react", "wcag", "accessibility", "design-system"]
---

और मार्कडाउन सामग्री के अंदर, हम सापेक्ष लिंक का उपयोग करके संबंधों को परिभाषित करते हैं:

The Modal component manages overlays and traps keyboard focus internally. 
For semantic HTML and ARIA attribute rules, refer to the [WCAG AA Compliance Checklist](../compliance/wcag-checklist.md).
To style backdrop filters and component states, import design tokens from the [Theme Palette Config](../tokens/theme-palette.md).

---

कैसे एजेंट ग्राफ़ को नेविगेट करते हैं

पारंपरिक RAG कीवर्ड या वेक्टर खोज का उपयोग करता है, शीर्ष 5 टुकड़ों को लाता है और उन्हें प्रॉम्प्ट में डाल देता.

OKF एक ट्रैवर्सल RAG रणनीति की अनुमति देता है:

1. प्रवेश बिंदु का चयन: एजेंट प्रारंभिक प्रासंगिक दस्तावेज़ पाता है (जैसे, interactive-modal.md).
2. पुनरावर्ती पार्सिंग: एजेंट दस्तावेज़ को पार्स करता है और सभी सापेक्ष लिंक निकालता है।
3. संदर्भ संयोजन: रिएक्ट कोड लिखने से पहले, एजेंट जुड़े हुए दस्तावेज़ों (WCAG दिशानिर्देश और डिज़ाइन टोकन) को लोड करता है।

---

निष्कर्ष: क्या यह उपयोगी है?

लाभ:

• कोई वेंडर लॉक-इन नहीं: यह सिर्फ मार्कडाउन है।
• गिट-संगत संस्करण: दस्तावेज़ अपडेट मानक पुल अनुरोधों के माध्यम से जाते हैं।
• एजेंट स्वतंत्रता: एजेंटों को केवल एक मानक मार्कडाउन पार्सर की आवश्यकता होती है।

सीमाएं:

• टूटे हुए लिंक: फ़ाइलों को स्थानांतरित करने पर सापेक्ष लिंक टूट जाते हैं। सीआई पाइपलाइन में लिनटर का उपयोग करें।
• रखरखाव ओवरहेड: प्रत्येक कोड परिवर्तन के साथ फ्रंटमैटर और लिंक को अपडेट करने की प्रतिबद्धता की आवश्यकता होती है।