설정을 수정하면 초안이 생기고, 실행하면 버전으로 확정돼요. 운영은 검증된 버전 번호를 지정한 API로 돌리고, 개선 실험은 스튜디오 화면에서 자유롭게 이어 가요.
Draft와 Config 버전
워크플로우 설정을 수정하면 다음 번호의 초안(Draft)이 자동으로 만들어지고, 실행하는 순간 정식 설정(Config) 버전으로 확정돼요. 모든 버전이 남아 있어 실험이 안전합니다.
버전이 만들어지는 규칙
- 노드 설정을 수정하면 상단 드롭다운이 다음 번호의 초안으로 바뀌어요. 예: 설정 #7에서 수정을 시작하면 설정 #8 초안이 됩니다.
- 초안은 지금 쓰는 브라우저에 자동으로 저장돼요. 다른 기기나 팀원에게는 보이지 않아요.
- 실행을 누르면 초안이 설정 #8로 확정되고 그 설정으로 케이스가 처리돼요. 실행하지 않고 확정하려면 설정 드롭다운의 초안 항목에서 저장을 누르거나, 채팅 탭에서 v8로 저장 버튼을 누르세요(채팅 탭으로 개선). 스키마 보정 결과를 적용할 때도 새 버전이 만들어져요.
- 버전이 확정되면 "Extract 단계가 추가되었습니다", "모드가 기본형 → 고급형으로 변경되었습니다"처럼 변경 요약이 기록돼요.
- 초안이 필요 없어지면 드롭다운에서 버려 이전 버전으로 돌아갈 수 있어요.
설정 드롭다운에서 할 수 있는 것
| 기능 | 내용 |
|---|---|
| 이름 변경 | 버전에 의미 있는 이름을 붙여요. 예: "FedEx 청구서 최적화", "소수점 형식 추가" |
| 버전 전환 | 이전 버전을 선택해 그 시점 설정으로 문서를 다시 실행할 수 있어요 |
| 설정 비교 | 모아보기에서 켜면 최대 3개 설정 버전의 결과를 나란히 비교해요 |
| Step ID 보기 | 각 노드의 Step ID를 확인해요. API 연동이나 문의할 때 노드를 특정하는 용도예요 |
| 전체 설정 | 모니터링 보기에서 여러 버전의 실행 결과를 합산해 봐요(Aggregate) |
"버전은 자동으로 쌓인다. 부담 없이 실험하고, 의미 있는 버전에는 이름을 붙여 팀이 알아볼 수 있게 하라."
운영 배포 프로세스
API로 운영 중인 워크플로우는 검증된 설정 버전을 지정해서 호출해요. 스튜디오에서의 개선 실험과 운영 배포를 분리하는 것이 안정 운영의 핵심입니다.
기준 버전으로 시작
충분히 테스트한 설정(예: 설정 #12)을 API 호출에 지정해 운영을 시작해요.
스튜디오에서 계속 개선
운영과 별개로 스튜디오에서 스키마를 수정하며 새 버전(#13, #14, #15…)을 만들어 가요. 운영 트래픽은 여전히 #12를 사용하므로 안전합니다.
모아서 배포
모든 버전을 배포하지 말고 개선을 누적한 뒤 묶어서 배포하세요(예: 4~5개 버전마다 한 번). 업무 외 시간 등 계획된 시점에 API가 가리키는 버전 번호를 올립니다.
문제 시 롤백
새 버전 성능이 나쁘면 API의 버전 번호를 이전으로 되돌리면 끝이에요. 스튜디오에서도 이전 버전으로 언제든 전환해 재현할 수 있어요.
과최적화 주의! 0.01% 수준의 미세한 정확도 향상은 배포할 가치가 없어요. 여러 항목에 걸친 의미 있는 개선이 쌓일 때까지 기다렸다가 배포하고, 버전 간 비교는 모니터링을 활용하세요.
"운영은 고정된 버전 번호의 API로, 실험은 화면에서 자유롭게. 배포는 검증된 개선이 쌓였을 때 한 번에."
API로 자동화
화면 없이 API로 문서를 대량 처리할 수 있어요. 사내 시스템에서 문서를 보내고, 처리 결과를 받아 데이터베이스에 적재하는 완전 자동 파이프라인을 구성해 보세요.
API 정보는 어디에 있나요
워크플로우 화면 우측 상단의 더보기(⋯) 메뉴에서 코드를 선택하면 API로 이용하기 패널이 열려요. 이 워크플로우를 애플리케이션에 통합하기 위한 단계별 레퍼런스와 코드 스니펫을 제공합니다.
| 구성 요소 | 내용 |
|---|---|
| Agent ID · Config ID | 호출에 지정할 워크플로우와 설정 버전이에요. Agent ID는 워크플로우 ID예요(API에는 이전 이름인 "에이전트"가 남아 있어요). 원하는 버전은 Config ID 선택기에서 고르면 돼요(설정 버전이 없다면 먼저 실행하거나 저장해 주세요) |
| API key | API key 선택에서 사용할 키를 선택해요. 가입 시 만들어진 기본 키가 자동으로 연결돼요. 추가 키는 설정 → 조직 → API 키에서 만들고 관리해요(콘솔에서도 가능해요) |
| 코드 스니펫 | Step 1 파일 업로드 → Step 2 Job 생성 → Step 3 Job 조회. cURL / Python 언어와 Linux / Windows 명령을 토글로 전환하며 그대로 복사해 쓸 수 있어요 |
| AI 어시스턴트용 안내 | code.md 복사 버튼. 통합 코드를 AI 코딩 어시스턴트에게 맡길 때 이 안내문을 그대로 붙여넣으면 돼요 |
| 문서 보기 | 상세 API 명세(Studio API) 문서로 이동해요 |
호출 흐름
- 파일 업로드: 처리할 문서를 업로드해 file ID를 받아요.
- Job 생성: Agent ID와 Config ID, 업로드한 file ID를 지정해 처리를 요청해요. 특정 설정 버전을 지정하므로 스튜디오에서의 실험이 운영에 영향을 주지 않아요(운영 배포 프로세스).
- Job 조회: Job ID로 처리 상태와 결과를 조회해요. 각 추출값에는 신뢰도(
low/high)가 함께 반환됩니다. - (선택) 검토 완료 결과 조회: 사람 검토가 필요한 업무라면, 검토자가 검토 완료로 표시한 결과만 별도로 조회해 운영 DB에 반영해요.
API로 실행된 작업은 모니터링의 Job 목록에서 소스 필터를 API로 두고 확인할 수 있고, 워크플로우로 가져가기로 화면에 불러와 검토할 수 있어요.
"화면은 만들고 검토하는 곳, API는 돌리는 곳. 버전 번호를 지정한 API 호출이 운영 안정성의 핵심이다."