참조AI 스킬여러 건 한 번에

여러 건 한 번에

나두바이오에서 후보 여러 건의 계획을 만들고 제출 가능 상태를 확인할 때 사용한다.

스킬 버전: 1.0.0. 자료: skill://nadoobio-batch-screening/SKILL.md.

원칙

  • 후보가 여러 건이면 create_plan을 반복하지 않는다. 입력을 CSV나 FASTA로 프로젝트에 보관하고 create_batch_plans를 쓴다.
  • 먼저 inspect_input으로 파일의 generation·sha256·inspectionVersion을 읽어 그대로 넘긴다. 값이 바뀌면 batch_source_changed가 난다.
  • 열 위치를 추측하지 않는다. preview_batch_plans를 mappings: []로 불러 headers(열 번호:이름)와 데이터 행 수를 확인한다. 이 호출은 계획을 만들지 않는다.
  • 열 매핑은 열 이름이 아니라 위치(columnIndex)로 한다. 이름 열이 있으면 nameColumn으로 지정한다.
  • 매핑을 정한 뒤 같은 인자로 preview_batch_plans를 한 번 더 불러 거절 행과 설정 문제가 없는지 보고 create_batch_plans를 부른다.
  • 사용자가 계획을 만들어 달라고 했고 미리보기에 거절 행과 설정 문제가 없으면, 같은 대화에서 바로 create_batch_plans까지 진행한다. 계획 생성은 실행이 아니다. 미리보기와 생성 결과를 함께 알린다.

결과 읽기

  • rows의 rejected는 그 행만 고쳐 새 batchRequestId로 다시 만든다. 이미 만든 계획은 재시도해도 늘지 않는다.
  • 생성 응답의 approval.status와 reason을 먼저 읽는다. pending이면 반환된 approval.href를 사람에게 전달한다. 웹에서 계획·입력·설정·이용 조건을 검토하고 선택한 계획만 승인한다. reviewMode: exact_plan_list이면 한 번에 최대100개를 검토하며, 한 페이지 승인으로 전체 묶음이 승인됐다고 말하지 않는다. API 키로 사람의 동의를 대신 기록하지 않는다. 승인 후 사용자가 제출을 요청하면 원래 batchId로 submit_batch를 호출한다. 구버전의 individual_plan_approval_required는 각 계획의 get_plan 검토 링크와 submit_plan 경로를 따른다. 그 밖의 unavailable은 응답 사유에 맞게 안내한다.
  • submit_batch는 행 순서로 제출한다. stoppedByQuota:true면 quota를 알리고 멈춘다. 같은 submitRequestId 재시도는 이미 접수된 행을 skipped로 돌려준다.

입력 형식과 설정 조합

  • 지원 입력·사슬 수·필수 자료는 get_tool_schema와 list_execution_options의 현재 응답으로 확인한다. 묶음 실행이 단독 실행의 모든 입력을 지원한다고 가정하지 않는다.
  • CSV 열 매핑은 실제 headers와 schema에 있는 설정 키를 사용한다. 열 번호는 0부터 시작한다. FASTA의 서열/이름 열 위치와 설정 조합 가능 여부는 미리보기 응답으로 확인한다.
  • 사용자가 선택하지 않은 설정을 임의로 채우지 않는다. 입력 자료 행 수와 조합으로 생성되는 계획 수를 구분하고, 오류/빈행을 포함한 실제 건수는 미리보기 응답을 따른다.
  • 설정·열 매핑·조합 축이 바뀌면 새 생성 요청으로 처리한다. 응답만 잃었으면 원 본문과 같은 batchRequestId 또는 submitRequestId로 복구한다.
  • planHash는 입력과 설정 추적에 쓰이며 서로 다른 실행 환경에서 바이트 일치를 보장하지 않는다. 완료 후 결과·출처와 서버가 반환한 상세/구조 링크를 함께 제공한다.

제출 전 조건 확인

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

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

이 페이지의 내용