KOIIAAI Ready Data 처음으로

홈›개발자 · AI›규격

데이터 팩 규격

데이터 팩의 파일 구성과 기재 항목, 준비 단계를 설명합니다.

팩 구조: 모든 팩에 공통인 파일 배치

예시 팩 내려받기(136 KB)

예시: 한국석유공사_알뜰주유소 현황(15076635)

1 · manifest.json · 꾸러미 명세 · 무결성(봉인)

「내려받은 파일이 발행본 그대로인가?」

팩의 시작 파일(목차)입니다. 포함된 파일마다 역할 · 형식 · 크기 · SHA-256 지문을 기록합니다. 지문이 하나라도 다르면 변경된 파일입니다. 준비 상태(lifecycleStatus)도 여기에 기록됩니다.

{
  "aird:lifecycleStatus": "ls:Quality-Ready",
  "aird:describedVersion": "1.0.0",
  "dct:modified": "2026-10-22",
  "assets": [
    {
      "@type": "aird:Asset",
      "role": "ar:data",
      "href": "data/dataset-15076635.csv",
      "mediaType": "iana:text/csv",
      "spdx:checksum": {
        "spdx:algorithm": "sha256",
        "spdx:checksumValue": "48337a9baa145930…"
      },
      "size": 205600,
      "datasetVersion": "1.0.0"
    },
    "… 외 8개 파일"
  ]
}

2 · metadata/metadata-1.0.0.json · 데이터 설명서

「무슨 데이터이고, 누가 냈고, 써도 되나?」

제목 · 설명 · 제공 기관 · 원천 주소 · 이용허락 · 개인정보 포함 여부를 국제 표준 어휘(DCAT)로 기록합니다. 사람과 프로그램이 모두 읽을 수 있는 구조입니다.

{
  "dct:title": "한국석유공사_알뜰주유소 현황",
  "dct:publisher": "한국석유공사",
  "dcat:landingPage": "https://www.data.go.kr/data/15076635/fileData.do",
  "dct:license": "이용허락범위 제한 없음",
  "aird:containsPersonalData": false,
  "dct:modified": "2026-02-09"
}

3 · schema/columns-1.0.0.json · 항목 정의서

「이 열은 무슨 뜻이고, 어떤 값이 들어 있나?」

열마다 의미 · 자료형 · 관측된 결측률 · 값의 분포를 기록합니다. AI가 열 이름으로 의미를 추측하지 않고 정의를 참조하도록 하는 파일입니다.

{
  "@type": "csvw:Column",
  "csvw:name": "셀프여부",
  "csvw:datatype": "xsd:boolean",
  "csvw:required": true,
  "aird:columnIndex": 5,
  "csvw:titles": {
    "@value": "셀프여부",
    "@language": "ko"
  },
  "dct:description": {
    "@value": "주유소가 고객이 직접 주유하는 셀프 방식으로 운영되는지의 여부",
    "@language": "ko"
  },
  "aird:descriptionKind": "http://vocab.datahub.kr/def/aird/description-kind/DEFINITION",
  "aird:semanticType": "http://vocab.datahub.kr/def/aird/semantic-type/CODE",
  "aird:observedDatatype": "문자형(VARCHAR)",
  "aird:observedMaxLength": 1,
  "aird:observedMissingRate": 0.0,
  "aird:observedDistribution": "통제어휘 후보(2종)",
  "skos:example": [
    {
      "@value": "Y",
      "@language": "ko"
    },
    {
      "@value": "N",
      "@language": "ko"
    }
  ],
  "aird:codeListCandidate": true
}

4 · data/dataset-15076635.csv · 데이터(원본 + 정제)

「실제 값은? 무엇이 바뀌었나?」

원본 열은 그대로 유지하고, 정리한 값은 「정제_」로 시작하는 열에 추가합니다. 규칙으로 확정할 수 없는 값은 변경하지 않고 [E]를 표시하여 「확인 필요」로 구분합니다(이 데이터 43행). 동일한 내용의 Parquet 파일을 함께 제공합니다.

{
  "columns": [
    "상호",
    "주소",
    "정제_주소"
  ],
  "rows": [
    [
      "도초농협주유소 화도지점",
      "전남 신안군 도초면 서남문로 1311",
      "전라남도 신안군 도초면 서남문로 1311"
    ],
    [
      "남신안농협주유소",
      "전남 신안군 하의면 곰실길 11-33",
      "전라남도 신안군 하의면 곰실길 11-33"
    ],
    [
      "서진도농협 조도지점주유소",
      "전남 진도군 조도면 조도대로 419",
      "전라남도 진도군 조도면 조도대로 419"
    ],
    [
      "북신안농협주유소",
      "전남 신안군 증도면 증도길 389",
      "[E]전남 신안군 증도면 증도길 389"
    ]
  ]
}

5 · gates/G1 · G2-1.0.0.json · 판정서

「정해진 기준을 통과했나?」

게이트(G1 등록 요건 · G2 품질 기준)마다 통과 여부 · 판정 대상 판 · 판정 시각 · 근거 기준을 기록합니다. 사이트는 판정서가 있는 단계만 인정합니다. 등록 요건(G1)과 품질 기준(G2) 판정서가 따로 있고, 미통과면 gateResult가 gr:FAIL입니다.

[
  {
    "gateType": "gt:G1",
    "gateResult": "gr:PASS",
    "aird:datasetVersion": "1.0.0",
    "기준": "등록 요건: 발견 계층 필수 18개 기재 + 배포 digest"
  },
  {
    "gateType": "gt:G2",
    "gateResult": "gr:PASS",
    "aird:datasetVersion": "1.0.0",
    "기준": "G2 결과 = 진단리포트 qTier.qualityReadyEligible 그대로(판정은 진단리포트가 함)"
  }
]

6 · diagnosis/report-1.0.0.json · 진단 기록

「어떤 점검을 거쳤나?」

형식 · 결측 · 중복 등 품질 차원별 진단 결과를 기계가 읽는 형태로 수록합니다. 판정의 근거 자료이며, 수치는 이 화면에 표시하지 않습니다.

7 · profiles/TP-KR-2026-1.0.json · 판정 기준표

「어떤 기준으로 판정했나?」

판정에 사용한 임계값 묶음(임계 프로파일)입니다. 기준표가 변경되면 동일한 데이터도 재판정합니다.

{
  "profileId": "http://vocab.datahub.kr/def/aird/threshold-profile/operator/TP-KR-2026-1.0",
  "version": "1.0",
  "authority": "operator",
  "status": "OFFICIAL"
}

8 · conversion-report.md · 변환 기록

「어떤 값을 어떤 규칙으로 옮겼나?」

원천 파일에서 팩을 생성한 과정의 단계 · 원값 · 변환값 · 적용 규칙을 표로 기록합니다.

| 단계 | 항목 | 출처 | 원값 | 변환값 | 규칙/기본값 | 경고 |
|---|---|---|---|---|---|---|
| 1단계 메타데이터 1차 입력 | dct:identifier | 데이터키 | 15076635 | 15076635 | 데이터키 그대로 |  |
| 1단계 메타데이터 1차 입력 | 헤더 탐지 | 데이터 파일 | CSV 구분자 ',' | 헤더 1행 · 일치율 1.0 | 정의서 항목명과 일치 비율이 가장 높은 행을 헤더로(CSV 구분자도 같은 방식으로 고름) |  |

9 · context.jsonld · 용어 사전 연결

「AI가 용어를 어떻게 해석하나?」

팩 내 약어(ls:, gr: 등)를 표준 어휘 주소로 변환하는 대응표입니다. 다른 시스템에서도 동일한 의미로 해석할 수 있도록 합니다.

{
  "aird": "http://vocab.datahub.kr/def/aird/",
  "aird-dt": "http://vocab.datahub.kr/def/aird/dataset-type/",
  "ls": "http://vocab.datahub.kr/def/aird/lifecycle-status/",
  "qt": "http://vocab.datahub.kr/def/aird/quality-tier/",
  "gr": "http://vocab.datahub.kr/def/aird/gate-result/",
  "gt": "http://vocab.datahub.kr/def/aird/gate-type/"
}

10 · LICENSE.txt · 이용 조건

「어떤 조건으로 쓸 수 있나?」

원천의 이용허락 · 출처 표시 문구 · 문의처를 기록합니다. AI 학습 등 활용 범위도 이 조건을 따릅니다.

이용허락 — 한국석유공사_알뜰주유소 현황 (데이터별 품질개선 팩 1.0.0)
이용허락 유형: kr-license:KOGL-0 — 이용허락범위 제한 없음
이 팩은 공공데이터포털 원천 데이터(15076635, 제공기관 한국석유공사)의 정제본 · 메타데이터 · 진단 결과를 담는다.
원천의 이용허락 조건을 따르며, 원천 기관의 별도 고지가 있는 경우 그 고지가 우선한다.

준비 단계: 판정(게이트) 통과에 따른 단계

준비 단계는 데이터의 상태를 나타냅니다. 팩 manifest의 aird:lifecycleStatus에 이 값이 기록됩니다. AI Ready에 해당하는 단계는 품질 기준 충족과 목적 적합입니다.

  1. G1 전원시ls:Raw필수 메타데이터 부족 · 사이트에 게시하지 않음
  2. G1 등록 요건 통과준비 중ls:Discoverable필수 메타데이터 18개 · 파일 지문. 품질 판정 보류 또는 기준 미달 · 1,401종
  3. G2 품질 기준 통과품질 기준 충족ls:Quality-Ready공식 판정(DM-2)으로 기준 등급 이상 · 371종
  4. G3 목적 적합 통과목적 적합ls:Purpose-ReadyAI 용도로 구성하여 변환 · 판정 · 5종

AI Ready

G2를 통과하지 못한 경우 판정서(gates/G2)의 gateResult는 gr:FAIL이며, 품질 판정 보류인지 기준 미달인지는 진단 리포트의 진단 성숙도 · 평가 상태로 구분합니다. 기준 문서: AIRD 어휘 v0.10.7.

활용 사례 팩

활용 사례 보기 →

에이전트는 get_pack의 purpose.status로 목적 판정 상태를 확인합니다. 활용 사례 팩 중 검증 완료는 5종입니다.