피드로 돌아가기
Dev.toAI/ML
원문 읽기
DB 없는 Markdown 기반 State Machine으로 AI Agent 자율 제어 구현
I Open-Sourced My AI Agent's Brain. It's 18 Markdown Files.
AI 요약
Context
복잡한 코드 기반의 AI Agent 관리 체계가 가진 높은 유지보수 비용과 디버깅의 어려움을 해결하려는 시도. 데이터베이스나 API 의존성 없이 LLM의 텍스트 처리 능력을 극대화한 단순 구조의 필요성 대두.
Technical Solution
- 18개의 Markdown 파일로 구성된 State-based Architecture 설계
- Read state → Decide → Execute → Update memory → Report 순의 순환 루프(Loop) 구현
- Decision Waterfall과 Strategy Weights를 통한 우선순위 기반의 의사결정 로직 수립
- Append-only 방식의 daily-log.md 운영을 통한 데이터 유실 방지 및 Full-history 보존
- Reversibility와 Human-interaction 여부를 판단하는 3-Question Test 기반의 Guardrails 적용
- Human-readable한 상태 관리를 통한 Log 분석 단계의 제거 및 즉각적인 State 수정 구조 채택
실천 포인트
1. AI Agent의 상태 관리를 DB 대신 버전 관리가 가능한 텍스트 파일로 전환 검토
2. 가역성(Reversibility) 판단 로직을 도입하여 AI의 위험 행동을 사전 차단하는 Guardrails 설계
3. 모든 상태 변경 이력을 보존하는 Append-only 저널링 시스템 구축