연구자

Boltz 여러 건 준비하기

CSV·FASTA의 단일 단백질 서열로 여러 실행 계획을 준비하고 입력 검사, 설정 조합, 제출 가능 여부를 확인합니다.

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

어떤 입력을 받나요?

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

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

CSV 예시는 다음과 같습니다. 헤더와 작업 이름은 한국어로 쓸 수 있습니다. 서열에는 원본의 아미노산 한 글자 코드를 그대로 사용합니다.

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

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

파일에서 계획까지

  1. Boltz·버전 선택
  2. 파일 선택·업로드
  3. 열 지정
  4. 미리 확인
  5. 계획 만들기
  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을 확인하세요.

나두바이오 API 키로 만든 Boltz 계획은 반환된 묶음 승인 링크에서 입력·설정과 이용 조건을 확인한 뒤 선택하여 승인할 수 있습니다. 한 번에 최대100개를 검토하며, 다음 페이지는 별도로 검토합니다. 승인은 작업을 제출하지 않습니다. 승인 후 제출을 요청하면 에이전트가 원래 batchId로 submit_batch를 호출합니다. 미승인·만료·조건 변경은 행별로 거절됩니다. 응답이 끊기면 같은 submitRequestId와 본문으로 확인하며 새 작업으로 다시 만들지 않습니다. 구버전 서버가 individual_plan_approval_required를 반환하면 get_plan의 개별 검토 링크와 submit_plan을 사용합니다.

사람이 승인한 뒤 get_plan으로 현재 승인 상태와 usageTerms를 확인합니다. 조건이 있으면 acceptedAt이 있는지 확인하고, 반환된 usageTerms.termsHash를 submit_batch.acceptedTermsHash로 그대로 전달합니다. 해시 전달은 사람의 동의를 대신하지 않습니다. 서로 다른 조건 해시가 있는 계획은 같은 묶음 제출에 하나의 해시를 적용하지 말고, 각 계획의 현재 조건을 확인해 submit_plan으로 제출합니다. 응답 유실 재시도에는 최초 본문과 요청 ID를 유지합니다.

묶음 생성 요청의 재조회는 approval.counts로 현재 승인 대기·승인됨·만료·접수 건수를 돌려줍니다. approval.status가 partial이면 남은 대기·만료 항목만 검토하고, approved이면 현재 조건과 제출 가능 상태를 확인합니다. submitted이면 기존 작업 링크를 안내하며 새 승인이나 새 묶음 생성을 요청하지 않습니다. approval.required: false는 해당 조회에서 새 계획 승인이 필요 없다는 뜻이며, 현재 이용 조건·권한·한도를 통과했다는 뜻은 아닙니다.

재시도와 결과 추적

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

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

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

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

이 페이지의 내용