AI_COMPLETE

AI_COMPLETE (단일 이미지)

지원되는 언어 모델을 사용하여 텍스트 프롬프트에 대한 응답(완성)을 생성해요. 이 함수 변형은 문서 이해 기능으로 AI_COMPLETE를 향상시켜요. 프롬프트는 문서를 포함하는 파일에서 찾은 정보나 이미지를 참조할 수 있어요. 함수는 단일 문서 입력을 지원해요.

출처: Snowflake AI_COMPLETE (단일 이미지) 함수 문서

본문

구문 (Syntax)

이 함수는 세 개의 필수 인자와 한 개의 선택 인자가 있어요. 함수는 위치 인자 또는 이름 지정 인자 문법으로 사용할 수 있어요.

단일 이미지 입력으로 AI_COMPLETE 사용:

AI_COMPLETE(
    , 
,  [,  ] )

인자 (Arguments)

  • model — 사용할 모델을 지정하는 문자열이에요. 다음 모델 중 하나를 지정해요:

    • claude-3-7-sonnet
    • claude-4-opus
    • claude-4-sonnet
    • claude-haiku-4-5
    • claude-opus-4-5
    • claude-opus-4-6
    • claude-opus-4-7
    • claude-opus-4-8
    • claude-opus-5
    • claude-sonnet-4-5
    • claude-sonnet-4-6
    • claude-sonnet-5
    • gemini-3.1-pro
    • llama4-maverick
    • llama4-scout
    • openai-gpt-4.1
    • openai-gpt-5
    • openai-gpt-5-chat
    • openai-gpt-5-mini
    • openai-gpt-5-nano
    • openai-gpt-5.1
    • openai-gpt-5.2
    • openai-gpt-5.4
    • pixtral-large

    지원되는 모델은 비용이 다를 수 있어요.

  • predicate — 문자열 프롬프트예요.

  • file — 이미지를 나타내는 FILE 타입 객체예요.

  • model_parameters — 모델의 하이퍼파라미터에 영향을 주는 옵션 0개 이상을 포함하는 객체예요. LLM 설정(LLM Settings) 문서 참고.

    • temperature: 언어 모델 출력의 무작위성을 제어하는 0~1(포함) 값이에요. 더 높은 temperature(예: 0.7)는 더 다양하고 무작위한 출력을, 더 낮은 temperature(예: 0.2)는 더 결정적이고 집중된 출력을 만든다. 기본값: 0
    • top_p: 언어 모델의 무작위성과 다양성을 제어하는 0~1(포함) 값으로, 일반적으로 temperature의 대안으로 사용돼요. 차이는 top_p는 모델이 출력하는 가능한 토큰 집합을 제한하는 반면, temperature는 각 단계에서 어떤 토큰이 선택되는지에 영향을 준다는 것이에요. 기본값: 0
    • max_tokens: 응답에서 출력 토큰의 최대 수를 설정해요. 작은 값은 잘린 응답을 초래할 수 있어요. 기본값: 4096
    • guardrails: Cortex Guard를 사용하여 언어 모델의 잠재적으로 안전하지 않고 유해한 응답을 필터링해요. TRUE 또는 FALSE 중 하나예요. 기본값은 FALSE예요.

반환 값 (Returns)

언어 모델의 문자열 응답을 반환해요.

예제 (Examples)

다음 예제들은 이미지와 함께 AI_COMPLETE 함수의 기본 기능을 보여줘요.

시각적 질문 응답 (Visual question answering)

인플레이션율 차트를 사용해 데이터에 대한 질문에 답해요. (2023년과 2024년 인플레이션율 비교, Statista)

SELECT AI_COMPLETE('claude-sonnet-4-6',
    'Which country will observe the largest inflation change in 2024 compared to 2023?',
    TO_FILE('@myimages', 'highest-inflation.png'));

응답:

Looking at the data, Venezuela will experience the largest change in inflation rates between 2023 and 2024.
The inflation rate in Venezuela is projected to decrease significantly from 337.46% in 2023 to 99.98% in 2024,
representing a reduction of approximately 237.48 percentage points. This is the most dramatic change among
all countries shown in the chart, even though Zimbabwe has higher absolute inflation rates.

이미지에서 엔터티 추출

이 예제는 이미지에서 엔터티(객체)를 추출하고 결과를 JSON 형식으로 반환해요.

SELECT AI_COMPLETE('claude-sonnet-4-6',
    'Extract the kitchen appliances identified in this image. Respond in JSON only with the identified appliances.',
    TO_FILE('@myimages', 'kitchen.png'));

응답:

{
    "appliances": [ "microwave","electric stove","oven","refrigerator" ]
}

이미지 처리 사용 노트 (Usage Notes for Processing Images)

  • 텍스트와 이미지만 지원돼요. 비디오와 오디오 파일은 지원되지 않아요.
  • 지원되는 이미지 형식:
    • .jpg
    • .jpeg
    • .png
    • .gif
    • .webp
    • pixtral 및 llama4 모델은 .bmp도 지원해요.
  • 대부분의 모델에서 최대 이미지 크기는 10MB이고, claude 모델에서는 3.75MB예요. claude 모델은 8000x8000 이상의 해상도 이미지를 지원하지 않아요.
  • 이미지를 포함하는 스테이지에는 서버 측 암호화가 활성화되어 있어야 해요. 클라이언트 측 암호화 스테이지는 지원되지 않아요.
  • 이 함수는 커스텀 네트워크 정책을 지원하지 않아요.
  • 스테이지 이름은 대소문자를 구분하지 않지만, 경로는 대소문자를 구분해요.

참고: AI_COMPLETE는 COMPLETE의 업데이트된 버전이에요. 최신 기능을 위해 AI_COMPLETE를 사용하세요.

법적 고지는 Snowflake AI and ML 문서를 참고해요.

더 알아보기