agntcy/oasf

Open Agentic Schema Framework (OASF)

정의 – OASF는 AI 에이전트를 설명하기 위한 커뮤니티 기반의 오픈소스 스키마 시스템입니다. 에이전트의 기능, 스킬, 도메인 및 확장 가능한 모듈을 캡처할 수 있는 JSON 기반 데이터 모델(레코드 객체)을 정의합니다. 스키마는 버전 관리되고 변경 불가능하므로 특정 버전에 의존하는 도구는 안정적으로 유지됩니다.

중요성 – 현대 AI 에이전트 생태계(자율 어시스턴트, 도구 사용 봇, RAG 파이프라인 등)는 자신이 무엇을 할 수 있는지 알리고 서로를 발견하기 위한 공통 언어가 필요합니다. OASF는 이러한 공용어를 제공하여 서비스, IDE 플러그인, 카탈로그 간의 상호 운용성을 가능하게 합니다.

주요 구성 요소

스키마 정의 – schema/ 디렉토리의 JSON 파일(예: record.json)과 스킬 및 도메인의 분류 체계.
스키마 서버 – 최신 스키마를 호스팅하는 HTTP 서버(server/). 탐색을 위한 UI를 제공하고 REST API를 통해 레코드를 검증합니다.
도구 – Docker/Kind를 사용하여 서버를 빌드, 테스트, 배포하기 위한 Taskfile 기반 워크플로우. 핫 리로드 지원으로 전체 스택을 다시 시작하지 않고 스키마 변경을 반복할 수 있습니다.
MCP 통합 – Directory MCP Server를 LLM(예: Cursor)에 연결하면 코드에서 직접 OASF 레코드를 생성, 검증, 변환할 수 있습니다.

일반적인 워크플로우

레코드 작성 – 에이전트를 설명하고 스킬과 도메인으로 주석을 단 JSON 레코드를 만듭니다.
검증 – JSON을 OASF 서버(/validate 엔드포인트)로 보내거나 MCP 서버의 LLM 지원 명령을 사용합니다.
게시/발견 – 다른 서비스는 서버에 쿼리하여 스킬 또는 도메인과 일치하는 레코드를 찾아 동적 발견을 가능하게 합니다.

시작하기

# 클론
https://github.com/agntcy/oasf.git 클론 및 cd oasf

# 전제 조건 설치 (Taskfile, Docker, Go, yq, curl, tar)
# 종속성 및 아티팩트 빌드
task deps
task build

# 로컬 서버 배포 (Kind 클러스터 생성, Helm으로 서비스 설치)
IMAGE_TAG=latest task build:server
task up   # 그런 다음 http://localhost:8080 열기

# 스키마 변경의 핫 리로딩용
task reload

스키마 확장 – 비공개 확장(새 개체 유형, 추가 필드)을 추가하고 사용자 지정 서버 인스턴스를 호스팅할 수 있습니다. 기여 가이드에서는 새로운 스킬, 도메인 또는 모듈을 제안하는 방법과 버전을 지정하는 방법을 설명합니다.

추가 정보

라이브 스키마 UI: https://schema.oasf.outshift.com
AI 에이전트 스킬 분류: https://schema.oasf.outshift.com/skill_categories
프로토콜 버퍼 정의(언어 SDK 생성용): https://buf.build/agntcy/oasf
MCP 서버 통합: https://github.com/agntcy/dir/tree/main/mcp

사용 대상

공유 기능 카탈로그가 필요한 자율 에이전트 플릿을 구축하는 팀.
AI 에이전트의 마켓플레이스를 제공하는 플랫폼 제공자.
LLM 지원 에이전트 메타데이터 생성을 원하는 IDE 플러그인 개발자.
에이전트 벤치마크 및 재현성을 표준화하는 연구자.

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며 외부 가정은 추가되지 않았습니다.

agntcy/oasf

Open Agentic Schema Framework (OASF)

관련