동적 워크플로가 가져가는 것은 「모델이 말을 끝낼 때까지 기다렸다가 파싱한다」입니다. 진행 계약은 여전히 JSON 이벤트 흐름입니다. 2026년 10월 9일 Claude Managed Agents가 동적 워크플로를 베타로 열었습니다. 헤더는 managed-agents-2026-04-01입니다. 에이전트가 프로그램을 쓰고, 서버가 백그라운드에서 workflow run으로 돌립니다. 따라갈 것은 마지막 문장이 아니라 세션 이벤트 흐름의 workflow_run.*입니다.
이 글은 2026년 10월 12일 기준입니다. 릴리스 노트와 Workflow runs 페이지를 따릅니다. 이 사이트에는 이미 Agents API와 JSON Schema, MCP, Skills, Tools, Subagents가 있습니다. 여기서는 수백 조각이 나뉘어 돌 때 어느 JSON이 실행의 끝이고, 어느 것을 성공으로 보면 안 되는지만 답합니다.
10월 9일에 열린 것
스위치는 에이전트 정의의 multiagent에 있습니다. 타입이 multiagent_20261001이면 subagents와 workflows가 기본으로 켜집니다. 워크플로만 원하면 subagents를 disabled로 둡니다. 이미 만든 에이전트는 workflows.predefined_agents에 넣습니다. 워크플로가 그 자리에서 쓰는 것은 inline agent입니다.
{
"type": "multiagent_20261001",
"workflows": { "type": "enabled" }
}
실행은 세 층입니다. 바깥은 백그라운드 workflow run이고, 한 세션에 여러 개가 열릴 수 있습니다. 가운데는 단계이고 이름은 모델이 씁니다. 안쪽은 에이전트 스레드입니다. 프로그램은 여러 개를 동시에 띄우고, 결과를 다음으로 넘기고, 단계 안에서 반복할 수 있습니다. 실행을 시작하는 것은 에이전트뿐입니다. 당신이 보내는 이벤트로는 끝나지 않습니다. 세션을 아카이브하면 끝날 수 있습니다.
이벤트는 세션 이벤트 흐름으로 가고, 목록에도 나옵니다. webhook은 나지 않습니다. 수명은 기본 24시간이고 에이전트가 더 짧게 정할 수 있습니다. 클라이언트를 기다리는 시간과 일시 정지도 시간에 들어갑니다. 멈춰 있는 실행이 timeout_error로 끝날 수 있습니다.
created가 단계 명단입니다
workflow_run.created는 workflow_run_id(wrun_), name, description, phases를 갖습니다. 각 단계는 id(wrph_), name, description입니다. 설명이 없으면 description은 null입니다. phases는 항상 있고 빈 배열일 수 있습니다. 이름은 모델이나 서버가 쓴 글이라 안정된 열거가 아닙니다.
{
"type": "workflow_run.created",
"id": "sevt_01abc",
"workflow_run_id": "wrun_01J8XkN5uT3vHpLqRfWdY2",
"name": "Find change-of-control clauses",
"description": "Reads each contract and lists those that have the clause.",
"phases": [
{"id": "wrph_01Kd3a1f3", "name": "Read the contracts", "description": "Reads each contract for the clause."},
{"id": "wrph_01Kd3b7c9", "name": "Reconcile the findings", "description": null}
]
}
뒤의 phase_started와 phase_ended에는 workflow_run_phase_id만 있고 단계 이름은 없습니다. 이름은 created.phases에서 id로 찾습니다. phase_ended는 phase_started_id로 시작 이벤트와 짝을 짓고, 그 단계의 일이 끝났는지는 말하지 않습니다. 문서는 한 번에 하나, phases 순서, 각 단계는 많아야 한 번이라고 쓰고, API는 그것을 보장하지 않는다고도 씁니다. 동시에 열린 단계, 명단에 없는 단계, 명단에는 있으나 시작하지 않는 단계를 받아 들이세요. 시작된 단계는 status_ended 전에 끝납니다.
completed는 해냈다가 아닙니다
workflow_run.status_ended는 그 실행의 workflow_run.* 중 마지막이고 result를 포함합니다. 실행은 created부터 거기까지 열려 있으며 running일 수도 idle일 수도 있습니다.
| result | 의미 |
|---|---|
| type이 completed | 프로그램이 다 돌았다. 각 조각의 성공은 아니다. 스레드는 실패할 수도, 만들어지지 않을 수도 있다. |
| type이 stopped | 에이전트가 멈췄거나 세션이 아카이브되었다. 이벤트는 어느 쪽인지 말하지 않는다. |
| error.timeout_error | 수명에 닿았다. 기본 24시간, 또는 에이전트가 줄인 시간. |
| error.program_error | 코드 실패, 규칙 위반, 또는 스레드 실패를 프로그램이 실행 종료로 받아들인 경우. |
| error.thread_limit_error | 한 워크플로가 띄울 수 있는 에이전트 수를 넘었다. |
| error.unknown_error | 서버가 이어 가지 못했거나 다른 서버 쪽 제한. |
오류 모양은 {"type":"error","error":{"type":"timeout_error","message":"..."}}입니다. message는 로그에 적어도 됩니다. 모르는 result.type은 다른 방식으로 끝난 실행, 모르는 error.type은 오류로 봅니다.
workflow_run.error는 status_ended 전에 오고 끝이 아닙니다. workflow_run_id가 null이면 실행이 만들어지지 않은 것입니다. 그렇지 않으면 status_ended까지 따라갑니다. 모델, MCP, 자격 증명, 청구 실패는 먼저 실패 스레드의 session.error로 나타나고 그것만으로 실행이 끝나지 않습니다. 프로그램이 그 실패로 실행을 끝내면 program_error가 됩니다.
스레드에는 단계 이름이 없습니다
실행 안의 각 에이전트는 자기 세션 스레드에서 일합니다. 알리는 session.thread_created는 그 workflow_run_id를 갖습니다. 다른 스레드는 이 필드가 null입니다. 어느 단계인지 말하는 이벤트나 필드가 없고 agent_name은 겹칠 수 있습니다. 진행은 단계 이벤트로, 스레드는 session_thread_id로 가릅니다.
predefined_agents에 올린 에이전트는 스레드의 agent에 id와 version이 있습니다. inline은 type이 inline이고 그 둘이 없습니다. 쓰는 모델은 세션 에이전트의 것입니다. 도구, MCP, 스킬은 그 부분집합이며, 문서는 전부를 받는다고 쓰고 API는 보장하지 않는다고도 씁니다. 스레드는 샌드박스 파일을 공유하고 대화 기록은 따로입니다.
실행이 열려 있는 동안 스레드 ID로 하나를 멈추거나 아카이브할 수 없습니다. 멈추려면 에이전트에게 실행 전체를 멈추게 합니다. 실행이 열려 있으면 세션이 running인 채로 도구 호출이 옵니다. session.status_idle을 기다리지 마세요. evaluated_permission이 ask인 agent.tool_use나 agent.mcp_tool_use가 오면 답합니다.
먼저 맞출 JSON 네 가지
- multiagent. 타입은
multiagent_20261001,workflows.type은enabled. 워크플로만이면subagents를 명시적으로disabled. - workflow_run.created 하나.
phases가 있고 id는wrph_로 시작합니다. 빈 배열도 유효합니다. 이름을 허용 목록에 넣지 마세요. - status_ended 하나. 먼저
result.type을 봅니다.completed뒤에도 각 스레드 이벤트를 읽습니다. - 단계의 시작과 끝.
phase_started_id로 짝을 짓습니다. 이름은 created의phases에서 찾습니다. 이름이 없는 것은 파싱이 깨진 것이 아닙니다.
로컬 JSON 도구로 이벤트를 맞추기
베타를 켜기 전에 브라우저에서 세 텍스트를 여세요. multiagent 블록, workflow_run.created 하나, workflow_run.status_ended 하나입니다.
- JSON 검증기 — 각 이벤트가 올바른 JSON인지,
result.type을 아는지. - JSONPath —
$.phases[*].id를workflow_run_phase_id와 맞춥니다. - JSON Diff — created의 단계 명단과 나중에 온 phase 이벤트를 대조해 명단 밖 id를 봅니다.
데이터는 브라우저를 떠나지 않습니다. 이벤트를 평평하게 본 다음 에이전트에게 워크플로를 쓰게 하세요. 성공 조건을 result.type == completed만으로 두지 마세요.
자주 묻는 질문
정식 버전인가요. 베타 헤더를 빼도 되나요?
2026년 10월 12일 기준으로는 아직 베타입니다. 요청에 managed-agents-2026-04-01이 필요합니다. multiagent 타입은 multiagent_20261001, workflows는 enabled입니다.
result.type이 completed면 각 조각이 성공인가요?
아닙니다. completed는 프로그램이 다 돌았다는 뜻입니다. 스레드는 실패할 수도, 만들어지지 않을 수도 있습니다. 실패는 각 스레드 이벤트에 있습니다.
workflow_run.error가 오면 마쳐도 되나요?
안 됩니다. status_ended 전에 오는 것이며 끝이 아닙니다. workflow_run_id가 null이면 실행이 만들어지지 않은 것입니다. 그렇지 않으면 status_ended를 기다립니다.
phase_started에 단계 이름이 없는 이유는 무엇인가요?
이름은 workflow_run.created의 phases에만 있습니다. workflow_run_phase_id로 찾습니다. phase_ended는 phase_started_id로 시작과 짝을 짓습니다.
스레드 하나를 멈추는 이벤트를 보낼 수 있나요?
보낼 수 없습니다. 실행이 열려 있는 동안 스레드 ID로 멈추거나 아카이브할 수 없습니다. 에이전트에게 실행 전체를 멈추게 하세요. 당신이 보내는 이벤트로는 실행이 끝나지 않습니다. 세션 아카이브는 끝날 수 있습니다.
MCP tools/list와 같은 JSON인가요?
아닙니다. tools/list는 도구 발견입니다. 이 계약은 세션 흐름의 workflow_run 이벤트입니다. inline 에이전트의 도구는 세션 에이전트 도구의 부분집합이지 또 하나의 tools/list가 아닙니다.
정리
동적 워크플로는 수백 문서를 백그라운드 프로그램으로 만듭니다. 진행은 여전히 JSON 이벤트입니다. 10월 9일 베타는 multiagent_20261001로 엽니다. created가 단계 명단이고 status_ended가 끝입니다. completed는 모든 스레드의 성공이 아닙니다. error 이벤트 뒤에는 끝 이벤트가 옵니다. 단계 이름은 phase 이벤트에 없고 created에서 찾습니다.
에이전트에게 쓰게 하기 전에 multiagent, created, status_ended를 로컬에서 평평하게 보세요. 성공 조건을 하나의 completed로 줄이지 마세요.