Skip to main content
롤백이 배포된 포인터를 뒤로 이동. 새 실행이 옛 버전 사용; 진행 중 실행은 시작한 것에서 완료. 롤백은:
  • 즉시 — 재배포가 아닌 포인터 업데이트. 초.
  • 원자적 — 전체 Flow 가 한 번에 롤. 부분 상태 없음.
  • 되돌리기 가능 — 다시 롤 포워드, 또는 다른 어느 버전으로든.
  • 감사 가능 — 액터·이유·타임스탬프와 함께 로깅.

​
언제 롤백

  • 배포 직후 시그널 스파이크.
  • 회귀가 늦게 잡힘 (시뮬레이션이 아니라).
  • 하류 의존성이 깨졌고 수정이 시간 걸림 — 롤백이 시간 벎.
  • Canary 롤아웃이 오작동.
롤백 비용 매우 낮음. 늦기보다 빨리 롤백.

​
롤백 방법

​
앱에서

Flow → Versions → 이전 버전 선택 → Rollback. 이유와 함께 확인.

​
CLI 에서

버전 ID 는 짧은 해시 (또는 버전 번호, 예: v14).

​
웹훅에서 (자동 롤백)

Flow 별 설정: Flow settings → Auto-rollback.
  • 트리거: 시그널률 > 임계값, 에러율 > 임계값, 실행당 비용 > 임계값, canary 지표 발산.
  • 롤백 타겟: 이전 버전, 또는 특정 고정된 “safe” 버전.
  • 알림: Slack 채널, on-call PagerDuty.
자동 롤백은 여러분이 설정한 특정 트리거와 Flow 에만 관여 — 선제적 롤백 안 함.

​
무엇이 롤백

버전의 모든 것:
  • 프롬프트.
  • 와이어링된 연결.
  • 도구 설정과 시크릿.
  • 설정과 제한.
  • 붙은 프리셋 버전.
  • 붙은 데이터 소스 버전.
Flow 버전 밖에 사는 것은 롤백 안 됨:
  • 지식 베이스의 문서 (버전이 특정 문서 버전 고정하지 않은 한).
  • 이전 버전이 라이브였던 후 쓰인 메모리 항목.
  • 트레이스 (실행별이고 실행한 버전에 붙어 있음).

​
롤백 후

  • Draft 는 안 만짐. 롤백된 버전이 새 작업 기반이 되길 원하면 Restore Draft from version 사용 (Draft 참고).
  • 새 버전에 대해 열린 시그널은 열린 상태 유지, 그것을 생성한 버전으로 태깅.
  • 개선 이력이 롤백을 별도 항목으로 표시.

​
롤백 vs. restore-draft

다른 두 액션:
  • Rollback — 프로덕션 포인터 이동. Draft 변경 없음. 프로덕션이 옛 버전 실행. 되돌리기 가능.
  • Restore Draft from version — Draft 가 옛 버전의 콘텐츠로 교체. 프로덕션 변경 없음 (여전히 현재 가리키는 버전에). 그 다음 편집하고 새로 배포 가능.
응급에는 롤백. 옛 버전을 새 수정으로 손 수정하고 싶으면 restore-draft.

​
특정 개선의 롤백

어느 개선이 이슈 일으켰는지 알면 전체 버전이 아닌 개선 롤백: Optimization → History → Improvement → Rollback. 이것이 버전 롤백보다 세밀 — 그 개선의 변경만 되돌리고 후속 개선은 그대로. 롤백되는 것과 나중 개선이 충돌하지 않을 때만 동작.

​
감사

모든 롤백이 로깅:
  • 누가 개시했나.
  • 어느 버전에서 → 어느 버전으로.
  • 이유 (필수).
  • 수동 또는 자동 트리거 여부.
컴플라이언스용 익스포트 가능.