피드로 돌아가기
Composable Agent Specs: Spec Delegation and the OAS Registry
Dev.toDev.to
AI/ML

OAS 1.4 도입을 통한 Agent Spec의 모듈화 및 Registry 기반 버전 관리 체계 구축

Composable Agent Specs: Spec Delegation and the OAS Registry

Scotty G2026년 4월 20일5분intermediate

AI 요약

Context

기존 Agent 프레임워크의 라이브러리 방식 재사용 구조로 인한 코드베이스 간 추상화 불일치 발생. YAML 설정과 Python 로직의 분리로 인한 설정 표류(Drift) 및 PR 리뷰 효율 저하 문제 직면.

Technical Solution

  • YAML 기반 Spec Delegation 도입을 통한 Agent 간 계약 중심의 재사용 구조 설계
  • Local Path, HTTP URL, Registry(oa://)의 3단계 참조 체계를 통한 유연한 Spec 로드 메커니즘 구현
  • depends_on 구문을 통한 Delegated Task 간의 의존성 체이닝 및 파이프라인 구성
  • SemVer 기반의 Version Pinning 적용으로 프로덕션 환경의 출력 일관성 보장
  • 런타임 단계의 Cycle Detection 로직을 통한 무한 루프 방지 및 Token 낭비 차단
  • Typed Output Schema 정의를 통해 위임된 태스크 간의 엄격한 I/O 인터페이스 규격화

실천 포인트

- Agent 설계 시 단일 책임 원칙(Single-responsibility)을 적용하여 Spec 단위 분리 - 프로덕션 배포 시 floating reference 대신 @version을 통한 엄격한 Pinning 수행 - Spec 간 상호 참조 시 순환 의존성(Circular Dependency) 발생 여부 사전 검증 - LLM 엔진에 종속되지 않는 Engine-agnostic한 프롬프트 및 스키마 설계 지향

태그

#Agent Registry#Open Agent Spec#Spec Delegation#SemVer#Cycle Detection
원문 읽기