Open Knowledge Format은 Google Cloud에서 제공하는 오픈 사양 (open specification)으로, 지식 체계를 일반 마크다운 (markdown) 파일 디렉토리로 표현합니다. 각 개념 (concept) 파일은 작은 YAML 프론트매터 (frontmatter) 블록과 자유 형식의 본문을 포함합니다. 이 목표는 SDK나 종속될 카탈로그 없이도, 사람이 읽을 수 있고 기계가 파싱 (parse)할 수 있는 방식으로 AI 에이전트 (AI agent)에게 필요한 컨텍스트 (context)를 전달하는 휴대 가능한 방법을 제공하는 것입니다. Google Cloud는 2026년 6월에 이를 버전 0.1로 발표했습니다.

OKF 번들 (bundle)의 구성 요소

번들은 마크다운 파일들의 폴더이며, 그 내부의 단위는 개념 (concept)입니다. 개념은 에이전트 (agent)를 위해 캡처할 가치가 있는 모든 것, 즉 테이블 (table), 데이터셋 (dataset), 메트릭 (metric), 런북 (runbook), API 등을 의미합니다. 모든 개념은 두 부분으로 구성된 하나의 UTF-8 마크다운 문서입니다. 상단에는 위아래로 세 개의 대시(---)로 구분된 YAML 프론트매터 (frontmatter) 블록이 있고, 그 아래에 마크다운 본문이 위치합니다.

이 형식은 정확히 하나의 필드인 type을 요구합니다. 제목 (title), 설명 (description), 리소스 (resource), 태그 (tags), 타임스탬프 (timestamp)를 포함한 다른 모든 것은 선택 사항입니다. 어떤 타입이 존재하고 각 타입이 어떤 필드를 갖는지는 번들을 생성하는 사람에게 맡겨져 있습니다. 개념들은 일반적인 마크다운 링크 (markdown links)를 통해 서로를 참조하므로, 폴더는 단순한 파일 목록이 아닌 관련 지식의 그래프 (graph)가 됩니다.

구조적 상호운용성, 아직은 의미론적이지 않음

버전 0.1은 소수의 사항을 고정하고 나머지는 열어둡니다. 마크다운 파일 폴더로서의 번들 형태, YAML 프론트매터 (frontmatter), 두 개의 예약된 파일 이름, 그리고 단일 필수 필드를 고정합니다. 이것이 구조적 상호운용성 (structural interoperability)입니다. 즉, 어떤 도구라도 번들을 열어 구성 요소가 어디에 있는지 알 수 있습니다.

이 형식이 고정하지 않는 것은 의미 (meaning)입니다. 이 형식은 메트릭 (metric) 개념이 반드시 무엇을 포함해야 하는지, 또는 두 생산자가 어떻게 동일한 필드 이름을 합의해야 하는지에 대해 말하지 않습니다. 그것은 의미론적 상호운용성 (semantic interoperability)이며, 버전 0.1은 이를 생산자와 아직 작성되지 않은 관례 (conventions)에 맡깁니다. 이것이 OKF 관련 발표를 읽을 때 유념해야 할 경계선입니다. 이 형식은 파일의 형태를 표준화하는 것이지, 파일이 무엇을 의미하는지를 아직 표준화하는 것은 아닙니다.

OKF가 에이전트 준비성 (agent-readiness)에서 차지하는 위치

독립적인 스캐너에 의해 측정되는 에이전트 준비성 (agent-readiness)은 에이전트가 귀하의 공개 사이트에 도달하여 읽을 수 있는지 여부에 관한 것입니다. OKF는 그 옆에서 한 단계 더 안쪽의 계층에 위치합니다. 이는 에이전트가 정문을 통과한 후 작업에 활용하는 내부 지식, 즉 의사결정에 의존하게 되는 카탈로그 (catalog), 지표 (metrics), 규칙 (rules)을 패키징하는 방법입니다.

따라서 OKF는 llms.txt나 사이트의 마크다운 (markdown) 표면을 대체하는 것이 아닙니다. 이는 특수한 클라이언트 없이도 에이전트가 읽을 수 있는 평문 (plain text)을 사용한다는 동일한 직관을 바탕으로 하되, 사이트 전면에 보이는 페이지가 아니라 사이트 이면의 데이터와 컨텍스트 (context)에 적용한 것입니다. 에이전트가 무엇을 볼 수 있는지뿐만 아니라 무엇을 바탕으로 행동할지를 고민하는 팀에게, OKF는 바로 그 그림의 부분을 다룹니다.

현재 이를 어떻게 활용할 것인가

OKF는 새롭고 규모가 작은 버전 0.1 단계이며, 의미론적 (semantic) 측면은 여전히 열려 있습니다. 이는 지금 이해하고 지켜볼 가치가 있다는 뜻이지만, 전체 지식 카탈로그를 구축하기에는 아직 이른 단계입니다. 만약 이미 에이전트에게 마크다운을 제공하고 llms.txt를 유지하고 있다면, 귀하는 이미 OKF가 공식화하려는 직관을 가지고 있는 것이며, 나중에 이를 채택하는 것은 재구축이 아닌 짧은 단계가 될 것입니다.

AI 에이전트가 귀하의 사이트와 그 이면의 데이터를 얼마나 읽기 쉽게 읽을 수 있는지에 대한 감사를 원하시면 info@turva.dev로 문의하십시오.

관련 항목

• llms.txt 설명 (llms.txt explained)
• 에이전트에게 마크다운 제공하기 (Serving markdown to agents)
• 에이전트가 데이터에 따라 행동하게 하기: 의사결정 봉투 (Letting agents act on data: the decision envelope)

원문 게시 위치: https://turva.dev/guides/open-knowledge-format