구글이 제안한 지식 관리의 새로운 표준, OKF (Open Knowledge Format)

안드로이드가 아닌 구글이 꿈꾸는 지식 표준화: OKF(Open Knowledge Format) v0.1을 뜯어보며

Concept & Paradigm

🧠 LLM Wiki를 넘어 조직간 지식 표준으로

일전에 안드레이 카파시(Andrej Karpathy)가 말했던 LLM Wiki가 개인의 지식을 기록하고 관리하기 위한 아이디어였다면, 구글 클라우드가 발표한 OKF (Open Knowledge Format) v0.1은 그것을 조직과 커뮤니티, 그리고 시스템 간에 교환할 수 있는 '표준 포맷'으로 한 단계 끌어올린 흥미로운 도구입니다.

간단히 정의하자면, OKF는 지식을 Markdown 파일과 YAML frontmatter의 단순한 결합으로 표준화하여 표현하는 공급업체 중립적인(Vendor-neutral) 오픈 포맷입니다. 특정 모델 제공업체나 프레임워크에 귀속되지 않는다는 점에서 지속 가능한 생태계를 구축하려는 의지가 돋보입니다.

Why OKF?

💡 왜 하필 OKF일까요? 5가지 핵심 강점

기존 서비스 종속적인 메타데이터 저장소들과 비교했을 때, OKF는 단순하면서도 강력한 유연성을 제공합니다.

• 인간과 AI 모두를 위한 완벽한 가독성: 개발자는 단순히 cat 명령어로 지식 파일을 열어볼 수 있고, LLM은 원본 마크다운을 컨텍스트에 날것 그대로 집어넣어 완벽하게 이해할 수 있습니다.
• 기본 탑재된 버전 관리(Git): 지식 번들이 깃(Git) 저장소에서 관리되므로 Pull Request, 라인별 Diff, 변경 이력 추적(Blame) 등의 기존 소프트웨어 엔지니어링 워크플로우를 그대로 활용할 수 있습니다.
• 락인(Lock-in) 없는 무한한 이식성: 특정 상용 API를 거칠 필요 없이, 압축 파일(Tarball)로 묶어 어디든 배포하거나 로컬 파일시스템에 마운트하여 자유롭게 사용할 수 있습니다.
• 구조화 데이터와 비구조화 데이터의 조화: 필터링이나 인덱싱이 필요한 메타데이터는 YAML 헤더에 담고, 사람이 읽는 친절한 설명, 스키마, 쿼리 예시 등은 마크다운 본문에 자유롭게 서술합니다.
• 유연한 그래프 구조 지원: 단순한 트리 구조를 넘어서서, 일반적인 마크다운 링크를 통해 개념과 개념 사이의 복잡한 연관 관계(Graph)를 자유롭게 엮어낼 수 있습니다.

Technical Details

⚙️ Enrichment Agent와 Visualizer로 확인하는 실체

구글 클라우드는 이 스펙을 단순히 문서로만 놔두지 않고, 실제로 작동하는 개념 증명(Proof of Concept) 에이전트와 시각화 도구를 함께 오픈소스로 공개했습니다.

이 에이전트는 Google Agent Development Kit(ADK)를 기반으로 작동하며, 백엔드 모델로는 Gemini를 활용합니다. 최초에 BigQuery 메타데이터 소스에서 정보를 가져온 뒤, 지정된 웹 시드 주소들을 기어가듯 탐색(Web Crawling)하여 자동으로 OKF 지식 문서를 만들어내고 보강(Enrichment)하는 방식으로 동작합니다.

실제 에이전트가 완벽하게 빌드하여 제공하고 있는 3가지 데이터 지식 번들 예시를 깃허브에서 바로 살펴볼 수 있습니다.

• bundles/ga4/ : 구글 머천다이즈 스토어의 GA4 이커머스 데이터셋 지식
• bundles/stackoverflow/ : 스택 오버플로우의 공개 데이터셋 스키마 정보
• bundles/crypto_bitcoin/ : 비트코인 블록 및 트랜잭션 관계 정보

특히, 같이 동봉된 시각화 명령어를 실행하면 별도의 백엔드 설치 없이 웹 브라우저에서 바로 열어볼 수 있는 상호작용형 단일 HTML 파일(viz.html)이 뚝딱 생성됩니다. 내부적으로는 Cytoscape.js와 marked 렌더러를 사용하여 화려한 네트워크 그래프와 정밀한 상세 페이지를 제공합니다.

How to Use

🛠️ 로컬 개발 환경 구성 및 실행 방법

프로젝트를 로컬 컴퓨터에서 구동하고 직접 나만의 지식 번들을 시각화하는 과정은 놀라울 정도로 직관적입니다.

1. 가상환경 세팅 및 패키지 설치

python3.13 -m venv .venv
.venv/bin/pip install --index-url https://pypi.org/simple/ -e .[dev]

2. 지식 번들을 활용해 가시화 파일 생성하기

.venv/bin/python -m enrichment_agent visualize --bundle ./bundles/crypto_bitcoin

해당 명령어를 실행하면 분석 폴더 하위에 viz.html 파일이 생성되며, 이를 더블 클릭하기만 하면 브라우저에서 인터랙티브 그래프 화면이 바로 열립니다.

📌 공식 리포지토리 및 출처:
Google Cloud Platform - Knowledge Catalog 공식 레포지토리: https://github.com/GoogleCloudPlatform/knowledge-catalog