Google Cloud, OKF v0.3 발표: 최신 검증만 신뢰 수준에 반영, Agent 스킬 2종 추가

Google Cloud가 개방형 지식 포맷 OKF v0.3을 공개했다. 적합성 규칙, 최신 검증만 인정하는 신뢰 수준, superseded_by 등을 추가했고 사용 사례 가이드와 Agent 스킬 2종도 내놨다.

뉴스 날짜: 읽는 데 약 8분

LINE 공유
목차
  1. 1. OKF v0.3은 v0.2와 무엇이 달라졌나?
  2. 2. agent 편집에 따라 신뢰 수준은 어떻게 갱신되나?
  3. 3. 기존 bundle에 영향을 줄 수 있는 변경은?
  4. 4. 사용 사례와 Agent 스킬이란?

Google Cloud는 Data Analytics 블로그에서 개방형 지식 포맷(Open Knowledge Format, OKF) v0.3이 게시 당일 공개됐다고 밝혔다. OKF는 순수 markdown과 YAML 파일로 AI agent(작업을 자동으로 수행하는 AI 어시스턴트)에 필요한 맥락을 제공하는 개방형 사양이며, 같은 폴더에 담겨 함께 전달되는 지식 파일 묶음을 bundle이라 부른다. 사양, 사용 사례, 스킬은 새 독립 GitHub 조직에 올라와 있다. 여러 agent가 지식 베이스를 함께 편집하고 조직 간에 교환하는 팀에게 이번 업데이트는 '누가 검토했고, 검토 뒤 내용이 다시 바뀌었는지'를 더 분명하고 믿을 수 있게 해 준다.

OKF v0.3은 v0.2와 무엇이 달라졌나?

Google Cloud 설명에 따르면 OKF는 6월에 나왔고, 7월의 v0.2는 출처, 신뢰, 최신성, 수명 주기, 인증 등의 신뢰 신호를 추가했다. v0.3은 bundle이 조직 사이를 오가는 경우, 여러 agent가 같은 지식 자료를 편집하는 경우, 독립 도구들이 같은 방식으로 bundle을 읽어야 하는 경우에 초점을 맞췄다.

  • 적합성: 서로 다른 도구가 bundle을 똑같이 읽도록 정한 공식 적합성 섹션을 추가했다. 사양은 독립적으로 완결되며 RFC 2119 키워드('해야 한다', '권장한다' 등 요구 수준을 나타내는 표준 용어)를 쓴다. YAML 1.2 frontmatter(파일 맨 앞의 메타데이터 블록), CommonMark(GFM 표와 각주 포함), RFC 3339 타임스탬프를 채택했다.
  • 공존: type이 없는 .md 파일은 OKF 소비자(bundle을 읽는 도구)가 건너뛰므로 README.md, AGENTS.md, CONTRIBUTING.md, SKILL.md를 bundle 안에 둘 수 있다.
  • 관용성: 소비자는 null, 빈 문자열, 목록이어야 할 곳에 단일 값이 온 입력을 받아들일 수 있다. 검증기는 형식 오류에 경고만 남기며, 선택 필드 누락이나 깨진 링크로 bundle이 실패하지 않는다.
  • 자기 기술: bundle 루트의 index.md는 okf_version, title, description, license 등의 frontmatter를 가질 수 있어, agent가 어떤 bundle을 쓸지 판단할 수 있다.
  • 대체: superseded_by를 추가해 폐기된 개념이 대체 개념을 가리키게 했으며, 이동과 이름 변경에도 쓸 수 있다.

agent 편집에 따라 신뢰 수준은 어떻게 갱신되나?

v0.2는 개념마다 unverified, machine-confirmed, human-reviewed의 세 신뢰 수준을 제공했다. Google은 v0.3에서 '현재 유효한' 검증만 계산하도록 규정했다고 밝혔다. 즉 검증 시각이 내용의 마지막 실질적 변경 시점(generated.at에 기록)보다 이르지 않아야 한다.

Google의 예시는 이렇다. 누군가 지표 정의를 검토하고 승인한 뒤 일주일 후 agent가 그 정의를 수정하면, 누군가 다시 확인할 때까지 해당 개념은 machine-confirmed로만 인정된다. 이전 승인은 이력으로 파일에 남으며, 인터페이스에서는 '마지막 변경 전에 검토됨'으로 표시할 수 있다. v0.3은 human:, process:와 나란히 쓰는 team: 행위자 접두사도 추가했다. 다만 팀 이름만으로는 실제로 누가 내용을 확인했는지 알 수 없으므로 human-reviewed는 human:만 얻을 수 있다.

기존 bundle에 영향을 줄 수 있는 변경은?

Google은 v0.3에 두 가지 호환성 파괴 변경이 있으며 기존 v0.2 bundle은 계속 읽을 수 있다고 밝혔다. 아래 표는 이 두 변경과 다른 주요 사항을 정리한 것이다.

OKF v0.3 주요 변경과 호환성 (Google Cloud 설명 기준 정리)
항목v0.3 방식호환성/비고
경로 필드와 링크 해석https: 같은 scheme이 있으면 절대 URL, /로 시작하면 bundle 루트 기준, 그 외는 해당 파일의 디렉터리 기준으로 해석호환성 파괴 변경. v0.2 이하 또는 버전 미표기 bundle은 소비자가 루트 기준으로도 해석할 수 있음
신뢰 수준현재 유효한 검증만 반영호환성 파괴 변경. 수준은 낮아지기만 하므로 별도 대체 처리가 필요 없음
bundle 메타데이터index.md에 okf_version, title, description, license를 둘 수 있음index.md를 다시 생성하는 도구는 이 frontmatter를 보존해야 함
확장 필드어느 수준에서나 허용. 편집 도구는 모르는 필드를 보존해야 함향후 버전은 x-로 시작하는 필드를 정의하지 않음
버전 정책1.0 이전의 마이너 버전은 호환성 파괴 변경이 가능하며 가능한 한 소비자용 대체 방안을 제공1.0부터 마이너 버전은 엄격히 추가형이며, 공개된 규범 문구는 제자리에서 수정하지 않음

사용 사례와 Agent 스킬이란?

OKF 핵심 사양은 일부러 간결하게 유지되며 Avro, Protobuf, OpenAPI 같은 기존 도메인 스키마와 연결된다. Google이 새로 내놓은 '사용 사례'는 다른 업계 표준과 함께 쓰는 가이드로, 각각 경계를 어떻게 나누는지, 둘을 어떻게 연결하는지, agent가 어떻게 활용해야 하는지를 설명하고 복사해 쓸 수 있는 완전한 예시를 담았다. 이들은 핵심 사양 위에 쌓이는 것이지 사양의 일부가 아니므로, 이를 무시한 bundle도 OKF를 준수한다. 사용 사례는 저장소 usecases/ 아래 각자의 폴더에 있으며, Google은 pull request로 제안하길 환영하고 초안이 거칠어도 괜찮다고 밝혔다.

두 스킬은 개방형 Agent Skills 포맷으로 제공되어 스킬을 지원하는 어떤 agent에서도 불러올 수 있다. Google 설명에 따르면 okf-generate는 bundle을 작성, 갱신, 이전하고 검증하며 모든 주장에 출처를 인용하고, 당사자가 확인한 경우에만 사람 검토를 기록한다. okf-consume은 bundle에서 질문에 답하면서 사용한 개념의 신뢰 수준, 상태, 최신성, 인증 결과를 보고하고, bundle에 설정된 executor와 attester를 통해서만 인증된 연산을 실행한다.

Gemini CLI에서 스킬은 어떻게 설치하나?

Google 글에는 아래 Gemini CLI 명령이 나와 있으며, 다른 agent의 설치 방법은 저장소 README를 참고하라.

Google 글의 Gemini CLI 설치 명령 (okf-generate, okf-consume) · bash
gemini skills install https://github.com/open-knowledge-format/open-knowledge-format --path skills/okf-generate
gemini skills install https://github.com/open-knowledge-format/open-knowledge-format --path skills/okf-consume

자주 묻는 질문

기존 v0.2 bundle을 계속 쓸 수 있나?

Google에 따르면 가능하다. 기존 v0.2 bundle은 계속 읽을 수 있으며 type은 여전히 유일한 필수 필드다. 경로 필드 해석에는 대체 메커니즘이 있지만, 신뢰 수준은 현재 유효한 검증만 계산하도록 바뀌어 일부 개념의 수준이 내려갈 수 있다.

사람이 검토한 뒤 agent가 수정하면 왜 수준이 낮아지나?

v0.3은 검증이 마지막 실질적 변경 이후에 이뤄져야 유효하다고 규정하기 때문이다. 이전 승인은 이력으로 남고, 누군가 다시 확인하기 전까지 개념은 machine-confirmed로만 인정된다.

사용 사례는 핵심 사양의 일부인가?

아니다. Google은 사용 사례가 핵심 사양 위에 얹히며, 이를 채택하지 않은 bundle도 OKF를 준수한다고 설명한다. 어떤 관례가 여러 사례에서 유효하다고 입증되면 일반 절차에 따라 핵심 사양에 넣자고 제안할 수 있다.

OKF의 코드와 사양은 어디에 있나?

Google에 따르면 프로젝트는 Google Cloud Platform GitHub 조직에서 독립 조직으로 옮겨졌다. 저장소는 github.com/open-knowledge-format/open-knowledge-format이며 사양, 예시, 사용 사례, 참조 구현이 들어 있다.

이 주제의 최신 뉴스 보기

이 정리가 도움이 되셨나요? 필요한 분께 공유해 보세요

LINE 공유

출처

위에 기재된 참고 자료와 확인일 기준 정보를 바탕으로 정리했습니다. 요금, 시간표, 기능, 이용 약관은 바뀔 수 있으므로 여행, 예약 또는 구매 전에 해당 공식 사이트에서 최신 정보를 확인해 주세요.

라이프스타일