Atgal į žurnalą
•3 min. skaitymo

Pragmatiškas RAG: Google Open Knowledge Format (OKF) bandymas

Vien tik vektorių paieška neišsprendžia konteksto surinkimo problemos DI agentams. Štai kaip aš struktūrizavau repozitorijos dokumentaciją kaip naršomą markdown grafiką naudodamas OKF specifikaciją.

Google CloudAI AgentsRAGMarkdown
Pragmatiškas RAG: Google Open Knowledge Format (OKF) bandymas

Jei integravote DI agentus į realią kodo bazę, tikriausiai susidūrėte su paprastos vektorių paieškos ribomis.

Paprašote agento refaktūrizuoti API galutinį tašką, ir jis nuskaito funkcijos kūną naudodamas vektorių paiešką. Tačiau jam trūksta duomenų bazės schemos, autentifikavimo tarpinės programinės įrangos ir diegimo instrukcijų, nes jie neturėjo pakankamai semantinio sutapimo.

Agentas patiria nesėkmę, nes veikia konteksto vakuume.

Siekdama išspręsti šią „konteksto surinkimo“ problemą, „Google Cloud“ paskelbė Open Knowledge Format (OKF) specifikaciją. Tai nepriklausomas standartas, skirtas paversti tekstinių failų katalogą semantiniu žinių grafu, kurį DI agentai gali naršyti rekursyviai.

Štai mano praktinė patirtis su jo įgyvendinimu.

Koncepcija: kas yra OKF?

OKF formalizuoja tai, ko daugelis platformų komandų jau darė: vidinės dokumentacijos struktūrizavimą kaip švarų Markdown failų katalogą su YAML antraštėmis.

Vietoj sudėtingų žinių grafikų duomenų bazių, OKF remiasi dviem interneto standartais:

  1. YAML Frontmatter failo lygio metaduomenims (deklaruoti, kas yra failas).
  2. Standartinėmis Markdown nuorodomis ryšiams tarp failų deklaruoti.

Susiedami failus tiesiogiai tekste, paverčiate savo dokumentaciją žinių grafu. Bet kuris agentas gali sekti šias nuorodas kaip paieškos robotas.

Konkretus pavyzdys

UI komponentų bibliotekos repozitorijoje galite struktūruoti savo OKF žinių bazę taip:

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

Kiekvienas iš šių failų prasideda minimaliu antraštės bloku. Specifikacija yra lengva, vienintelis privalomas laukas yra type.

Štai interactive-modal.md YAML antraštė:

---
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"]
---

Markdown turinyje apibrėžiame ryšius naudodami santykines nuorodas:

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).

Kaip DI agentai naršo žinių grafiką

Tradicinis RAG ieško raktinių žodžių ar vektorių, nuskaito 5 geriausius fragmentus ir įkelia juos į užklausą.

OKF leidžia taikyti naršymo RAG strategiją:

  1. Pradinio taško pasirinkimas: Agentas randa pirmąjį susijusį dokumentą (pvz., interactive-modal.md).
  2. Rekursyvus analizavimas: Agentas analizuoja dokumentą ir ištraukia visas santykines nuorodas.
  3. Konteksto surinkimas: Agentas rekursyviai įkelia susijusius failus (WCAG gaires ir dizaino raktus), kad sukurtų pilną kontekstą prieš rašydamas React kodą.

Išvada: ar verta?

Privalumai:

  • Jokio prisirišimo prie tiekėjo: Tai tiesiog Markdown.
  • Git suderinamumas: Dokumentacijos atnaujinimai atliekami per standartines Pull užklausas.
  • Agentų nepriklausomybė: Agentams reikalingas tik standartinis markdown analizatorius.

Trūkumai:

  • Nutrūkusios nuorodos: Santykinės nuorodos nutrūksta perkėlus failus. Naudokite linterį savo CI procesuose.
  • Priežiūros išlaidos: Reikalauja įsipareigojimo atnaujinti antraštes ir nuorodas su kiekvienu kodo pakeitimu.
Share this article