> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.9.6/basic-tutorials/guides/data/dataset/revalidation.md). # 데이터셋 근거 재검증 데이터셋의 각 질문·정답 항목에는 정답의 출처가 되는 AI 드라이브 문서(근거 문서)를 연결할 수 있습니다. 연결해 둔 문서가 갱신·삭제되면 GenOS가 그 문서를 근거로 쓰는 항목을 자동으로 **검증필요**로 표시합니다. 담당자는 바뀐 내용을 확인하고 근거를 다시 지정하거나 검증 완료로 정리합니다. 표시는 데이터셋 목록 배너, 데이터셋 상세 배너, 리비전 상세의 **데이터 정보** 표 세 곳에서 확인할 수 있으며, 데이터셋 읽기·쓰기 권한자에게는 알림도 발송됩니다. 근거 문서로 데이터셋을 자동으로 만드는 방법은 [데이터셋 자동 생성](/default/v1.9.6/basic-tutorials/guides/data/dataset/auto-generation.md)을 참고하세요.

## 주요 개념 | 개념 | 설명 | | --------- | --------------------------------------------------------------------------- | | 근거 문서 | 항목의 정답이 출처로 삼은 AI 드라이브 문서입니다. 한 항목에 여러 건 연결할 수 있습니다. | | 근거 조항(청크) | 문서 안에서 근거가 된 조항입니다. 조항을 고르지 않으면 문서 전체가 근거가 됩니다. | | 기준선 | 근거를 지정한 시점의 문서 버전입니다. 이후 판정은 이 버전과 대조합니다. | | 판정 대상 리비전 | 자동 판정이 적용되는 리비전입니다. **최신 리비전**과 **평가지표가 참조 중인 리비전**만 해당하며, 나머지는 「대상 아님」입니다. | | 자동 플래깅 | 근거 문서가 갱신·삭제됐을 때 항목을 검증필요로 바꾸는 처리입니다. | | 자동 해제 | 문서를 재적재한 뒤 근거 조항이 기준선과 같으면 검증필요를 되돌리는 처리입니다. | ## 재검증이 일어나는 흐름 1. 항목에 근거 문서(또는 조항)를 지정합니다. 지정 시점의 문서 버전이 기준선으로 저장됩니다. 2. 그 문서가 갱신·삭제되면 GenOS가 판정 대상 리비전의 해당 항목을 **검증필요**로 바꾸고, 리비전 활동에 사유를 남깁니다. 3. 데이터셋 목록·상세 배너에 건수가 뜨고, 데이터셋 단위로 알림이 발송됩니다. 4. 담당자가 바뀐 내용을 확인해 **근거 다시 지정** 또는 **검증 완료**로 정리합니다. 5. 재적재 후 근거 조항이 기준선과 같으면 **자동 해제**되어 검증 완료로 돌아갑니다. > AI 드라이브에서 근거로 쓰이는 문서를 덮어쓰거나 삭제할 때는 확인 창에 「덮어쓰면 이 문서를 근거로 쓰는 데이터셋 N건이 재검증 대상이 됩니다.」처럼 영향받는 데이터셋 수가 함께 안내됩니다. ### 검증필요가 되는 사유 4종 | 사유 | 발생 상황 | 활동·알림 문구 | | ----- | ----------------------------- | ----------------------------------------- | | 버전 변경 | 문서가 다른 버전 내용으로 바뀜(덮어쓰기·버전 복원) | 근거 문서 「○○」이 v8 → v9로 갱신되어 자동 플래깅되었습니다. | | 청크 수정 | 근거로 삼은 청크의 내용이 수정됨 | 근거 문서 「○○」의 청크가 수정되어 자동 플래깅되었습니다. | | 조항 삭제 | 근거로 삼은 조항이 새 버전에서 사라짐 | 근거 문서 「○○」의 v9에서 근거 조항이 삭제되어 자동 플래깅되었습니다. | | 문서 삭제 | 근거 문서가 삭제됨 | 근거 문서 「○○」이 삭제되어 자동 플래깅되었습니다. | 근거 문서가 여러 건이면 문구에 「외 N건」이 붙습니다. 조항 단위 근거는 **버전 변경으로 먼저 표시**한 뒤, 재적재가 끝나면 조항을 대조해 같으면 자동 해제하고 사라졌으면 조항 삭제로 바꿉니다. **평가 제외** 항목과 **근거 미연결** 항목은 자동 플래깅 대상이 아닙니다. ### 알림 판정 결과는 데이터셋마다 1건씩 알림으로 발송됩니다. 제목은 「데이터셋 재검증 · {데이터셋명}」이고, 본문은 대표 사유 문장과 항목 수로 구성됩니다. 사유가 섞이면 꼬리에 사유별 건수가 붙고, 문서 삭제가 포함되면 「삭제된 문서는 재검증할 수 없어 근거를 다시 지정하거나 평가에서 제외해야 합니다.」가 덧붙습니다. 수신자는 해당 데이터셋의 IAM 읽기·쓰기 권한자입니다. ## 검증필요 데이터셋 찾기 ### 데이터셋 목록 목록 상단에 「검증필요 데이터셋 N건 · 최근 감지 ○○」 배너가 뜹니다. **\[대상 보기]** 를 누르면 **재검증 상태** 필터가 `검증필요`로 바뀌어 해당 데이터셋만 남고, **\[닫기]** 로 배너를 숨길 수 있습니다.

**재검증 상태** 열의 데이터셋 단위 상태는 3종입니다. 판정 대상 리비전(최신 + 평가지표 참조 중)의 항목을 합산하며 근거 미연결 항목은 집계에서 뺍니다. | 상태 | 뜻 | | ------ | -------------------------------- | | 검증필요 | 근거 문서 갱신·삭제로 재검증이 필요한 데이터셋 | | 근거 미연결 | 근거 문서가 연결된 항목이 없어 판정 대상이 아닌 데이터셋 | | 검증 완료 | 판정 대상 항목이 모두 검증 완료된 데이터셋 | 자동 생성 작업이 진행 중이거나 중단된 데이터셋은 같은 열에 **생성 중 · 생성 중단**이 대신 표시됩니다. **대상 건수** 열의 아이콘에 마우스를 올리면 사유별 내역이 뜹니다.

### 데이터셋 상세 데이터셋 상세의 **기본 정보** 탭 상단에 「검증필요 항목 N건 · 버전 변경 N건 · 리비전 N개」 배너가 뜹니다. **\[재검증 대상 보기]** 를 누르면 검증필요 항목이 있는 리비전으로 바로 이동합니다.

**열 목록**의 `재검증 상태 (시스템)` · `근거 문서 (시스템)`은 업로드한 데이터셋 파일에 없어도 GenOS가 붙이는 열이며 지울 수 없습니다. ### 리비전 목록 어느 리비전이 판정 대상인지는 **리비전 목록** 탭에서 확인합니다.

| 열 | 내용 | | ---------- | --------------------------------------------- | | 검증필요 | 그 리비전의 검증필요 항목 수. 아이콘에 마우스를 올리면 사유별 내역이 표시됩니다 | | 판정 대상 | `최신 리비전` · `평가지표 참조 중` · `대상 아님` | | 근거 갱신 감지일시 | 마지막으로 자동 플래깅이 일어난 시각 | ## 항목 상태와 처리 ### 항목 상태 4종 리비전 상세의 **데이터 정보** 표에서 항목마다 하나씩 붙습니다. 표 상단의 **재검증 상태** 필터로 상태별로 걸러 볼 수 있습니다.

| 상태 | 뜻 | | ------ | ---------------------- | | 검증필요 | 근거 갱신·삭제로 재검증이 필요한 항목 | | 근거 미연결 | 근거 문서가 없는 항목(판정 대상 아님) | | 검증 완료 | 확인이 끝난 항목 | | 평가 제외 | 채점에서 제외한 항목 | ### 데이터 정보 표

| 요소 | 내용 | | ----------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 근거 연결 N / N | 근거가 연결된 항목 수 / 전체 항목 수 | | 재검증 상태 필터 | 상태 4종을 체크로 걸러 봅니다 | | \[전체 검증 완료] | 리비전의 검증필요 항목을 한 번에 정리합니다(확인 창 「검증필요 항목 N건을 모두 검증 완료로 처리하시겠습니까?」). **현재 필터와 무관하게 리비전 전체에 적용**되며, 검증필요 항목이 없으면 비활성(「검증필요 항목이 없습니다.」)입니다 | | 재검증 상태 열 | 항목별 상태 | | 근거 문서 열 | 그 항목의 근거 문서. 삭제·변경된 문서를 먼저 표시하고 나머지는 「외 N건」으로 접습니다 | 일부 근거 문서에 읽기 권한이 없으면 표 상단에 「일부 근거 문서 조회 권한 없음 · 판정은 서버 수행」이 함께 표시됩니다. 판정 자체는 서버가 하므로 상태 표시는 정상입니다. ### 여러 건 한 번에 처리 체크박스로 항목을 고르면 하단에 일괄 작업 바가 나타납니다.

| 버튼 | 하는 일 | 완료 안내 | | ----- | ---------------------------------------------------------------- | --------------------------------------------------- | | 근거 지정 | 고른 항목에 같은 근거 문서를 한 번에 지정. 1건만 고르면 행 **관리** 메뉴처럼 기존 근거가 선택된 채로 열림 | 항목 N건에 근거 문서 N건을 지정했습니다. (1건이면 「근거 문서 N건을 지정했습니다.」) | | 근거 해제 | 근거 연결을 끊음(확인 창 「근거 지정을 N건 해제하시겠습니까?」) | 근거 지정이 N건 해제되었습니다. | | 검증 완료 | 검증필요 → 검증 완료 | 항목 N건이 검증 완료 처리되었습니다. | | 평가 제외 | 채점에서 제외. 이미 제외된 항목만 고르면 「평가 제외 해제」로 바뀜 | 항목 N건이 평가 제외 처리되었습니다. | 버튼은 고른 항목 중 **처리할 수 있는 항목이 하나라도 있으면** 활성입니다. 하나도 없으면 「선택한 항목 중 처리할 대상이 없습니다.」가 표시됩니다. 일부만 실패하면 「N건 처리 · N건 실패」로 알려 줍니다. ### 한 건만 처리 행 오른쪽 **관리** 메뉴에서 같은 동작을 고를 수 있습니다.

| 작업 | 가능한 사용자 | | ---------------------------------------- | ----------- | | 데이터 정보 표·활동 조회 | 데이터셋 읽기 권한자 | | 근거 지정·해제, 검증 완료, 평가 제외, 전체 검증 완료, 리비전 수정 | 데이터셋 쓰기 권한자 | ## 근거 문서 지정 ### 문서 고르기

1. **드라이브 선택** — 근거 문서가 있는 AI 드라이브를 고릅니다. 2. **파일 선택** — 폴더를 체크하면 안의 파일이 모두 선택되고, 드라이브를 바꿔 이어서 고를 수 있습니다. 3. **선택된 문서** — 고른 문서 목록입니다. 4. **\[조항 지정]** — 문서 안에서 근거가 된 조항(청크)만 고릅니다. 5. **근거 N / 20** — 한 항목에 지정할 수 있는 근거는 최대 20건입니다. 조항을 고르지 않으면 **문서 전체가 근거**가 됩니다. 적재가 끝나지 않은 문서는 근거로 지정할 수 없습니다. ### 조항 고르기 **\[조항 지정]** 을 누르면 문서뷰의 **청크 데이터** 탭이 조항 선택 모드로 열립니다.

조항을 여러 건 고를 수 있고, **\[청크 전체 펼치기]** 로 본문을 모두 펼쳐 확인할 수 있습니다. **\[근거로 지정]** 을 누르면 **그 시점의 문서 버전이 기준선으로 저장**됩니다. * 지능형 전처리기를 쓰지 않은 문서는 조항 단위로 대조하지 않고 **문서 버전 단위로** 판정합니다. * 문서가 재적재 중이면 「문서 재적재가 끝나야 조항을 지정할 수 있습니다.」가 표시되고 조항을 고를 수 없습니다. * 현재 버전에 없는 조항이 선택돼 있으면 해제해야 지정할 수 있습니다. ## 바뀐 내용 확인 검증필요 항목의 **근거 문서**를 누르면 문서뷰가 **비교 모드**로 열립니다.

| 요소 | 내용 | | ----------- | ----------------------------------------------------------------------------------------------- | | 기준선 → 현재 버전 | 「v4 → v9」처럼 두 버전을 함께 표시합니다 | | 대조 결과 | 두 버전을 모두 보관하고 있을 때 바뀐 조항을 「변경됨」·「삭제됨」으로 표시합니다. 기준선 버전이 남아 있지 않으면 「기준선 버전이 없어 비교할 수 없습니다」가 표시됩니다 | | 하단 안내 | 「이 문서를 근거로 쓰는 항목 N건이 재검증 대상입니다.」 | | 버튼 | \[닫기] · \[근거 다시 지정] · \[재검증 대상 보기] | **\[근거 다시 지정]** 으로 조항을 다시 고르면 그 시점 버전이 새 기준선이 되고 항목은 검증 완료로 돌아갑니다. 리비전을 수정하는 중에는 열람만 가능하며 새 탭으로 열립니다. ## 활동 기록 리비전 상세의 **활동** 탭에서 누가 언제 무엇을 했는지 확인합니다. 활동 종류 필터는 `근거` · `판정` · `반영` 세 가지입니다.

기록되는 활동은 근거 문서 연결 · 근거 해제 · 근거 재지정 · 검증 완료 · 평가 제외 · 평가 제외 해제 · 검증필요 자동 플래깅 · 검증필요 자동 해제 · 반영입니다. 시스템이 수행한 처리는 작성자가 `system`으로 남습니다. ### 자동 해제 조건 재적재 후 근거 조항이 기준선과 같으면 사유와 관계없이 검증 완료로 돌아가고, 활동에 「근거 조항이 그대로여서 자동 해제되었습니다.」가 남습니다. 단, * 그 항목의 **다른 근거가 아직 바뀐 상태면** 해제하지 않습니다. * **평가 제외** 항목은 그대로 둡니다. ## 리비전 수정과 근거 유지 질문·답변을 고치는 방법에 따라 기존 근거의 유지 여부가 달라집니다. | 방법 | 근거 | | ------------------------------------- | -------------------------------- | | 리비전 상세 \[리비전 수정] → 셀 수정 → \[리비전으로 반영] | 질문·답변을 고쳐도 **기존 근거 유지** | | 데이터셋 파일을 올려 리비전 추가 | 질문·답변이 바뀐 항목은 **근거가 끊김**(근거 미연결) | > 질문·답변만 고칠 때는 **\[리비전 수정]** 을 쓰는 것이 안전합니다. 수정 내용은 현재 리비전을 건드리지 않고, 반영할 때 새 리비전 1개로 묶입니다. ## 오류·예외 처리 | 상황 | 표시 문구 | 조치 | | ------------------------ | ----------------------------------------------------- | ---------------------- | | 한 항목의 근거가 20건을 넘음 | 근거는 한 항목에 최대 20건까지 지정할 수 있습니다. 현재 N건 | 근거 수를 줄입니다 | | 폴더를 통째로 골라 상한 초과 | 이 폴더를 선택하면 N건이 추가되어 상한 20건을 넘습니다. 파일을 직접 선택해 주세요. | 파일을 직접 고릅니다 | | 적재가 끝나지 않은 문서를 근거로 지정 | 「{이름}」은(는) 근거로 지정할 수 없습니다. 적재가 완료된 문서만 지정할 수 있습니다. | 적재 완료 후 지정합니다 | | 선택한 항목에 처리할 대상이 없음 | 처리할 항목이 올바르지 않습니다. | 처리할 항목을 다시 고릅니다 | | 지정해 둔 조항이 현재 버전에 없음 | 「{이름}」 문서의 근거 조항이 현재 버전에 없습니다. \[조항 지정]에서 다시 선택해 주세요. | 조항을 다시 고릅니다 | | 수정 중 다른 사용자가 새 리비전을 만듦 | 다른 사용자가 새 리비전을 만들었습니다. 새로고침 후 다시 수정해 주세요. | 새로고침 후 다시 수정합니다 | | 업로드 파일의 열 구성이 기존 리비전과 다름 | 파일 정보가 맞지 않습니다. 「{파일}」 파일의 열 구성이 기존 리비전과 다릅니다. | 기존 리비전과 같은 열 구성으로 올립니다 | | 리비전을 찾을 수 없음 | 리비전을 찾을 수 없습니다. | 목록에서 다시 진입합니다 | 근거 문서 상태에 따라 다음 안내가 표시됩니다. | 상황 | 문구 | | -------------- | -------------------------------------------------------------------- | | 근거 문서가 휴지통에 있음 | 휴지통으로 이동된 문서입니다. 복원하면 근거가 되살아납니다. | | 근거 문서가 영구 삭제됨 | 영구 삭제된 문서입니다. 근거를 다시 지정하거나 평가에서 제외해 주세요. | | 근거 문서 읽기 권한 없음 | 근거 문서에 대한 읽기 권한이 없습니다. | | 재적재 전 문서뷰 진입 | 재적재 전입니다. 아래 청크는 이전 버전 기준이라 현재 본문과 다를 수 있으며, 변경 내용 대조는 재적재 후에 가능합니다. | ## 사용 시나리오 ### 규정이 개정되어 알림을 받은 담당자 AI 드라이브의 규정 문서가 v8에서 v9로 갱신되면 「데이터셋 재검증 · {데이터셋명}」 알림이 옵니다. 데이터셋 목록 배너의 \[대상 보기]로 해당 데이터셋을 찾아 들어가고, 상세 배너의 \[재검증 대상 보기]로 리비전에 진입합니다. 데이터 정보 표에서 검증필요 항목의 근거 문서를 눌러 비교 모드로 바뀐 조항을 확인한 뒤, 정답이 그대로 유효하면 \[검증 완료]를, 근거 조항이 옮겨 갔으면 \[근거 다시 지정]으로 조항을 다시 고릅니다. ### 문서가 삭제된 경우 근거 문서가 휴지통에 있으면 복원하는 것으로 끝납니다. 영구 삭제됐다면 비교할 대상이 없으므로, 다른 문서로 **근거를 다시 지정**하거나 해당 항목을 **평가 제외**로 돌립니다. ### 내용 변화 없이 재적재만 한 경우 문서를 덮어쓰면 우선 버전 변경으로 표시되지만, 재적재가 끝나고 조항이 기준선과 같으면 자동 해제되어 검증 완료로 돌아갑니다. 담당자가 따로 할 일은 없고, 활동 탭에 「검증필요 자동 해제」가 남습니다. ### 평가 대상에서 빼고 싶은 항목 더 이상 채점에 쓰지 않을 항목은 \[평가 제외]로 돌립니다. 이후 근거 문서가 바뀌어도 검증필요로 표시되지 않고, 자동 해제 대상에서도 빠집니다. 되돌리려면 \[평가 제외 해제]를 씁니다. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://genos-docs.gitbook.io/default/v1.9.6/basic-tutorials/guides/data/dataset/revalidation.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.