기본 모델 설정 구성하기

Snowflake 계정 관리자는 settings 에이전트(agent)를 만들어 모든 Cortex Code 사용자의 기본 모델을 설정할 수 있어요. settings 에이전트는 CORTEX_CODE.CONFIG의 스키마 수준 객체로, Cortex Code가 세션 시작 시 읽어 계정 전체 모델 설정을 적용해요.

출처: Configure default model settings

본문

이 항목에서는 settings 에이전트를 만들고, 기본 모델을 구성하고, 사용자에게 접근을 부여하는 방법을 설명해요.

사전 요구 사항

기본 모델 설정을 구성하기 전에 다음을 확인하세요.

ACCOUNTADMIN 역할이 있어요. CORTEX_CODE 데이터베이스에서 에이전트 객체를 만들고 수정하는 데 필요해요.
계정에서 크로스 리전 추론(cross-region inference)이 활성화되어 있어요. 크로스 리전 추론 활성화를 참고하세요.

데이터베이스와 스키마 만들기

CORTEX_CODE 데이터베이스는 자동으로 생성되지 않아요. ACCOUNTADMIN 역할을 사용해 계정당 한 번 만들어요.

USE ROLE ACCOUNTADMIN;

CREATE DATABASE IF NOT EXISTS CORTEX_CODE;
CREATE SCHEMA IF NOT EXISTS CORTEX_CODE.CONFIG;

계정에 CORTEX_CODE 데이터베이스가 이미 있으면 이 단계를 건너뛰어요.

이 단계를 건너뛰면 다음 섹션에서 settings 에이전트를 만들 때 다음 오류로 실패해요.

002003 (42S02): SQL compilation error:
Database 'CORTEX_CODE' does not exist or not authorized.

settings 에이전트 만들기

settings 에이전트는 CORTEX_CODE.CONFIG 스키마의 AGENT 객체예요. Cortex Code는 이 객체를 세션 시작 시 읽고 구성된 설정을 적용해요. 현재 models.orchestration이 유일하게 지원되는 설정 키이며, 사양의 다른 키는 무시돼요.

참고 settings 에이전트는 모델 선택만 제어해요. 플랜 모드 같은 다른 세션 동작은 계정 전체 기본값으로 설정할 수 없고 세션별로 제어돼요. 플랜 모드를 활성화하려면 /plan 명령을 사용하거나 Ctrl-P를 눌러요. 자세한 내용은 에이전트 모드와 플랜 모드를 참고하세요.

기본 settings 에이전트를 만들려면 ACCOUNTADMIN으로 다음을 실행해요.

USE ROLE ACCOUNTADMIN;

CREATE OR REPLACE AGENT CORTEX_CODE.CONFIG.DEFAULT
  FROM SPECIFICATION
  $$
  models:
    orchestration: auto
  $$;

이렇게 하면 권장 모델 설정인 auto를 사용하는 settings 에이전트가 만들어져요. auto를 사용하면 Snowflake가 자동으로 기본 모델을 선택해요. 현재는 고정 기본 모델에 매핑되며, 동적 모델 선택은 활발히 개발 중이에요.

대신 특정 모델을 고정하려면 auto를 모델 식별자로 바꾸세요.

models:
  orchestration: claude-opus-4-7

사용자에게 접근 부여하기

이 설정을 받아야 하는 사용자의 각 역할에 settings 에이전트에 대한 USAGE를 부여해요.

GRANT USAGE ON DATABASE CORTEX_CODE TO ROLE <role_name>;
GRANT USAGE ON SCHEMA CORTEX_CODE.CONFIG TO ROLE <role_name>;
GRANT USAGE ON AGENT CORTEX_CODE.CONFIG.DEFAULT TO ROLE <role_name>;

Cortex Code는 활성 역할이 해당 에이전트에 USAGE가 있는 모든 사용자에게 에이전트 객체의 설정을 적용해요.

계정의 모든 사용자에게 설정을 적용하려면 모든 사용자에게 자동으로 부여되는 PUBLIC 역할에 USAGE를 부여해요.

GRANT USAGE ON DATABASE CORTEX_CODE TO ROLE PUBLIC;
GRANT USAGE ON SCHEMA CORTEX_CODE.CONFIG TO ROLE PUBLIC;
GRANT USAGE ON AGENT CORTEX_CODE.CONFIG.DEFAULT TO ROLE PUBLIC;

에이전트 설정 업데이트하기

초기 설정 후 기본 모델을 변경하려면:

ALTER AGENT CORTEX_CODE.CONFIG.DEFAULT
  FROM SPECIFICATION
  $$
  models:
    orchestration: claude-opus-4-7
  $$;

주의 설정은 세션 시작 시 적용돼요. 정확한 동작은 표면마다 다를 수 있으며 변경될 수 있어요.

사용 가능한 모델

orchestration을 지원되는 Cortex 모델 식별자로 설정해요. auto(권장)를 사용해 Snowflake가 적절한 모델을 자동으로 선택하게 해요.

사용 가능한 모델 식별자, 컨텍스트 창, 리전별 가용성은 크로스 리전 추론 문서를 참고하세요.

크로스 리전 추론 활성화하기

Cortex Code가 작동하려면 크로스 리전 추론이 필요해요. 필요한 모델이 있는 리전으로 모델 요청을 라우팅해요.

크로스 리전 추론은 기본적으로 비활성화되어 있어요. ACCOUNTADMIN이 활성화해야 해요.

-- Requires ACCOUNTADMIN role
ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'ANY_REGION';

orchestration이 auto로 설정되면 Snowflake는 크로스 리전 추론을 사용해 사용 가능한 모델을 자동으로 선택해요.

기본 모델 설정 구성하기