Workflow SDK에 원자적(Atomic) 시작 기능 추가

원문 발행 2026. 11. 05. 03:55원문 언어 영어AI 한국어 번역Vercel AI 원문 보기

요약

Workflow SDK에 원자적(Atomic) 시작 기능이 추가되어 중복 실행 경쟁 조건(duplicate-start race)을 해결했습니다. 이 기능을 통해 도메인 토큰 기반의 Idempotency가 보장되며, 오직 하나의 워크플로우만 해당 작업을 소유할 수 있습니다.

핵심 포인트

원자적 시작 기능이 이전 -then 패턴을 대체하며 안정성을 높였습니다.
주문 ID 등 도메인 토큰이 Idempotency Key로 사용되어 중복 실행을 원천 차단합니다.
오직 하나의 워크플로우만 해당 토큰을 소유할 수 있으며, 중복 요청은 오류를 발생시킵니다.
추가 코딩 없이도 강력한 Idempotency가 보장되는 것이 핵심입니다.

이제 's 함수는 하나의 원자적 단계에서 실행을 수락하고 훅(hook)을 클레임할 수 있습니다. 중복된 워크플로우 시작은 안전하게 실패합니다. 이 원자적 시작 기능은 이전의 -then- 패턴을 대체하며, 해당 패턴은 조회와 시작 사이의 간격 때문에 문서화된 중복 시작 경쟁 조건(duplicate-start race)을 남겼습니다.Workflow SDKstart()``getHookByToken()``start()

클레임된 훅은 실행이 시작되기 전에도 존재하며, 따라서 실행 전에 작동하고 초기 페이로드(payload)는 순서대로 버퍼링되어 전달됩니다. 워크플로우 내부에서는 동일한 토큰으로 이미 클레임된 훅에 바인딩됩니다: 보장되며, 새로운 것을 등록하지 않고, 단계를 추가하지 않으며, .resumeHook``createHook({ token })``getConflict()``null로 해결됩니다.

토큰은 Idempotency Key이며, 사용자의 도메인에서 가져옵니다: 주문 ID(order ID), 청구서 ID(invoice ID), 임포트 ID(import ID) 또는 요청 ID(request ID). 이 토큰만으로 Idempotency가 보장됩니다. 오직 하나의 실행만이 이를 소유하며, 중복은 소유자의 정보를 담아 오류를 발생시키고 절대 실행이 되지 않습니다. 워크플로우는 훅을 전혀 열 필요가 없으며, 만약 열지 않는다면 해당 토큰은 단지 Idempotency Key였음을 의미하고 실행은 정상적으로 완료됩니다.start()``HookConflictError``conflictingRunId

설정은 실행이 끝난 후(로부터 계산) 해당 토큰을 사용 불가능하게 유지하여, 늦게 발생하는 중복 요청도 거부합니다.experimental_minRetention``start()

5.3.1로 업그레이드하고 시작하려면 워크플로우의 문서를 읽으세요.

추가 코드가 필요 없는 Idempotency

AI 자동 생성 콘텐츠

원문 바로가기

Workflow SDK에 원자적(Atomic) 시작 기능 추가

요약

핵심 포인트

추가 코드가 필요 없는 Idempotency

댓글

추가 코드가 필요 없는 Idempotency