오케스트레이션 패턴

여러 AI 에이전트가 누가, 언제, 어떤 순서로 일할지 정하는 설계 방식으로, 실행 순서와 중간 결과를 넘기는 방법, 실패했을 때의 처리까지 미리 정해 둔다. 한 에이전트로는 감당하기 어려운 큰 작업이나 단계가 뚜렷하게 나뉘는 일을 역할별로 나눠 처리할 때 쓴다.

에이전트를 여러 개 띄우는 것과는 다르다

에이전트를 여러 개 띄우기만 하면 서로의 결과를 모르니 같은 일을 반복하거나 결과가 부딪힌다. 오케스트레이션은 그 사이에 규칙을 둔다. 핵심은 어떤 결과를 다음 에이전트에 넘길지, 한 단계가 실패하면 다시 할지 멈출지를 정하는 것이다.

코드 리뷰 파이프라인으로 보는 흐름

PR이 올라오면 세 에이전트가 차례로 일하는 순차 패턴의 예다. 앞 단계의 결과가 다음 단계의 범위를 좁혀 주기 때문에 뒤 단계는 꼭 필요한 곳만 본다.

스타일 검사와 보안 검사처럼 서로 결과가 필요 없는 단계는 병렬로 돌리면 전체 시간이 줄어든다.

도구로 흐름을 코드로 정한다

LangGraph에서는 각 단계를 노드로, 단계 사이의 흐름을 연결선으로 그려 그래프로 정의한다. 조건에 따라 갈라지는 길이나 다시 돌아가는 고리도 같은 방식으로 만든다. AutoGen은 에이전트끼리 대화를 주고받으며 일하는 구성에 많이 쓰고, Claude Code에서는 메인 에이전트가 서브에이전트에게 일을 나눠 맡기는 식으로 쓸 수 있다.

처음에는 순차 패턴 하나로 시작하고, 느리거나 자주 막히는 지점에만 병렬이나 분기를 더하는 게 안전하다.

한 에이전트로 충분하면 쓰지 않는다

에이전트가 늘수록 모델 호출이 많아져 비용과 대기 시간이 늘고, 어디서 잘못됐는지 찾기도 어려워진다. 한 에이전트가 도구 몇 개로 해결할 수 있는 일이라면 그쪽이 낫다. 오케스트레이션을 쓴다면 단계마다 입력과 출력을 기록하고, 에이전트끼리 끝없이 주고받지 않도록 최대 반복 횟수를 정해 둔다.

정해진 단계는 파이프라인, 열린 일은 총괄 에이전트로

가장 흔한 건 단계가 정해진 반복 작업을 순차·병렬 파이프라인으로 묶는 방식이다. 할 일이 그때그때 달라지는 작업은 관리자형으로 총괄 에이전트가 계획을 세워 나눠 맡긴다.