Key Concepts
벌크 런 테스트 설정
벌크 런 테스트(Bulk Run Test)는 어빌리티(Ability)가 다양한 입력값에 대해 일관된 결과를 산출하는지 검증하는 대량 실행 테스트 기능입니다. 일반적인 기능 점검은 어빌리티 테스트로 충분하지만, 실제 서비스에 배포하기 전에는 대량의 입력 데이터로 결과의 정확성·구조·품질을 함께 확인해야 합니다. 특히 LLM 노드를 사용하는 어빌리티는 동일한 입력 구조에서도 출력 형식이 달라질 수 있어, 벌크 런 테스트로 사전 검증하는 과정이 중요합니다. 단순 검증 목적 외에도 특정 어빌리티로 대량의 데이터를 일괄 처리할 때도 이 기능을 활용할 수 있습니다.
이 가이드에서는 벌크 런 테스트에 필요한 어빌리티 버전과 데이터 스토리지를 준비하고, 벌크 런을 생성해 실행 결과를 확인하는 전체 과정을 안내합니다.
사전 준비
테스트할 어빌리티가 이미 완성되어 있어야 합니다. 데이터 구조(Data Structure)와 데이터 스토리지(Data Storage) 개념이 처음이라면 🔗데이터 스토리지 사용하기를 먼저 참고하면 이해가 쉽습니다.
1단계: 테스트할 어빌리티 버전 생성
테스트할 어빌리티를 완성했다면 새로운 버전을 생성합니다. 벌크 런 테스트는 버전이 존재하는 어빌리티에서만 실행할 수 있습니다.
2단계: 인풋·아웃풋 스토리지 준비
벌크 런 테스트는 여러 입력값과 그 결과를 자동으로 처리하므로, 입력값을 저장할 스토리지와 결과를 저장할 스토리지 두 개가 각각 필요합니다.
데이터 구조(Data Structure) 탭에서 +데이터 구조 생성(Create Data Structure) 버튼을 클릭해 데이터 구조를 추가합니다.
데이터 스토리지(Data Storage) 탭에서 +스토리지 생성(Create Storage) 버튼을 클릭해 생성한 데이터 구조를 스토리지로 등록합니다.
스토리지 종류 | 용도 | 주의사항 |
|---|---|---|
인풋 스토리지 | 어빌리티에 전달할 입력 데이터를 저장 | 어빌리티의 인풋 변수 구조와 동일해야 함 |
아웃풋 스토리지 | 어빌리티 실행 결과를 저장 | 어빌리티의 아웃풋 변수 구조와 동일해야 함 |
3단계: 벌크 런 생성
+벌크 런 생성(Create Bulk Run) 버튼을 클릭하고 테스트할 어빌리티와 버전을 선택합니다. 테스트의 이름과 설명을 입력하고 생성(Create) 버튼을 클릭합니다.
4단계: 스토리지 데이터 맵핑
인풋 스토리지(Input Storage) 설정
인풋 스토리지 설정(Setup)에서 앞서 만들어 둔 인풋 스토리지를 선택합니다. 어빌리티의 Input 변수와 스토리지의 필드를 맵핑하고 저장(Save) 버튼을 누릅니다.
아웃풋 스토리지(Output Storage) 설정
아웃풋 스토리지 설정(Setup)에서 앞서 만들어 둔 아웃풋 스토리지를 선택합니다. 어빌리티의 아웃풋 변수와 스토리지의 필드를 맵핑하고 저장(Save) 버튼을 누릅니다.
스토리지를 맵핑할 때 변수명은 달라도 되지만, 데이터 타입은 반드시 일치해야 합니다.
5단계: 테스트 실행 및 결과 확인
우측 상단에 활성화된 테스트 시작(Start Test) 버튼을 클릭해 테스트를 진행합니다.
테스트가 완료되면 실행 결과 탭에서 전체 실행 결과를 확인할 수 있습니다. 결과 데이터를 직접 열람하거나 CSV 파일로 다운로드해 외부 검증에도 활용할 수 있습니다.
다음 단계
설정이 완료되었습니다.
이제 벌크 런 테스트로 어빌리티가 다양한 입력값에도 안정적으로 동작하는지 검증할 수 있습니다.
🔗스토리지란? — 데이터 스토리지·데이터 구조·슬립박스와 벌크 런 테스트의 관계를 확인하세요.
🔗데이터 스토리지 사용하기 — 데이터 구조와 데이터 스토리지를 만드는 방법을 다시 확인하세요.
자주 묻는 질문
벌크 런 테스트란 무엇인가요?
벌크 런 테스트(Bulk Run Test)는 어빌리티가 다양한 입력값에 대해 일관된 결과를 산출하는지 검증하는 대량 실행 테스트 기능입니다. 입력용 데이터 스토리지에 저장된 데이터를 한 행씩 순회하며 어빌리티를 반복 실행하고, 그 결과를 별도의 출력용 데이터 스토리지에 쌓습니다.
벌크 런 테스트는 언제 사용해야 하나요?
실제 서비스에 배포하기 전 대량의 입력 데이터로 결과의 정확성·구조·품질을 검증하고 싶을 때 사용합니다. 특히 LLM 노드처럼 동일한 입력 구조에서도 출력 형식이 달라질 수 있는 어빌리티의 품질 검증에 유용하며, 단순 검증 외에도 특정 어빌리티로 대량 데이터를 일괄 처리하는 용도로도 활용할 수 있습니다.
벌크 런 테스트를 사용하려면 데이터 스토리지가 꼭 필요한가요?
네, 필요합니다. 벌크 런 테스트는 데이터 스토리지 위에서 동작하는 기능이라, 입력값을 저장할 인풋 스토리지와 결과를 저장할 아웃풋 스토리지가 각각 있어야 합니다. 두 스토리지 모두 데이터 구조를 먼저 정의해야 만들 수 있으며, 인풋·아웃풋 스토리지는 반드시 서로 다른 스토리지여야 합니다.