CLASSIFY_TEXT

CLASSIFY_TEXT (SNOWFLAKE.CORTEX) (텍스트 분류)

notice: 이 페이지는 하위 호환성을 위해 제공돼요. 새 사용 사례에서는 앞으로의 표준 표면인 AI_CLASSIFY부터 시작하세요. 이 레거시 함수는 2026년 말까지 더 이상 사용되지 않을(deprecated) 예정이에요.

출처: Snowflake SQL Reference - CLASSIFY_TEXT (SNOWFLAKE.CORTEX)

본문

자유 형식 텍스트(free-form text)를 사용자가 제공하는 범주로 분류해요.

구문

SNOWFLAKE.CORTEX.CLASSIFY_TEXT( <input> , <list_of_categories>, [ <options> ] )

인자

필수:

input

분류할 문자열이에요. 입력 문자열은 대소문자를 구분해요. 대문자 사용이 다른 같은 문자열에 대해 다른 결과를 얻을 수 있어요.

list_of_categories

범주를 나타내는 배열이에요. 최소 2개, 최대 100개의 고유 범주를 포함해야 해요. 범주는 대소문자를 구분해요.

범주는 단순 문자열이거나 SQL 객체일 수 있으며, 모든 범주는 같은 타입이어야 해요. 객체를 사용하면 각 범주의 설명과 예시를 제공해 분류 정확도를 높이는 데 도움이 되는 맥락을 제공할 수 있어요. 각 범주에 설명이나 예시를 제공하는 것은 필수가 아니며, 각 범주에 설명, 예시, 둘 다 또는 둘 다 아닌 것을 자유롭게 제공할 수 있어요.

  • label: 범주의 이름이에요. 이 키는 필수예요.

  • description: 범주의 설명이에요. 설명은 약 25단어(1-2문장)보다 길면 안 돼요. 이 키는 선택 사항이에요.

  • examples: 범주를 대표하는 예시 배열이에요. 보통 다섯 개 이하의 예시면 충분하지만, 범주당 최대 20개의 예시로 제한돼요. 예시 수는 모든 범주에 대해 같을 필요는 없어요. 이 키는 선택 사항이에요.

    참고: 설명과 예시는 입력 토큰으로 계산되어 분류 작업 비용을 높여요. Snowflake Cortex AI 함수는 토큰 수에 따라 계산 비용이 발생…(을)를 참고하세요.

선택:

options

분류 작업에 대한 선택적 구성(키/값 쌍)을 담은 객체예요. 현재 사용 가능한 유일한 키는 다음과 같아요.

  • task_description: 텍스트 분류 작업에 대한 짧은 설명을 담은 문자열이에요. 작업 설명은 약 50단어(3-4문장)보다 길면 안 돼요.

반환 값

OBJECT 값(VARIANT)이에요. 객체의 label 필드는 입력 프롬프트가 속하는 범주를 지정하는 문자열이에요.

접근 제어 요구 사항

사용자는 SNOWFLAKE.CORTEX_USER 데이터베이스 역할이 부여된 역할을 사용해야 해요. 이 권한에 대한 자세한 내용은 Cortex LLM 권한을 참고하세요.

사용 시 참고 사항

최적의 성능을 위해 다음 지침을 따르세요.

  • 입력과 범주에 평이한 영어 텍스트를 사용하세요.

  • 입력 텍스트에서 평이한 영어가 아닌 텍스트의 양을 제한하세요. 예를 들어 코드 조각이나 로그 같은 콘텐츠를 텍스트 입력에서 제한해 보세요.

  • 텍스트에 오픈소스가 아닌 코드나 형식(회사 고유 언어, 독점 형식 등)이 포함되지 않아야 해요. 함수는 오류를 반환하지 않지만 결과가 기대와 다를 수 있어요.

  • 범주 라벨에 약어, 특수 문자 또는 전문 용어를 사용하지 마세요.

  • 범주는 설명적이어야 해요. 예를 들어 Xa4s3 또는 category 1 같은 범주를 사용하면 좋은 결과가 나오지 않아요.

  • 범주는 상호 배타적이어야 해요.

  • 입력 텍스트와 범주 사이의 관계가 모호하거나 미묘할 때 명확한 작업 설명을 추가하면 정확도를 높일 수 있어요.

  • 라벨 설명이 모호하거나 특정 라벨을 선택할 때 특정 논리를 따라야 하는 경우 라벨 설명을 추가하면 정확도를 높일 수 있어요. 설명을 작성할 때 특정 라벨을 다른 라벨과 구분하는 핵심 측면에 집중하세요.

  • 각 라벨, 설명, 예시는 CLASSIFY_TEXT 함수 호출이 처리하는 각 레코드에 대한 입력 토큰으로 계산돼요. 그에 따라 비용이 발생해요.

  • 예시는 정확도 향상에 도움이 될 수 있어요.

더 알아보기