AI 분류 파일 명세

빠른 시작

YouTube는 이 단계에서 변경되지 않습니다.AI 분류는 내부 속성 후보를 저장할 뿐입니다. 실제 재생목록 변경은 규칙 계산, 미리보기, 사용자 승인, 적용 단계를 거칩니다.

요청 JSON

앱의 exporter가 생성하는 형식입니다. 사용자는 이 구조를 직접 편집할 필요가 없습니다.

값을 결정하는 기준instructions.allowedAttributes는 AI가 사용할 수 있는 속성 키를 제한하고, instructions.userClassificationCriteria는 문자열 속성에 어떤 값을 사용할지 정하는 사용자 기준입니다. AI는 두 값을 가장 먼저 확인하고 사용자 기준을 최우선으로 적용해야 합니다.

{
  "format": "youtube-music-organizer-classification-request",
  "schemaVersion": 1,
  "createdAtMillis": 1799708400000,
  "instructions": {
    "task": "Classify each track only when evidence is sufficient. Use UNKNOWN by omitting uncertain attributes.",
    "allowedAttributes": [
      "contentType",
      "longForm",
      "mood",
      "scene",
      "source",
      "style",
      "vcScope",
      "voice",
      "voicebank"
    ],
    "requiredOutputFormat": "youtube-music-organizer-classification-pack",
    "requiredSchemaVersion": 1,
    "confidenceRange": "0.0..1.0",
    "minimumAcceptedConfidence": 0.9,
    "doNotInventYoutubeIds": true,
    "userClassificationCriteria": "동인 음악은 확인 가능한 서클·앨범·원작 근거가 있을 때만 scene=doujin으로 분류",
    "outputExample": {
      "format": "youtube-music-organizer-classification-pack",
      "schemaVersion": 1,
      "packVersion": "user-1",
      "classifications": [
        {
          "youtubeId": "copy from tracks",
          "attributes": {
            "scene": "doujin",
            "source": "touhou"
          },
          "confidence": 0.95,
          "evidence": [
            "short evidence"
          ]
        }
      ]
    }
  },
  "tracks": [
    {
      "youtubeId": "fake-uni-song",
      "title": "Into the UNIverse",
      "artistChannel": "Sample Producer",
      "durationSeconds": 226,
      "currentPlaylists": [
        "UNI"
      ],
      "note": "동인음악인지 확인"
    }
  ]
}

요청 최상위 키

instructions 하위 키

tracks[] 키

결과 JSON

앱의 importer가 읽는 전체 형식입니다. 실제 파일에는 JSON 앞뒤의 설명이나 Markdown 코드 펜스를 넣지 마세요.

{
  "format": "youtube-music-organizer-classification-pack",
  "schemaVersion": 1,
  "packVersion": "docs-example-1",
  "classifications": [
    {
      "youtubeId": "fake-uni-song",
      "attributes": {
        "voice": "vocal_synth",
        "voicebank": "UNI",
        "scene": "doujin",
        "style": "electronic",
        "source": "original",
        "mood": "bright",
        "contentType": "song",
        "vcScope": true,
        "longForm": false
      },
      "confidence": 0.95,
      "evidence": [
        "사용자 메모와 곡 메타데이터를 함께 확인"
      ]
    }
  ]
}

결과 최상위 키

classifications[] 키

속성/허용 값

현재 validator는 아래 9개 키만 허용합니다. 문자열 속성은 고정 enum이 아니며 사용자의 분류 기준을 따르는 200자 이하 값입니다. 근거가 부족하면 UNKNOWN을 쓰지 말고 해당 키를 생략하세요.

예시 값은 고정 enum이 아닙니다. 문자열 값은 요청 파일의 userClassificationCriteria를 우선해 정하고, 비어 있지 않은 경우에만 저장합니다. 공식 결과 파일에서 vcScope와 longForm은 따옴표 없는 JSON boolean만 사용합니다.

검증 규칙

• 결과 파일은 JSON 객체 하나여야 합니다. 설명문과 ```json 코드 펜스를 포함하지 않습니다.
• format, schemaVersion, packVersion, classifications 이름을 바꾸거나 삭제하지 않습니다.
• 원본 youtubeId를 그대로 사용하고, 요청에 없는 곡을 임의로 추가하지 않습니다.
• confidence는 문자열이 아니라 0.0~1.0 숫자로 작성합니다.
• 허용되지 않은 속성 키를 만들지 않습니다. 문자열 속성은 200자 이하, boolean 속성은 true/false만 사용합니다.
• 확실하지 않은 속성은 생략합니다. 한 결과의 attributes가 완전히 비어 있으면 그 곡 결과 자체를 제외합니다.
• 결과 파일은 10MB 이하, 분류 결과는 최대 20,000곡, 근거는 곡당 최대 20개입니다.

자동 사용 기준: confidence ≥ 0.90. 0.90 미만 결과도 가져오지만 RuleEngine에는 즉시 사용하지 않고 사용자 검토 대상으로 남깁니다. 사용자가 승인하면 신뢰도 1.0으로 저장됩니다.

AI 분류 지침

• 곡 하나에 여러 속성이 동시에 존재할 수 있습니다. 속성 하나만 고르는 단일 분류 문제가 아닙니다.
• 태그/내부 속성과 실제 YouTube 재생목록은 다른 개념입니다. 분류 결과 JSON에는 재생목록 변경을 넣지 않습니다.
• currentPlaylists는 중요한 힌트지만 절대적인 정답은 아닙니다.
• 사용자 메모와 userClassificationCriteria를 우선합니다.
• 확실하지 않으면 억지로 추측하지 않고 해당 속성을 생략하며 confidence를 과장하지 않습니다.
• longForm이나 Minor III 같은 관리 개념을 일반 음악 장르와 혼동하지 않습니다. Minor III는 속성이 아니라 사용자 재생목록 이름일 수 있습니다.
• 한 곡은 여러 재생목록에 중복 배치될 수 있습니다.
• AI가 기존 YouTube 재생목록에서 곡을 자동 제거한다고 가정하지 않습니다. 자동 제거는 이 앱의 기본 동작이 아닙니다.

규칙 제작 지침

현재 앱은 규칙 JSON 가져오기를 지원하지 않습니다. AI가 규칙을 제안할 때는 아래 실제 Rule Builder 항목만 사용하고, 사용자가 앱 화면에 입력할 수 있는 형태로 설명해야 합니다.

조건 모델

실행 모델

지원되는 규칙 예시

사용자 직접 규칙은 자동 분류 추론보다 우선합니다. 같은 우선순위에서는 차단 결과가 추가 결과보다 우선합니다.

AI에게 이 지침을 함께 전달하세요

오류 해결