멀티 에이전트 위임: 작업 계약·권한·예산을 함께 설계하기
TECH INSIGHT / EXPLAINED
여러 에이전트가 유리한 작업은 서로 기다리지 않고 검증 가능한 결과를 만들 수 있는 작업입니다. 같은 파일을 동시에 고치거나 같은 주문을 보내는 일이라면 에이전트 수보다 소유권과 승인 경계가 먼저입니다.
실제 프로젝트의 로컬 실행 화면
기존 프로젝트의 화면 또는 함수를 로컬에서 실행해 촬영했습니다. 개인정보 없는 샘플 입력을 사용했으며, 실행한 범위는 각 이미지 아래에 설명했습니다.
분할 계약을 먼저 쓴다
위임 요청에는 목표, 읽을 자료, 수정 가능한 범위, 반환 형식, 완료 기준, 제한 시간을 넣습니다. 예를 들어 문서 열 개를 두 묶음으로 나누고 각각 '근거 문장·문서 위치·의심 항목'을 반환하게 하면 결과를 다시 대조할 수 있습니다. 작업량이 작거나 문맥 공유가 촘촘하면 단일 실행이 더 단순할 수 있습니다.
spawn·delegate·team 같은 분류는 앱의 편의 기능입니다. 팀 관계는 사용 가능한 대상의 후보를 정할 뿐, 자동으로 모든 권한을 부여하지 않습니다.
도구 숨김과 실행 권한 검사를 함께
쓸 수 없는 도구를 모델에게 숨기면 잘못된 선택을 줄일 수 있습니다. 그래도 서버는 매 실행마다 사용자·테넌트·대상·작업 범위를 다시 검사해야 합니다. 오래된 컨텍스트나 직접 요청은 화면의 도구 목록을 우회할 수 있습니다. 알 수 없는 모드와 권한 조회 실패는 허용으로 처리하지 않습니다.
비동기는 잊어버리는 방식이 아니다
독립 작업은 비동기로 시작하고, 결과에 의존하는 단계는 완료 상태를 기다립니다. 대기 중이라고 토큰 비용이 자동으로 곱해지는 것은 아닙니다. 실제 호출·토큰·실행 환경 과금으로 측정하세요. 태스크에 실행 ID, 재시도 횟수, 상태, 결과 경로, 오류를 저장하고 리더가 결과를 검증한 뒤 완료로 표시합니다.
완료 알림이 두 번 와도 같은 결과가 중복 적용되지 않게 작업 ID와 결과 버전을 사용합니다. 한 멤버 실패가 전체 실패인지 부분 결과로 진행 가능한지도 계약에 명시합니다.
깊이 제한은 폭을 제한하지 않는다
깊이 3이어도 각 단계가 10개씩 나누면 많은 작업이 생깁니다. 전체 작업 수·동시 실행·토큰·비용·시간 예산을 루트에서 관리하고 하위 요청에 전달합니다. 깊이 값은 모델이 주장하는 숫자가 아니라 서버가 만든 부모 실행 기록에서 계산하세요.
'현재 2개니까 하나 더 실행'을 두 요청이 동시에 판단하면 동시성 3개 한도를 넘을 수 있습니다. 슬롯 확인과 확보를 세마포어나 원자적인 저장소 연산으로 묶고, 종료·취소 때 반환합니다. 재시도에도 같은 한도를 적용합니다.
결과 묶음에도 최대 대기 시간이 필요하다
2초 동안 도착한 결과를 한 번에 비교하면 알림 호출을 줄일 수 있지만 모든 결과가 그 안에 온다는 보장은 없습니다. 최대 대기 시간, 최대 묶음 크기, 누락 멤버 목록을 함께 둡니다. 결과는 다른 에이전트가 썼다는 이유로 정답이 되지 않습니다. 출처와 실제 변경 파일을 리더가 확인해야 합니다.
참고 자료
내용·예제 검토: 2026-09-29
댓글
댓글 쓰기