Claude 동적 워크플로 이후 진행이 여전히 JSON인 이유: multiagent_20261001에서 workflow_run.status_ended까지

2026년 10월 12일 기준: 10월 9일 베타는 Managed Agent가 워크플로를 쓰게 한다. 진행은 마지막 문장이 아니라 workflow_run 이벤트다. completed는 프로그램이 다 돌았다는 뜻이지 모든 스레드의 성공이 아니다.

동적 워크플로가 가져가는 것은 「모델이 말을 끝낼 때까지 기다렸다가 파싱한다」입니다. 진행 계약은 여전히 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 네 가지

  1. multiagent. 타입은 multiagent_20261001, workflows.type은 enabled. 워크플로만이면 subagents를 명시적으로 disabled.
  2. workflow_run.created 하나. phases가 있고 id는 wrph_로 시작합니다. 빈 배열도 유효합니다. 이름을 허용 목록에 넣지 마세요.
  3. status_ended 하나. 먼저 result.type을 봅니다. completed 뒤에도 각 스레드 이벤트를 읽습니다.
  4. 단계의 시작과 끝. 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로 줄이지 마세요.