Boltz 여러 건 준비하기

여러 단백질 서열을 같은 조건으로 예측하거나 설정을 바꿔 비교하려면, 프로젝트의 실행 계획 → 표로 여러 건 만들기를 이용하세요. 여기서 계획을 만드는 것과 GPU 계산을 시작하는 것은 별개입니다. Boltz가 선택기에 나타나는지는 현재 조직에 게시된 실행 가능한 버전에 따라 달라집니다.

어떤 입력을 받나요?

현재 묶음 입력은 CSV 한 자료 행 또는 FASTA 항목 하나에 단백질 사슬 하나를 받습니다. 사슬은 단백질 서열의 한 줄기이며, 이 경로에서는 사슬 A로 저장합니다. 여러 사슬을 :로 연결한 서열, 핵산, 리간드(단백질에 결합하는 작은 분자), 행별 MSA 파일은 받지 않습니다. 여러 성분을 함께 넣으려면 개별 복합체 입력을 사용하세요.

MSA 없이 단일 서열로 예측합니다를 직접 확인해야 합니다. MSA는 비슷한 단백질 서열들을 나란히 정렬한 참고 자료입니다. 이를 생략하면 예측 품질이 낮아질 수 있습니다. 단일 서열 모드를 선택했다고 그 품질이 검증되는 것은 아닙니다.

CSV 예시는 다음과 같습니다. 헤더와 작업 이름은 한국어로 쓸 수 있지만 서열 문자는 번역하지 않습니다.

이름,서열
첫 후보,ACDEFGHIKLMNPQRSTVWY
둘째 후보,MQIFVKTLTGKTITLEVEPSDTIENVKAKIQDKEGIPPDQQRLIFAGKQLEDGRTLSDYNIQKESTLHLVLRLRGG

이는 입력 형식 예시입니다. 특정 연구 목적에 적합한 후보를 추천하거나 예측 품질을 보장하는 자료가 아닙니다. FASTA는 각 > 헤더와 그 뒤 서열을 하나의 항목으로 준비하세요.

파일에서 계획까지

1. Boltz 도구·버전을 선택하고 단일 서열 모드의 조건을 확인합니다.
2. 검사된 보관 파일을 고르거나 여기서 파일 올리기로 CSV·FASTA를 올립니다. 업로드 완료는 입력 검사 완료와 다릅니다. 검사가 끝나 목록에 나타난 파일을 선택하세요. 필요한 경우 창을 다시 열어 목록을 조회합니다.
3. 화면에 나온 실제 열 이름을 보고 단백질 서열 열을 지정합니다. 작업 이름 열은 계산 입력과 별개이며 이름이 있는 열을 선택합니다.
4. 설정값 조합을 고르고 미리 확인을 누릅니다. 자료 행, 생성 가능한 계획, 수정할 입력·설정, 건너뛸 빈 행을 구분해서 확인합니다.
5. 오류를 수정한 뒤 계획 만들기를 누릅니다. 저장된 계획을 검토하고 현재 제출 조건과 이용 조건·사용량을 확인한 뒤 제출합니다.

설정값 조합

seed(난수 시작값), numSamples(생성할 구조 수), numRecycles(구조 갱신 횟수), stepScale(샘플링 단계 배율)을 조합할 수 있습니다. 같은 설정을 파일의 열과 조합 축에 동시에 지정하지 마세요.

예를 들어 유효한 서열 2행에 seed 7·11을 모두 적용하면 계획은 4건입니다. numSamples=2는 계획 하나에서 구조 2개를 생성하는 설정이며 자료 행을 2개로 만드는 옵션이 아닙니다. 최종 건수는 오류·빈 행을 반영한 미리보기와 생성 영수증을 확인하세요. 갱신 횟수나 샘플 수를 늘린다고 정확도가 보장되지는 않습니다.

AI 도구에서 준비할 때

MCP·CLI는 동일한 묶음 계획 서비스를 사용합니다. list_execution_options에서 현재 릴리스·manifestHash를 확인하고, inspect_input의 원본 SHA·generation·inspectionVersion을 보존합니다. preview_batch_plans를 mappings: []로 호출해 실제 headers를 읽은 다음 매핑을 지정해 미리보기를 다시 요청하세요.

위 CSV처럼 이름이 첫 열이고 서열이 둘째 열임을 확인했다면, 다음 설정을 사용할 수 있습니다. 이는 전체 요청이 아니라 매핑·공통 설정·조합 부분의 예시입니다.

{
  "toolType": "boltz",
  "mappings": [{"settingName": "sequence", "columnIndex": 1}],
  "nameColumn": 0,
  "baseSettings": {"proteinMsaMode": "single-sequence", "numSamples": 1, "numRecycles": 1},
  "sweep": {"mode": "cross", "axes": [{"settingName": "seed", "kind": "list", "values": ["7", "11"]}]}
}

열 번호는 0부터 시작합니다. 실제 요청에는 프로젝트·원본 파일·검사 정보·릴리스·manifestHash가 필요하고, 생성에는 batchRequestId도 필요합니다. 생성 응답의 approval.status와 reason을 확인하세요.

현재 Boltz의 API 키 계획은 웹에서 승인해도 제출할 수 없습니다. session_submission_required이면 사용자가 웹에서 같은 입력으로 새 계획을 만들어 검토·제출해야 합니다. 기존 API 키 계획을 웹 계획으로 전환하거나 submit_batch를 반복 호출해 실행하는 방식은 지원하지 않습니다. API 키 계획 준비와 웹 제출은 별도 경로입니다.

재시도와 결과 추적

응답이 끊기면 원 요청을 보존하고 같은 요청 ID·같은 본문으로 접수 여부를 확인합니다. 생성의 batchRequestId와 제출의 submitRequestId는 서로 다릅니다. 같은 ID로 파일·매핑·설정·조합을 바꾸지 마세요. 입력을 바꾸려면 새 요청을 준비합니다. 부분 실패나 사용량 한도 중단은 전체 성공으로 해석하지 않으며 이미 접수된 작업부터 확인하세요.

원본 파일 SHA, 계획 planId·planHash, 행·조합 번호, 작업·실행 시도와 결과 출처를 함께 추적할 수 있습니다. seed와 해시는 입력·설정 확인에 쓰이며 모든 GPU와 라이브러리에서 동일 좌표를 보장하지 않습니다.

완료된 작업에서는 결과 상세와 제공된 구조 링크를 열어 확인합니다. 구조 링크도 현재 조직·프로젝트 접근 권한이 필요합니다. 구조 파일이 보관 파일로 검사된 상태와 실제 3D 뷰어가 정상 표시된 상태는 별개입니다. 계산이 완료됐다는 사실을 실제 결합·생물학적 기능·실험 성공으로 해석하지 마세요.

실행과 승인 · 실행 지원 상태 · 결과 읽는 법