AI 에이전트가 실무에서 자주 막히는 이유는 모델 성능만이 아닙니다. 테이블 스키마, 지표 정의, 런북, API 설명, 업무 규칙이 여러 시스템에 흩어져 있으면 에이전트는 작업을 시작하기 전에 맥락부터 다시 찾아야 합니다.
Google Cloud가 소개한 Open Knowledge Format, 즉 OKF는 이 문제를 새로운 플랫폼이 아니라 벤더 중립적인 파일 형식으로 풀려는 시도입니다. OKF 0.1은 아직 Draft 버전이며, 데이터와 시스템 주변의 메타데이터, 맥락, 큐레이션된 인사이트를 Markdown과 YAML 프런트매터로 표현하는 개방형 사양입니다.1
OKF는 지식을 담는 최소한의 파일 규칙이다
OKF 번들은 YAML 프런트매터가 포함된 Markdown 파일들의 디렉터리입니다. 각 파일은 하나의 개념을 설명합니다. 예를 들어 테이블, API, 메트릭, 플레이북, 업무 프로세스 같은 대상이 각각 하나의 문서가 될 수 있습니다.1
문서 상단의 YAML 프런트매터에는 구조화된 메타데이터를 넣고, 본문에는 사람이 읽을 수 있는 설명을 Markdown으로 작성합니다. OKF에서 각 개념에 필수인 필드는 type입니다. title, description, resource, tags, timestamp는 권장 필드로 제시됩니다.1
핵심은 “많은 것을 강제하지 않는다”는 점입니다. OKF에는 스키마 레지스트리, 중앙 권한자, 필수 도구가 없습니다.1 번들도 Git 저장소, tarball, zip 아카이브, 더 큰 저장소의 하위 디렉터리 등 다양한 방식으로 배포할 수 있습니다.1
즉 OKF가 표준화하려는 것은 완성된 지식 관리 시스템이 아니라, 지식 코퍼스를 자기 설명적으로 만들기 위한 최소한의 구조적 관례입니다.1
왜 중요한가: 지식이 도구 밖으로 이동할 수 있다
OKF의 실용적 의미는 지식을 특정 벤더나 특정 도구 안에 가두지 않는 데 있습니다. 사양은 사람이 작성하고, 에이전트가 생성하며, 조직 간에 교환하고, 사람과 에이전트가 모두 소비할 수 있는 형식을 목표로 합니다.1
이 접근은 기존 사내 위키나 문서 저장소와 닮아 있습니다. 차이는 문서에 최소한의 공통 규칙을 부여해, 다른 도구나 에이전트가 읽고 탐색할 수 있는 가능성을 높인다는 점입니다. 한 팀이 만든 지식 번들을 다른 팀의 에이전트가 큰 변환 없이 활용할 수 있다면, 문서는 단순한 참고 자료를 넘어 재사용 가능한 맥락 자산이 됩니다.
OKF가 고정된 개념 유형 분류 체계를 정의하지 않는 것도 같은 맥락입니다.1 생산자는 필요한 type을 자유롭게 정할 수 있고, 소비자는 모르는 타입이 있어도 전체 번들을 거부하지 않는 방향으로 설계됩니다. 엄격한 통제보다는 느슨한 호환성을 우선하는 방식입니다.
어디에 먼저 써볼 수 있을까
OKF를 검토할 때 처음부터 전사 지식 그래프를 떠올릴 필요는 없습니다. 오히려 작은 범위에서 시작하는 편이 현실적입니다.
예를 들어 다음과 같은 지식부터 OKF 번들로 정리해볼 수 있습니다.
핵심 데이터셋과 테이블 설명
자주 쓰는 비즈니스 메트릭 정의
장애 대응 런북
내부 API 사용법
반복되는 업무 프로세스
각 문서에 type과 간단한 설명을 붙이고, 관련 문서를 Markdown 링크로 연결하는 것만으로도 출발점이 됩니다. 이후 에이전트가 문서를 생성하거나 보강하는 흐름을 붙이면, OKF가 목표로 하는 enrichment agent와 consumption agent의 활용 가능성도 시험해볼 수 있습니다.1
지금 봐야 할 판단 기준
OKF가 당장 널리 쓰이는 표준이 될지는 아직 알 수 없습니다. 0.1 Draft라는 점도 분명히 감안해야 합니다.1 따라서 지금의 관전 포인트는 “완성도 높은 표준인가”보다 “AI 에이전트가 읽고 재사용할 맥락을 어떤 형식으로 관리할 것인가”에 가깝습니다.
OKF가 주는 실무적 교훈은 명확합니다. AI 에이전트 시대의 문서는 사람만 읽는 설명에 머물 수 없습니다. 문서는 파일로 이동 가능하고, 최소한의 메타데이터를 갖추며, 에이전트가 탐색하고 재사용할 수 있는 형태로 정리되어야 합니다.
OKF는 그 방향을 보여주는 초기 사양입니다. 지금 당장 대규모 도입을 결정하기보다, 흩어진 핵심 지식을 작은 OKF 번들로 정리해보며 조직의 문서와 에이전트 활용 방식을 점검하는 데 의미가 있습니다.
1knowledge-catalog/okf/SPEC.md at main · GoogleCloudPlatform/knowledge-catalog · GitHub
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.