이벤트 소싱 기반 워크플로 상태 관리
워크플로 상태 저장 방식을 이벤트 소싱으로 바꾸고 provider-executed tools와 처리 성능을 개선했습니다.
교안에 영향
예전 안내에서 runs, steps, hooks를 직접 갱신하는 방식으로 설명한 내용은 더 이상 맞지 않습니다.
요약
- runs, steps, hooks의 상태 관리가 이벤트 소싱 기반으로 바뀌었습니다. - 이벤트 로그를 재생해 현재 상태를 복원하고, 누락된 상태를 자동으로 복구합니다. - @workflow/ai에 provider-executed tools 지원이 추가되었습니다. - 워크플로 큐 처리량이 크게 늘었고, 여러 기능 지원과 버그 수정도 포함됐습니다.
바뀐 것
새 기능
- @workflow/ai가 Google Search와 WebSearch 같은 provider-executed tools를 지원합니다.
- 새 @workflow/nest 패키지가 NestJS 애플리케이션의 build support와 dependency injection 통합을 제공합니다.
- SWC plugin이 step과 workflow 함수 안에서 TC39 Explicit Resource Management proposal의 top-level using declarations를 지원합니다.
- Client mode가 manifest.json의 classes object를 통해 custom class serialization을 지원합니다.
개선
- Workflow 4.1 Beta에서 workflows의 상태 추적 방식이 이벤트 소싱으로 바뀌었습니다.
- runs, steps, hooks가 더 이상 변경 가능한 데이터베이스 레코드가 아니며, append-only event log의 결과물로 다뤄집니다.
- 각 event는 timestamp와 context를 담고, 런타임은 event를 순서대로 처리해 현재 상태를 도출합니다.
- queue message가 유실되거나 race condition이 발생해도 workflow route를 다시 재생해 누락된 상태를 감지하고 필요한 메시지를 다시 넣습니다.
- event log를 통해 어떤 상태에 이르렀는지 정확한 순서를 다시 재생할 수 있어 분산 워크플로 디버깅이 쉬워집니다.
- event log가 단일한 source of truth가 되어 부분적인 쓰기 실패로 엔티티가 불일치 상태에 빠질 가능성을 줄입니다.
- workflow queue system이 초당 수천 개의 step을 처리할 수 있도록 throughput이 개선되었습니다.
수정
- @workflow/ai의 tool output double-serialization 문제가 수정되었습니다.