에이전트에 작업 위임

이 가이드는 내 손에서 일을 덜어 에이전트에게 넘기는 방법과, 에이전트끼리 일을 주고받을 때 벌어지는 일을 다룹니다.

티켓을 에이전트에 넘기기

작업에 착수할 수 있을 만큼 정확한 제목과 설명으로 티켓을 만듭니다.
소유권이 기록에 남도록 티켓의 담당자를 그 에이전트로 설정합니다.
스페이스를 열고(또는 만들어) 그 에이전트를 @멘션합니다.
메시지에서 # 멘션으로 티켓을 참조하고 — 작성기는 워크스페이스 티켓을 자동 완성합니다 — 무엇을 해 주기를 원하는지 말합니다.

에이전트는 그 대화에서 작업을 집어갑니다. 진행 상황은 그 스페이스로 스트리밍됩니다.

에이전트가 받는 것

태그한 티켓 참조를 포함한, 보낸 메시지.
작업하고 보고할 스페이스.
워크스페이스에 연결된 저장소에서 만든 격리된 워크트리.
실행의 도구 표면을 좌우하는, 스페이스의 모드.

모드는 티켓이 아니라 스페이스의 속성입니다 — 티켓에는 모드가 없습니다. 따라서 같은 에이전트가 한 스페이스에서는 chat, 다른 스페이스에서는 plan에 있을 수 있습니다. 작성기의 모드 드롭다운(Agent, Plan 또는 Orchestrate)에서 선택합니다. review는 PR 리뷰 스페이스가 설정하며 선택할 수 없습니다. 모드를 참고하세요.

구조화된 결과 요구하기

출력 계약은 티켓이 아니라 디스패치에 선언합니다: expected_output_schema와 output_contract_mode(기본값은 strict)입니다. 에이전트는 submit_output을 호출해 이를 충족하며, 이 호출은 페이로드를 스키마에 따라 검증하고 규격에 맞지 않는 것은 거부합니다.

수락된 출력과 거부된 출력은 모두 에이전트 실행 로그에 남습니다. 티켓 자체의 상태는 이와 무관합니다 — 계약이 실패해도 티켓이 실패하지는 않습니다.

진행 상황 모니터링

스페이스 — 실시간 에이전트 활동을 보여 주는 기본 화면입니다.
티켓 — 티켓을 옮기는 쪽이 설정한 대로의 상태입니다.
옵저버빌리티 → 실시간 (/workspaces/<workspace-id>/observability) — 실시간 에이전트 로스터입니다.
옵저버빌리티 → 인사이트 — 비용과 소요 시간이 함께 있는 실행 로그입니다.

대시보드 화면은 없습니다. 워크스페이스 URL만 열면 받은편지함으로 리디렉션됩니다.

에이전트끼리 위임하게 하기

부분 문제에 부딪힌 에이전트는 delegate_task MCP 도구로 위임합니다. 이 도구는 다른 에이전트에 배정된 하위 티켓을 만들고, parent_ticket_id를 전달하면 가드가 볼 수 있도록 그 체인을 기록합니다.

티켓팅 병목 지점에서는 프롬프트 지시가 아니라 항상 두 가지 구조적 가드가 실행됩니다:

깊이 상한 — 3홉보다 깊은 체인은 거부됩니다.
순환 감지 — 이미 체인에 있는 에이전트로 되돌아가는 홉은 거부됩니다.

from_agent_id를 전달하면 가드 두 가지가 더 실행됩니다(프로덕션은 항상 리졸버 포트를 제공합니다):

자율성 상한 — 위임받은 에이전트의 스페이스 내 실효 레벨은 위임한 쪽을 넘을 수 없습니다.
예산 한도 — 위임은 위임한 쪽의 남은 강제 중단 예산에 청구되며 그 이상을 만들어 낼 수 없습니다. 정책이 없거나 정책이 무제한이면 통과합니다.

거부는 시끄럽습니다. 도구는 가드의 사유를 그대로 반환하므로 위임한 에이전트가 정확히 왜 거부되었는지 봅니다. delegatedByAgentId 필드는 누가 위임했는지를 기록해 위임 트리를 이룹니다.

이 위임 깊이 상한 3은 내장 하네스의 서브에이전트 중첩 상한 2와는 다른 한도입니다 — 하나는 에이전트 사이의 티켓을 제한하고, 다른 하나는 단일 실행 안의 서브에이전트를 제한합니다.

한 티켓에 여러 에이전트 투입하기

티켓에 이들을 협업자로 추가합니다(역할: 담당자, 협업자, 리뷰어). 이것은 로스터, 즉 누가 관련되어 있는지의 기록일 뿐이며 그 자체로는 아무 권한도 부여하지 않습니다.

실제로 에이전트들을 같은 대화에 넣으려면 스페이스 헤더에서 참가자로 추가합니다. 그러면 그곳에서 서로를 @멘션할 수 있습니다. 스페이스를 참고하세요.

자동 티켓 생성

파이프라인 팔레트에는 티켓을 만드는 노드가 없으므로, 파이프라인이 작업을 배정된 티켓으로 펼쳐 낼 수는 없습니다.

실제로 존재하는 경로는 오케스트레이션입니다. 제안을 승인하면 프로젝트와 팀이 만들어지고, 제안의 하위 티켓 DAG가 파이프라인 템플릿으로 컴파일되며(하위 티켓마다 Ticket 행이 아니라 promptAgent 단계 하나), 그 실행이 시작됩니다. 오케스트레이션 실행을 참고하세요.