TRY_COMPLETE
TRY_COMPLETE (SNOWFLAKE.CORTEX)
공지
이 페이지는 하위 호환성을 위해 제공돼요. 새로운 사용 사례에서는 앞으로의 표준 표면인 AI_COMPLETE부터 시작하세요. 이 레거시 함수는 2026년 말까지 폐기될 예정이에요.
TRY_COMPLETE() 함수는 COMPLETE 함수와 같은 작업을 수행하지만, 작업을 수행할 수 없을 때 오류를 일으키는 대신 NULL을 반환해요.
본문
문법
SNOWFLAKE.CORTEX.TRY_COMPLETE( <model>, <prompt_or_history> [ , <options> ] )
인자
필수: model, prompt_or_history
선택: options
반환
options 인자를 지정하지 않으면, 응답을 담은 문자열을 반환해요.
options 인자가 주어지고 이 객체에 response_format 키가 있으면, 지정된 JSON 스키마를 따르는 JSON 객체의 문자열 표현을 반환해요.
options 인자가 주어지고 이 객체에 response_format 키가 없으면, 다음 키를 담은 JSON 객체의 문자열 표현을 반환해요.
"choices": 모델 응답의 배열이에요. (현재는 응답 하나만 제공돼요.) 각 응답은"messages"키를 담은 객체이며, 그 값은 최신 프롬프트에 대한 모델의 응답이에요."created": 응답이 생성된 UNIX 타임스탬프(1970년 1월 1일 자정 이후 초)예요."model": 응답을 생성한 모델의 이름이에요."usage": 이 완성이 소비하고 생성한 토큰 수를 기록하는 객체예요. 다음 하위 키를 포함해요.
접근 제어 요구 사항
사용자는 SNOWFLAKE.CORTEX_USER 데이터베이스 역할이 부여된 역할을 사용해야 해요. 이 권한에 대한 자세한 내용은 Cortex LLM 권한을 참고하세요.
사용 메모
TRY_COMPLETE는 호출 사이의 상태를 유지하지 않아요. TRY_COMPLETE 함수를 사용해 상태가 있는 대화형 경험을 제공하려면 대화의 모든 이전 사용자 프롬프트와 모델 응답을 prompt_or_history 배열의 일부로 전달하세요(채팅 모델용 템플릿 참고). 각 "라운드"마다 처리되는 토큰 수가 늘어나고 비용도 비례해 증가한다는 점을 유의하세요.
법적 고지
Snowflake AI and ML을 참고하세요.