워크플로우 생성하기에서 저장한 워크플로우와 설정 ID를 사용해요. 이 페이지에서는 워크플로우 찾기, 새 버전 시험과 기본 설정 선택, 사용하지 않는 워크플로우 삭제를 안내합니다.
새 워크플로우를 만들려면 워크플로우 생성하기를 확인하세요.
내 워크플로우 찾기
이름은 워크플로우를 알아보기 위한 것이고, 요청에서는 ID로 지정해요. 이름을 바꾸려면 다음처럼 요청합니다.
이름을 바꿔도 처리 방법은 달라지지 않아요. 처리 방법을 바꾸려면 새 설정 버전을 만듭니다.
설정 버전(Config)에는 어떤 단계를 어떤 순서로 실행할지, 각 단계에서 무엇을 처리할지를 저장해요. 예를 들어 설정 1은 청구서 번호·총액을 추출하고, 설정 2는 여기에 청구서 날짜를 추가할 수 있습니다. 설정 2를 만들어도 설정 1은 남아 있어요.
새 설정 버전 저장하기
워크플로우 생성하기의 두 단계 설정을 기준으로 추출 항목을 바꾸고 새 이름을 붙여 저장하세요. 시험 중에는 is_default를 False로 둡니다. 새 버전을 만들 때는 수정한 전체 steps 목록을 보내며, 이전 버전은 바뀌지 않아요.
Python 예제는 워크플로우 생성하기의 client와 저장한 ID를 사용해요. cURL은 같은 흐름에서 받은 UPSTAGE_API_KEY, WORKFLOW_ID, CONFIG_ID 중 해당 작업에 필요한 값을 사용합니다. node_id가 있으면 기존 값을 유지합니다. 버전이 바뀌어도 같은 처리 단계임을 나타내는 ID예요.
기본 설정을 바꾸지 않고 시험하기
실행 요청의 config_id에 새 candidate_id를 넣어 시험하세요. config_id를 지정하지 않는 다른 요청은 기존 기본 설정을 계속 사용합니다. 원본 문서와 추출 결과를 비교한 뒤 기본 설정을 바꾸세요.
기본 설정 선택과 이전 버전으로 돌아가기
기본 설정은 실행 요청에서 config_id를 생략했을 때 사용하는 버전이에요. 가장 최근에 만든 버전과 다를 수 있습니다. 이전 버전으로 돌아가려면 이전 설정 ID로 같은 요청을 보내세요. 이미 실행한 작업의 설정은 바뀌지 않아요.
저장된 버전 확인과 관리
요청에는 반환된 cfg_... ID를 사용해요. 표시용 버전 순번(external_id)은 설정 ID가 아닙니다. 기존 버전은 이름·기본 설정 여부를 바꿀 수 있지만 처리 단계는 새 버전으로 저장해야 해요. 기본 버전을 삭제하면 워크플로우의 기본 설정이 비고, 이후 config_id 없이 보낸 실행 요청은 실패해요. 이런 요청을 계속 사용하려면 삭제 전에 다른 버전을 기본으로 선택하세요. Configs 명세와 처리 단계 연결에서 자세히 확인할 수 있습니다.
cURL에서는 후보 설정 ID를 CANDIDATE_ID에 저장해요. 시험 실행할 때는 CONFIG_ID 대신 이 값을 사용하세요.
사용하지 않는 워크플로우 삭제하기
API로 삭제한 워크플로우를 복구하는 기능은 없어요. 워크플로우를 삭제해도 기존 실행 기록까지 지워지지는 않습니다. 실행 기록을 지우는 방법은 실행 작업 삭제, 정확한 요청 필드와 삭제 영향은 Workflows 명세를 확인하세요.