피드로 돌아가기
Dev.toAI/ML
원문 읽기
Markdown 기반 OKF 도입을 통한 Agent 지식 전송 표준화
Google's Open Knowledge Format is just Markdown in folders (and that's the point)
AI 요약
Context
지식 베이스가 특정 벤더의 데이터베이스나 독자적 포맷에 종속되어 AI Agent의 데이터 접근성이 저하되는 문제 발생. 툴마다 서로 다른 메타데이터 구조로 인해 지식 파편화 및 마이그레이션 비용 증가하는 한계 노출.
Technical Solution
- Markdown 파일과 폴더 계층 구조를 활용한 단순 파일 시스템 기반의 지식 저장 체계 설계
- YAML Frontmatter 내 'type' 필드 필수 정의를 통해 문서의 역할과 메타데이터 표준화
- 폴더별 index.md(Collection type) 배치를 통한 AI Agent의 점진적 컨텍스트 탐색 및 토큰 최적화 구현
- 표준 Markdown Link를 활용하여 파일 간 관계를 그래프 구조로 정의함으로써 Agent의 추론 경로 확보
- log.md 파일을 통한 변경 이력 관리 체계 구축으로 데이터 정합성 및 추적 가능성 확보
- SDK, Database, Runtime이 배제된 무상태(Stateless) 포맷 설계를 통한 도구 간 독립성 및 상호 운용성 극대화
실천 포인트
1. AI Agent용 지식 베이스 설계 시 독자 포맷 대신 Markdown/YAML 표준 채택 검토
2. 전체 컨텍스트 로드 방지를 위해 폴더별 인덱스 파일을 둔 계층적 탐색 구조 설계
3. 벤더 종속성을 제거하기 위해 데이터 내보내기(Export)와 가져오기(Import)의 양방향 호환성 검증
4. 파일 기반의 Git-flow를 통해 지식의 버전 관리 및 Diff 분석 체계 도입