하네스 엔지니어링 · Harness Engineering
TOOLS
도구 오케스트레이션 · MCP
에이전트의 손 — Tool, Skill, MCP.
Tool Orchestration — 에이전트가 무엇을 할 수 있는지, 어떻게 호출하는지 정의합니다.
핵심 요소
- Tool schema — 이름·인자·설명 (LLM이 고르게)
- 단일 입구 — 모든 호출이 한 dispatcher 를 통과
- MCP — Model Context Protocol, 표준 도구·리소스 연결
- 권한 — 보드별·사용자별 opt-out
설계 팁
- 도구는 많을수록 좋지 않음 — 8~15개 잘 정의된 도구
- destructive 플래그 — 삭제·발송·결제는 명시
- lazy refresh — OAuth 토큰 등 호출 직전 갱신
MCP 는 “USB-C for AI”처럼 플러그인 생태계를 만듭니다. 자체 API도 MCP로 감싸면 에이전트·IDE·다른 클라이언트가 재사용합니다.
Anti-pattern
모델에게 20페이지 API 문서를 통째로 넣는 것 — 컨텍스트 낭비입니다. 스키마 + 짧은 예 + execute 레이어가 하네스의 역할입니다.
"도구는 능력의 확장이지만, 권한 없는 확장은 사고다."
한눈에 보기
| 패턴 | 설명 | 예 |
|---|---|---|
| Flat tools | 함수 목록 | search, read, write |
| MCP server | 원격 도구 묶음 | Calendar, GitHub |
| Sub-agent | 위임 | explore, shell |
| Human approval | 파괴적 작업 | SSE 승인 |
이번 호 키워드
· MCP
· 도구
· 오케스트레이션
· Tool