Agent Handoff는 한 에이전트가 하던 일을 다른 에이전트나 사람에게 넘기는 설계입니다. 멀티 에이전트 시스템에서 가장 자주 깨지는 부분이 바로 이 전달 경계입니다.
이 글에서는 언제 핸드오프가 필요한지, 어떤 정보를 넘겨야 하는지, 무엇을 버려야 하는지 정리합니다. 함께 보면 좋은 글은 OpenAI Agents SDK, Claude Code SDK, LangGraph, CrewAI입니다.
개요 #
핸드오프는 다음 상황에서 필요합니다.
- 작업 단계가 바뀐다
- 권한이 달라진다
- 다른 도구가 필요하다
- 검토자에게 넘겨야 한다
문제는 전달 자체가 아니라 전달할 정보의 양입니다. 너무 많이 넘기면 잡음이 늘고, 너무 적게 넘기면 맥락이 끊깁니다.
왜 중요한가 #
에이전트 시스템은 대부분 “시작"보다 “넘김"에서 실패합니다. 도구 호출 결과, 중간 추론, 사용자의 의도, 실패 사유가 제대로 정리되지 않으면 다음 단계가 같은 실수를 반복합니다.
핸드오프를 잘 설계하면 에이전트가 역할 단위로 분업할 수 있고, 사람 개입도 자연스럽게 끼워 넣을 수 있습니다.
설계 방식 #
핸드오프 메시지는 길게 쓰기보다 구조화하는 편이 좋습니다.
| 항목 | 내용 |
|---|---|
| Goal | 지금까지의 목표 |
| State | 현재 상태와 완료 여부 |
| Evidence | 근거가 되는 결과물 |
| Constraints | 반드시 지켜야 할 제약 |
| Next action | 다음 에이전트가 할 일 |
핸드오프에서 가장 중요한 것은 “이전 에이전트의 내부 독백"이 아니라 “다음 에이전트가 바로 실행할 수 있는 상태"입니다.
운영 팁 #
- 전달 포맷을 JSON처럼 고정합니다
- 중복 요약을 피합니다
- 실패 이유는 짧고 명확하게 남깁니다
- 권한이 필요한 단계는 미리 분리합니다
- 사람에게 넘길 때는 판단 포인트만 남깁니다
체크리스트 #
- 전달 정보가 목표, 상태, 다음 행동으로 나뉘는가
- 다음 주체가 바로 실행할 수 있는가
- 민감한 내부 추론이 과도하게 포함되지 않는가
- 검토자에게 필요한 증거가 들어 있는가
- 실패 시 다시 어디로 돌아갈지 정해져 있는가
결론 #
핸드오프는 멀티 에이전트의 안정성을 좌우하는 핵심 설계입니다. 잘 넘기면 시스템은 커지고, 잘못 넘기면 규모가 커질수록 더 불안정해집니다.
