요즘 AI 에이전트는 어떻게 구축하시나요? 파이썬 SDK부터 Claude .agent 파일까지

저는 운영 중인 에이전트가 몇 개 있는데, 결국 변경 빈도에 따라 두 방식을 나누게 되더군요. 행동이나 프롬프트를 매주 수정해야 하는 경우라면 선언적인 .md/.agent 방식이 압승입니다. 시스템 프롬프트를 수정하려고 매번 재배포하고 싶지는 않으니까요. 마크다운 파일의 diff 기록은 문자열 리터럴 속에 파묻힌 코드보다 훨씬 읽기 편하죠. 하지만 도구 계층은 코드로 유지합니다. 입력 검증, 에러 처리, 재시도 같은 정확성 계약이 도구에서 이루어지기 때문입니다.

저는 시스템이 생성해야 할 최소한의 올바른 출력을 알고 있는 상태에서 세 가지 테스트를 수행합니다. 그 후 답변이 정확한지, '노이즈'나 관련 없는 아티팩트가 참인지 거짓인지 평가하죠. 또한 에이전트 자체보다는 도구를 개선하는 것이 더 중요하다고 생각합니다(워크플로우의 첫 테스트 단계에서 말이죠). 설계가 잘못되었거나 신뢰할 수 없는 도구는 에이전트 계층이 아무리 뛰어나도 결국 나쁜 결과를 낳을 수밖에 없습니다.

실제 도구는 파이썬 SDK를 쓰고, 깔끔한 diff가 필요한 프롬프트 반복 작업에만 .agent를 사용합니다.

https://github.com/munch2u-a11y/Helix-AGI.git .md 파일은 줄이고 .py를 늘리는 방향입니다.

저는 여전히 에이전트 정의를 파일로 먼저 관리하고, 도구 그래프가 복잡해질 때만 코드로 옮깁니다. 프롬프트 옆에 회귀 테스트를 두고 버전 관리하는 게 프레임워크 계층을 하나 더 추가하는 것보다 훨씬 시간을 아껴줍니다. 결국 문제를 복잡하게 만드는 건 파이썬이냐 Claude 파일이냐가 아니라, 숨겨진 상태와 마법 같은 기본값들입니다.