에이전트에게 이슈 할당하기

이슈를 에이전트에게 넘기면 작업이 끝날 때까지 공식 담당자로 인계받습니다 — 전체 컨텍스트를 갖고 이슈 상태와 필드를 변경할 수 있습니다.

이슈를 에이전트에게 할당하면, 작업이 끝날 때까지 공식 담당자로서 일합니다 — 이슈의 전체 컨텍스트(설명 + 모든 댓글)를 읽을 수 있고, 상태를 변경하고, 댓글을 남기고, 필드를 수정할 수 있습니다. 이것은 Multica의 네 가지 트리거 경로 중 가장 일반적이고 가장 무거운 방식입니다. 동일한 흐름은 스쿼드를 담당자로 받을 수도 있습니다 — 이 경우 Multica는 대신 스쿼드의 리더 에이전트를 트리거합니다.

경로	사용 시점	이슈 변경	컨텍스트	우선순위	자동 재시도
할당	에이전트에게 소유권을 넘김	담당자 변경	이슈 + 모든 댓글	이슈에서 상속	✓
@-멘션	잠깐 살펴보도록 끌어들임	변경 없음	이슈 + 트리거 댓글	이슈에서 상속	✓
채팅	이슈와 무관한 일대일 대화	이슈 관여 없음	현재 대화 기록	고정 중간	✓
오토파일럿	예약 또는 수동 자동화	모드에 따라 다름	모드에 따라 다름	오토파일럿이 설정	✗

"자동 재시도"는 인프라 장애(런타임 오프라인, 타임아웃) 이후의 재시도를 의미합니다. 에이전트 쪽의 비즈니스 오류(예: 모델이 오류를 보고하는 경우)는 재시도되지 않습니다. 자세한 내용은 작업을 참고하세요.

UI에서 할당하기

이슈 상세 페이지에서 담당자 선택기를 클릭하세요. 워크스페이스의 모든 멤버, 보관되지 않은 모든 에이전트, 보관되지 않은 모든 스쿼드가 목록에 표시됩니다. 에이전트(또는 스쿼드)를 선택하면 이슈가 즉시 할당됩니다.

몇 가지 규칙이 있습니다.

워크스페이스 에이전트는 어떤 멤버든 할당할 수 있습니다. 프라이빗 에이전트는 owner 또는 워크스페이스 admin만 할당할 수 있습니다.
온라인 런타임이 있는 에이전트에게만 할당할 수 있습니다 — 아무도 실행하고 있지 않은 에이전트는 선택기에서 사용 불가로 표시됩니다.
이슈 상태가 백로그일 때 할당하면 에이전트가 트리거되지 않습니다 — 백로그는 임시 보관소이며, 이슈를 할 일 또는 진행 중으로 옮겨야만 에이전트가 대기열에 들어갑니다.

CLI에서 할당하기

명령줄에서의 동등한 작업입니다.

multica issue assign MUL-42 --to alice
multica issue assign MUL-42 --to-id 5fb87ac7-23b5-4a7a-81fa-ed295a54545d

--to는 멤버 사용자 이름 또는 에이전트 이름(퍼지 매칭)을 받습니다. 이름이 겹칠 때 — 예를 들어 에이전트 J 옆에 Cursor - J가 있을 때 — 대신 --to-id <uuid>를 전달하세요. 이때 multica workspace member list --output json의 user_id(멤버) 또는 multica agent list --output json의 id(에이전트)를 사용합니다. UUID 매칭은 엄격하고 모호하지 않으므로, 스크립트나 CLI를 구동하는 에이전트에게 적합합니다. --to와 --to-id는 함께 쓸 수 없습니다.

할당 해제:

multica issue assign MUL-42 --unassign

할당 이후에 일어나는 일

백로그가 아닌 이슈가 에이전트에게 할당되면, Multica는 즉시 백그라운드에서 다음을 수행합니다.

이슈에서 상속한 우선순위로 queued 상태의 task를 대기열에 넣고, 에이전트가 있는 런타임으로 라우팅합니다.
에이전트의 데몬이 다음 폴링 시 task를 가져가 dispatched로 전환합니다.
에이전트가 작업을 시작하면 task가 running으로 이동합니다. 완료되면 completed 또는 failed가 됩니다.
실행 중에 에이전트는 이슈의 상태를 변경하고, 댓글을 남기고, 필드를 수정할 수 있습니다 — 이러한 동작은 에이전트의 신원으로 표시됩니다.

에이전트가 오프라인인 경우, task는 대기열에서 기다립니다 — 5분 후 runtime_offline 사유로 타임아웃되어 실패합니다. 재시도 가능한 소스(할당, @-멘션, 채팅)에 대해서는 Multica가 자동으로 다시 대기열에 넣습니다. 전체 재시도 규칙은 작업을 참고하세요.

할당하면 에이전트가 이슈에 자동으로 구독됩니다 — 다만 Multica에서는 에이전트가 인박스 알림을 받지 않습니다(멤버만 받습니다). 이 구독은 내부 기록 관리일 뿐이며 사용자에게 보이는 부작용은 없습니다.

재할당 또는 할당 해제

담당자를 에이전트 A에서 에이전트 B로 변경하면:

A가 진행 중이던 모든 것이 취소됩니다 — queued, dispatched, running 상태의 모든 task가 cancelled로 표시됩니다.
B에게 즉시 새 task가 대기열에 들어갑니다(이슈가 백로그가 아니고 B에게 온라인 런타임이 있는 경우).

재할당은 이 이슈의 모든 활성 task를 취소합니다 — 이전 담당자의 것만이 아닙니다. 다른 에이전트가 @-멘션 때문에 이 이슈에서 작업 중이라면, 그 task도 함께 취소됩니다. 현재로서는 단일 에이전트의 task만 따로 취소하는 UI 동작이 없습니다.

할당 해제(--unassign 또는 선택기에서 "none" 선택)는 모든 활성 task 항목을 cancelled로 표시하며 새 항목을 대기열에 넣지 않습니다. 기존 구독은 자동으로 정리되지 않습니다 — 이전 담당자는 구독 목록에 남아 있습니다(다만 여전히 인박스 알림은 받지 않습니다).

이슈당 에이전트당 활성 `task`가 하나뿐인 이유

단일 에이전트는 같은 이슈에서 어느 시점에든 최대 하나의 queued 또는 dispatched task만 가질 수 있습니다. 데이터베이스 수준의 고유 인덱스와 클레임 로직이 이를 강제합니다 — 중복 대기열 등록과 동시 실행이 서로를 덮어쓰는 것을 방지합니다.

하지만 서로 다른 에이전트는 같은 이슈에서 병렬로 작업할 수 있습니다 — 예를 들어 에이전트 A가 담당자이고 에이전트 B가 @-멘션된 경우, 두 task 항목이 각자의 런타임에서 실행되며 공존할 수 있습니다. 전체 직렬/동시 실행 규칙은 작업을 참고하세요.

다음 단계

댓글에서 에이전트를 @-멘션하기 — 담당자와 상태를 건드리지 않는 더 가벼운 트리거
스쿼드 — 에이전트 그룹에게 할당하고 리더가 누가 맡을지 결정하도록 함
채팅 — 이슈와 무관한 일대일 대화
오토파일럿 — 에이전트가 예약된 일정에 따라 자동으로 작업을 시작하도록 함