제5장 · 코딩 에이전트와 코드 생성¶

코드는 ‘새로운 도구를 만들 수 있는 도구’이자 범용 에이전트의 메타 역량입니다. 프로덕션급 코딩 에이전트를 예로 들어 가장 강력한 범용 도구의 전체 구현을 보여 줍니다.

연계 프로젝트¶

실험	프로젝트	유형	설명
5-1	code-for-math	✅	같은 모델로 같은 수학 경시 문제를 풀며 ‘순수 사고 사슬’ 방식과 ‘코드 보조’ 방식을 비교합니다. 후자에서는 문제를 Python(sympy/numpy/scipy) 코드로 형식화하고 함수 호출을 통해 서브프로세스 샌드박스에서 실행합니다. 오류가 잦은 암산을 정확한 계산으로 대체해 정확도가 크게 높아집니다.
5-2	code-for-logic	✅	‘기사와 악당’ 논리 퍼즐을 제약 충족 문제(CSP)로 변환합니다. 에이전트가 `python-constraint`로 변수와 쌍조건 제약을 정의한 뒤 솔버를 호출합니다. 여러 퍼즐에서 순수 자연어 사고와 코드 보조 방식의 정확도를 비교합니다.
5-3	small-model-codified-rules	✅	τ-bench 항공사 고객 서비스 시나리오를 바탕으로 한 통제 실험입니다. 복잡한 업무 정책(환불 규칙)을 자연어 프롬프트에서 코드·도구로 옮기자 소형 모델의 작업 성공률과 정책 준수율이 크게 향상됩니다. 도구 내부 코드 검증은 모델의 잘못된 판단을 실시간으로 차단할 수 있습니다.
5-4	paper-to-ppt	✅	‘PPT 만들기’를 코드 생성 문제로 다시 정의합니다. Proposer는 Slidev(Markdown+HTML) 코드를 작성하고, Reviewer는 각 페이지를 PNG로 렌더링한 뒤 Vision LLM으로 레이아웃 문제를 검사해 구조화된 피드백에 따라 반복 수정합니다. 두 에이전트의 역할 분담으로 최대 컨텍스트 크기를 크게 줄입니다.
5-5	paper-to-video	✅	‘논문 → PPT’를 확장해 슬라이드마다 자연스러운 해설 원고를 만들고 TTS로 음성을 합성한 뒤, ffmpeg로 각 슬라이드 화면과 음성을 페이지별로 동기화해 내레이션이 있는 설명 영상을 생성합니다.
5-6	video-edit	✅	여러 장면으로 구성된 영상과 자연어 요청을 받으면 에이전트가 ‘2단계 Vision 위치 찾기’(거친 프레임 추출 후 정밀 판독)로 대상 장면의 시간 경계를 정합니다. 구간을 자른 뒤 Reviewer가 결과 클립에서 키프레임을 추출해 검증하고, 만족스럽지 않으면 반복 수정합니다.
5-7	adaptive-log-parser	✅	스스로 진화하는 로그 파싱 시스템입니다. 새롭고 해석할 수 없는 형식을 만나도 오류로 끝내지 않고, 실패한 샘플과 오류 메시지를 코드 생성 에이전트에 전달해 `parse` 함수를 만듭니다. 자동 테스트를 통과하면 함수를 핫 업데이트해 파싱 엔진에 등록하며, 전 과정에 사람의 개입이 필요하지 않습니다.
5-8	log-diagnosis	✅	진단 에이전트가 프로덕션 추적 로그, 아키텍처 문서, PRD를 읽습니다. 문제와 근본 원인을 자동으로 찾아 구조화된 보고서와 회귀 테스트 사례를 만들고, 리플레이 프레임워크로 실제 실행 검증을 수행하며, MCP 연동을 통해 GitHub Issue 생성을 모의합니다.
5-9	dynamic-form	✅	불완전한 요청을 받았을 때 질문을 하나씩 되묻지 않습니다. 대신 연쇄 로직을 포함한 독립형 HTML 양식을 동적으로 만들어 사용자가 누락 정보를 한 번에 채우게 합니다. 프런트엔드는 양식 데이터를 JSON으로 모아 에이전트에 돌려주고 작업을 이어 갑니다.
5-10	erp-agent	✅	중국어 자연어 질의를 SQL로 변환해 데이터베이스에서 실행하고 결과 표를 바로 보여 줍니다. 핵심은 아티팩트 패턴입니다. LLM은 데이터를 직접 옮기지 않고 SQL 아티팩트만 생성하므로 토큰을 절약하고 수작업 계산 오류를 피합니다. 수만 행의 결과도 즉시 반환할 수 있습니다.
5-11	conversational-ui	✅	사용자가 색상·글꼴·문구·레이아웃 같은 UI 맞춤 요청을 자연어로 제시하면 에이전트가 React 프런트엔드 소스 코드를 스스로 찾아 수정합니다. Vite의 Hot Module Replacement(HMR)를 활용해 변경 사항이 즉시 반영되며 여러 차례의 반복 맞춤을 지원합니다.
5-12	agent-creator	✅	템플릿 방식과 처음부터 만드는 방식 모두 구조·컴파일·테스트·실제 Kimi K3 작업·의미 검수를 통과했습니다. 정식 비교에서는 템플릿 방식의 품질이 뒤처지지 않고 생성 효율은 더 높지만, 본문이 예상한 ‘품질과 효율 모두에서 엄격한 우위’는 나타나지 않았다는 정직한 부정적 결과를 기록합니다.

프로젝트 유형¶

아이콘	유형	의미
✅	독립 실행	전체 코드가 이 저장소에 있으며, API 키를 설정하면 실행할 수 있습니다.
📖	재현 가이드	외부 저장소를 `git clone`해야 하는 상세 안내 문서입니다.
🚧	진행 중	구현은 있지만 실험 범위나 검수 증거가 아직 본문의 요구사항을 모두 충족하지 못했습니다.