
AI 에이전트를 위한 오픈 소스 "CI"를 구축했습니다. 그리고 제가 오픈 소스를 선택한 이유입니다.
요약
AI 에이전트 워크플로우의 일관성을 검증하기 위한 오픈 소스 CI 도구인 Reelier를 소개합니다. 에이전트의 실행 과정을 SKILL.md 파일로 기록하고, 모델 호출 없이 결정론적으로 재생하여 회귀를 탐지합니다.
핵심 포인트
- 에이전트 실행 과정을 스냅샷 테스트처럼 기록 및 검증 가능
- SKILL.md 파일을 통해 입력, 출력, 어설션을 포함한 레시피 생성
- 모델 호출 없이 0 토큰으로 결정론적 재생 및 비교 수행
- reelier diff를 통해 에이전트의 조용한 회귀(regression) 방지
안녕하세요, 제 이름은 Max입니다. 저는 AI 에이전트 워크플로우 (workflows)에 일반적인 코드가 수십 년 동안 가져왔던 기능인 스냅샷 테스트 (snapshot tests)와 CI를 제공하는 오픈 소스 도구인 Reelier를 구축했습니다.
여기에 제가 느꼈던 갈증이 있습니다.
- 저의 코딩 에이전트 (coding agent)가 실행될 때마다 동일한 도구 호출 (tool-call) 워크플로우를 계속해서 다시 도출했습니다.
- 이것을 가져오고, 저것을 변환하고, 결과를 게시합니다.
- 정확히 하나의 정답이 있는 작업에 대해 동일한 토큰 (tokens), 동일한 시간을 소모합니다.
그리고 가끔씩은 조금 다르게 수행하기도 했지만, 아무것도 이를 잡아내지 못했습니다. 그 두 번째 부분이 무서운 점입니다.
왜 오픈 소스로 만들었는가
현재 에이전트 도구 (Agent tooling) 시장은 범람하고 있습니다. 새로운 폐쇄형 도구들이 매일 출시되고 있으며, 그들 대부분은 여러분의 워크플로우와 키 (keys)를 블랙박스 (black box)에 맡기라고 요구합니다.
오픈 소스는 이러한 소음 속에서 작은 도구가 신뢰를 얻는 방법입니다. 도구가 정확히 무엇을 하는지 읽을 수 있고, 자신의 머신에서 실행할 수 있으며, 데이터를 일반 파일로 유지할 수 있기 때문입니다.
실제로 무엇을 하는가
- 성공적으로 작동한 하나의 에이전트 실행 (agent run)을 기록합니다.
- Reelier는 이를 읽기 가능한 SKILL.md 파일로 컴파일합니다. 이는 타입이 지정된 입력 (typed inputs), 타입이 지정된 출력 (typed outputs), 그리고 모든 단계에 대한 어설션 (assertion)이 포함된 레시피입니다.
- 그런 다음 해당 파일을 결정론적 (deterministically)으로 재생합니다. 모델 호출 (model call) 없이, 0 토큰, 바이트 단위로 동일하게, 밀리초 단위로 수행됩니다.
- 모든 재생은 영수증과 같습니다.
그리고 reelier diff는 두 실행을 비교하여 단계가 어긋나면 종료 코드 1을 반환하므로, 조용한 회귀 (silent regression)가 프로덕션 (production)에 도달하는 대신 빌드를 실패하게 만듭니다.
솔직한 부분
이 도구는 결정론적인 도구 호출 (tool calls), HTTP 및 MCP만을 재생합니다.
파일 수정(file edits)이나 자유 형식의 추론(free-form reasoning)을 재생하지 않으며, 재현할 수 없는 단계를 결코 꾸며내지 않습니다. 이는 에이전트가 수행하는 작업 중 결정론적인(deterministic) 절반을 위한 것입니다.
제가 이 점을 미리 밝히는 이유는, (제 에이전트 전체를 녹화하는 것과 같이) 바이럴이 될 법한 버전은 제가 주장하지 않을 것이기 때문입니다. 왜냐하면 그것은 사실이 아닐 것이기 때문입니다.
저장소(repo)의 벤치마크 수치: 1000번의 재생 중 1000번 모두 바이트 단위로 동일(byte-identical)하며, 재생당 0개의 토큰을 사용합니다. 이는 에이전트가 동일한 작업을 다시 실행하는 것보다 약 50배 저렴하고 59배 빠릅니다.
이 프로젝트는 AGPL-3.0 라이선스이며, BYOK(Bring Your Own Key) 방식이고, 완전히 귀하의 로컬 머신에서 실행됩니다.
여러분이 주시는 어떤 도움이라도 저에게는 엄청나게 큰 힘이 될 것입니다! 🥹
가능하다면 스타(star)를 눌러주시면 정말 기쁠 것 같습니다 ❤️ https://github.com/seldonframe/reelier.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기
