구글 Open Knowledge Format 공개 - AI 에이전트를 위한 지식 공유 표준 한 번에 정리

!img

구글 Open Knowledge Format 공개 - AI 에이전트를 위한 지식 공유 표준

2026년 6월 현재 AI 에이전트 생태계는 LLM-wiki 패턴을 중심으로 빠르게 발전하고 있지만, 위키마다 형식이 제각각이라 다른 조직의 지식을 그대로 가져다 쓰기 어려운 상황입니다. 구글이 5월에 공개한 Open Knowledge Format(OKF) v0.1은 이 문제를 정면으로 다루는 벤더 중립적 개방형 사양입니다. 핵심 아이디어는 단순합니다 — YAML frontmatter가 포함된 markdown 파일 디렉터리 하나로, 사람이 읽을 수 있고 에이전트가 파싱할 수 있고 git으로 버전 관리할 수 있는 지식 번들을 정의합니다. 본문에서는 OKF의 구조, 핵심 필드, 크로스 링킹 규약, 그리고 LLM-wiki 패턴과의 비교까지 한 번에 정리합니다.

OKF가 해결하려는 문제

서로 다른 조직이 각자의 방식으로 위키를 만들면, 한 팀이 만든 노트를 다른 팀의 에이전트가 그대로 소비하기 어렵습니다. 일부는 JSON 스키마에 갇혀 있고, 일부는 자체 DSL에 의존하며, 일부는 데이터베이스 뒤에 숨어 있습니다. OKF는 이런 비호환성을 줄이기 위해 다음 네 가지 속성을 동시에 만족시키는 형식을 지향합니다.

• 사람도 tooling 없이 읽을 수 있는 가독성
• 에이전트가 별도 SDK 없이 파싱할 수 있는 단순성
• git diff로 진화 과정을 추적할 수 있는 버전 친화성
• 조직·도구·시대를 가로질러 이동 가능한 휴대성

OKF v0.1 핵심 사양

OKF는 스키마 레지스트리도, 중앙 권위 기관도, 필수 SDK도 두지 않습니다. 파일 하나를 cat으로 읽을 수 있으면 OKF이고, 저장소를 git clone으로 받을 수 있으면 그대로 배포할 수 있습니다. 이런 극단적 미니멀리즘이 LLM-wiki 패턴을 이식 가능하고 상호운용 가능한 형태로 정형화하는 출발점이 됩니다.

사양은 11개 섹션 + 부록 A로 구성되며, 그중에서도 핵심은 4. Concept Documents입니다. 모든 컨셉은 .md 파일 하나에 frontmatter와 body 두 부분으로 나뉘어 표현됩니다.

Knowledge Bundle 구조

번들은 자체 완결적인 디렉터리 트리입니다. 저장 형태는 git 저장소를 권장하지만 tarball이나 zip도 허용됩니다. 디렉터리 구조는 도메인에 맞춰 자유롭게 구성할 수 있습니다.

path/to/bundle/
├── index.md
├── log.md
├── .md
└── /
    ├── index.md
    ├── .md
    └── ...

Concept ID 규칙

Concept ID는 번들 내 파일 경로에서 .md 접미사를 제거한 값입니다. 예를 들어 tables/users.md의 Concept ID는 tables/users가 됩니다. 이 규칙 하나로 디렉터리 계층이 곧 컨셉 계층이 되고, 크로스 링킹의 토대가 됩니다.

Concept Document의 구조

모든 컨셉은 frontmatter와 body 두 부분으로 나뉩니다. frontmatter는 YAML로 작성하며 컨셉의 메타데이터를 담고, body는 사람이 읽을 수 있는 마크다운 본문을 담습니다.

필수/선택 frontmatter 필드

| 필드 | 필수 여부 | 설명 |

|------|-----------|------|

| type | REQUIRED | 컨셉 타입 이름 (예: BigQuery Table) |

| title | optional | 표시용 이름 |

| description | optional | 한 줄 요약 |

| resource | optional | 연결된 자원의 canonical URI |

| tags | optional | 검색·분류용 태그 배열 |

| timestamp | optional | ISO 8601 최종 수정 시각 |

type 필드 하나만 REQUIRED이며, 나머지는 모두 producer가 자유롭게 정의할 수 있습니다. 이렇게 최소 필드만 표준화하고 나머지는 위임하는 설계가 OKF의 핵심 철학입니다.

frontmatter + schema 예시

---
type: BigQuery Table
title: Customer Orders
description: One row per completed customer order across all channels.
resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders