TL;DR
에이전트 하네스인 Claude Code와 Codex는 LLM을 엔진으로 활용하는 강력한 시스템이지만, 내부 구조가 공개되지 않은 블랙박스로 남아있다. 이 워크숍은 에이전트 아키텍처를 실행 루프, 도구 및 기술, 컨텍스트 관리, 서브 에이전트 오케스트레이션, 보안 샌드박싱이라는 5가지 핵심 계층으로 분해하여 실습한다. 직접 에이전트 하네스를 구축함으로써 개발자는 특정 벤더에 종속되지 않고 기술적 독립성과 제어권을 확보할 수 있다.
챕터별 상세
에이전트 하네스 개념
하네스(Harness)는 시스템을 제어하고 연결하는 프레임워크를 의미한다.
5단계 아키텍처
export async function agentLoop(model: Model, tools: Tool[]) { const messages: Message[] = [systemPrompt]; while (true) { const turn = await model.stream(messages, {tools}); if (turn.stop === 'done') return turn; for (const call of turn.toolCalls) { guard(call); const result = await sandbox(call); messages.push(toolResult(call, result)); } messages = await compact(messages); maybeSpawnSubAgents(turn); } }에이전트 하네스의 핵심 루프 구조를 정의하는 TypeScript 코드 예시
오픈소스 하네스
워크숍 안내
용어 해설
- 에이전트 하네스(Agentic Harness)
- — LLM을 엔진으로 활용하여 실제 작업을 수행하는 전체 시스템 아키텍처. 모델의 추론 능력에 도구 사용, 컨텍스트 관리, 보안 등을 결합하여 자율적인 작업을 가능하게 한다.
- 블랙박스(Black Box)
- — 내부 작동 원리나 구조를 알 수 없는 시스템. 에이전트 하네스 구축 시 내부 로직을 이해하지 못하면 유지보수와 최적화가 어렵다.
- 벤더 종속성(Vendor Lock-in)
- — 특정 기업의 폐쇄적인 솔루션에 의존하게 되어 다른 서비스로 전환하기 어려운 상태. 오픈소스 하네스 구축을 통해 이를 방지하고 기술적 독립성을 확보할 수 있다.
언급된 리소스
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.



