참조AI 스킬구조 비교

구조 비교

나두바이오의 단백질 구조 두 개를 비교할 때 사용한다.

스킬 버전: 1.0.0. 자료: skill://nadoobio-structure-comparison/SKILL.md.

대상과 대응 확인

  • 실행 결과는 get_result의 파일명과 SHA-256을, 보관 파일은 inspect_input의 artifactId·SHA-256·generation·inspectionVersion을 사용한다. 사용자에게 선택받은 같은 프로젝트의 두 원본을 first, second에 넣는다. second가 기준 구조다.
  • preview_structure_comparison에 projectId와 두 원본을 전달한다. 미리보기는 저장하지 않는다. 좌표를 직접 계산하거나 URL·임의 로컬 경로를 입력하지 않는다.
  • 모델·사슬이 여러 개면 응답의 모델·사슬 목록으로 의도를 확인한다. firstSelection/secondSelection에 정확한 modelKey·chainKey를 사용한다. start/end는 작성자 잔기 번호가 아닌 1부터 시작하는 관찰 위치이며 양 끝을 포함한다.
  • 구간은 사용자가 요청한 경우에만 좁힌다. 전체 비교가 나쁘다는 이유로 편차가 큰 부분을 자동 제외하지 않는다. 선택한 관찰 서열이 다르거나 Cα가 누락된 경우 오류를 설명한다. 서로 다른 서열 자동 정렬은 이 버전에서 지원하지 않는다.

계산과 저장

  • ready=true 결과의 rmsd·pairs·coverage·residues를 읽는다. 미리보기의 지표도 플랫폼이 계산한 값이다.
  • 사용자가 저장·공유·재열기를 원하면 create_structure_comparison으로 같은 원본·확정된 선택과 requestId를 전달한다. 응답을 못 받았으면 같은 requestId와 동일 요청으로 재시도한다. 같은 키를 다른 비교에 재사용하지 않는다.
  • 저장에는 jobs:read와 files:write 권한이 필요하다. 비교 저장은 GPU 모델 실행이 아니며 GPU 실행 승인을 요구하지 않는다. 권한 오류는 요청된 스코프와 프로젝트 접근을 확인하며 우회하지 않는다.
  • 이후 get_structure_comparison에 projectId와 comparisonId를 전달한다. 반환된 링크로 사용자에게 비교 화면을 제공한다. 파일 접근이 회수되거나 원본 상태가 달라지면 과거 결과를 현재 사용 가능한 결과처럼 안내하지 않는다.

해석

RMSD는 대응하는 Cα를 회전·이동해 맞춘 뒤 거리 제곱을 평균하고 제곱근을 취한 값이다. Å 단위이며 낮을수록 비교한 좌표가 가깝다. 위치별 편차도 같은 전체 맞춤을 적용한 거리다. 비교 위치 수·선택 구간·제외 수를 함께 설명한다.

좌표 차이, 모델 신뢰도, 실험 결과를 구분한다. 낮은 RMSD가 기능·결합·실험 성공을 입증하지 않는다. 구조 파일의 B-factor 열을 근거 없이 pLDDT로 해석하지 않는다. 관찰 서열 일치는 관찰되지 않은 잔기가 생물학적으로 없다는 뜻이 아니다.

출처는 응답의 원본 해시·선택·알고리즘 버전을 유지한다. 저장된 비교의 이미지가 필요하면 render_result_view에 kind=structure-comparison, projectId, comparisonId를 전달한다. PNG image 블록과 comparison 수치, 같은 비교의 웹 링크를 함께 제공한다. 이미지는 맞춘 좌표의 고정 XY 투영이며 전체 3D 화면이 아니다. 이미지의 A/B는 comparison.first/second에 대응한다. render.status=unavailable이면 수치와 웹 링크만 안내하며 이미지 생성 성공을 주장하지 않는다. sourceSha256·viewSpecSha256·imageSha256은 각각 비교 원문·표현 명세·PNG 바이트의 해시다. 이미지 제공을 위해 새 비교 저장이나 GPU 작업을 자동 실행하지 않는다.

프로젝트 ID를 모르면 list_projects로 접근 가능한 프로젝트를 찾고, list_artifacts에 projectId와 검색어 q를 전달해 보관 자료를 찾으세요. nextCursor가 있으면 같은 조건으로 다음 페이지를 조회하세요. 반환된 화면 링크로 자료를 확인하며 목록이나 downloadAllowed를 실행 적합성 승인으로 해석하지 마세요.

이 페이지의 내용