Cortex Agents 와 시맨틱 뷰 (Cortex Analyst 에서 에이전트로)

전체 그림

시맨틱 뷰

시맨틱 뷰는 "매출" 이 어떤 테이블의 어떤 식인지, "지역" 이 어느 열인지를 데이터베이스 객체로 정의합니다. 예전에는 YAML 시맨틱 모델 파일을 스테이지에 올렸지만, 지금은 시맨틱 뷰가 기본입니다.

CREATE OR REPLACE SEMANTIC VIEW sales.sv_revenue
  TABLES (
    o AS sales.orders    PRIMARY KEY (order_id) COMMENT = '주문',
    c AS sales.customers PRIMARY KEY (customer_id)
  )
  RELATIONSHIPS ( o (customer_id) REFERENCES c )
  FACTS ( o.amount AS amount )
  DIMENSIONS (
    c.country    AS country    WITH SYNONYMS = ('국가', '나라'),
    o.order_date AS order_date COMMENT = '주문일'
  )
  METRICS ( o.revenue AS SUM(o.amount) COMMENT = '결제 완료 매출 합계' )
  COMMENT = '매출 분석용 시맨틱 뷰';

-- SQL 로 직접 질의
SELECT * FROM SEMANTIC_VIEW(sales.sv_revenue
  DIMENSIONS c.country METRICS o.revenue)
ORDER BY revenue DESC;

• 2026년 3월부터 일반 SQL 절로 시맨틱 뷰를 질의하는 것이 GA, 4월에 검증된 질의(verified queries) 를 시맨틱 뷰 안에 저장할 수 있고, 6월에 SQL 질의를 논리 테이블로 쓰는 기능과 변수 지원이 GA 가 되었습니다.
• 2026년 2월 Semantic View Autopilot 이 GA 가 되어 쿼리 기록과 BI 정의에서 시맨틱 뷰 초안을 자동으로 만들고, 8월에는 Power BI 정의를 가져오는 기능이 GA 가 되었습니다. 9월 30일에는 시맨틱 뷰를 만들고 다듬는 Semantic Studio 가 GA 가 되었습니다.
• 시맨틱 뷰는 리스팅으로 공유할 수 있고 계정 복제도 지원합니다.

팁 정확도의 대부분은 시맨틱 뷰 품질에서 나옵니다. 지표 정의, 동의어, 자주 묻는 질문의 검증된 질의를 채우는 데 시간을 쓰세요. 열 이름만 늘어놓은 시맨틱 뷰는 정확도가 낮습니다.

Cortex Analyst 에서 Agents 로

2026년 8월 28일 Snowflake 는 Cortex Analyst 를 단독으로 부르기보다 Cortex Agents 로 옮기라고 권장했습니다. 폐기는 아니고 Cortex Analyst REST API 와 기존 앱은 계속 동작합니다.

옮길 때 시맨틱 뷰와 검증된 질의는 그대로 씁니다. 바뀌는 것은 호출 방식뿐입니다.

에이전트 객체 만들기

에이전트는 스키마 안의 AGENT 객체입니다. 아래는 구조를 보여 주는 개략 예시이고, 사양 키 이름은 공식 CREATE AGENT 문서를 따릅니다.

CREATE OR REPLACE AGENT sales.agents.sales_ai
  COMMENT = '매출과 고객 문의를 함께 답하는 에이전트'
  PROFILE = '{"display_name": "Sales AI"}'
  FROM SPECIFICATION
  $$
  instructions:
    response: "한국어로 답하고, 숫자는 표로, 근거 데이터를 밝힌다"
    orchestration: "매출 질문은 revenue 도구, 고객 불만은 tickets 도구를 쓴다"
  tools:
    - tool_spec: { type: "cortex_analyst_text_to_sql", name: "revenue" }
    - tool_spec: { type: "cortex_search", name: "tickets" }
  tool_resources:
    revenue: { semantic_view: "sales.sv_revenue", execution_environment: { type: "warehouse", warehouse: "AGENT_WH" } }
    tickets: { name: "support.ticket_search", max_results: 5 }
  $$;

GRANT USAGE ON AGENT sales.agents.sales_ai TO ROLE sales_team;

• 에이전트는 질문한 사용자의 역할 권한으로 도구를 실행합니다. 사용자가 원래 못 보는 데이터는 에이전트도 못 봅니다. 마스킹과 행 접근 정책도 그대로 적용됩니다.
• 2026년 8월 비동기 API 와 Coding Agent, 10월 코드 실행 도구가 GA 가 되었고, 10월 13일 Cortex Agent SDK 가 PuPr 로 나왔습니다.
• 2026년 9월 GA 가 된 Restricted Session Scope 로 에이전트가 쓸 수 있는 세션 범위를 좁힐 수 있습니다.

MCP 와 외부 연결

• Snowflake 관리형 MCP 서버(2025-11-04 GA)를 만들면 MCP 를 지원하는 외부 AI 도구가 Cortex Analyst, Cortex Search, 에이전트를 도구로 씁니다. 2026년 7월 외부 OAuth 와 범위(scope) 설정이 GA 가 되었습니다.
• Microsoft Teams 와 Copilot 연동이 2025년 11월 GA 입니다.
• 2026 Summit 에서 기업용 MCP 플랫폼 Natoma 인수가 발표되었습니다.

평가와 관찰

• Cortex Agent evaluations (2026-03 GA) 로 질문 세트에 대한 답의 정확도, 도구 선택을 점수로 봅니다. 2026년 8월 에이전트와 Analyst 평가에서 버전 지정이 GA 가 되었습니다.
• 대화 기록과 도구 호출 추적은 AI Observability 화면과 이벤트 테이블에서 봅니다.
• 비용은 CORTEX_AGENT_USAGE_HISTORY (2026-02 GA) 와 CORTEX_ANALYST_USAGE_HISTORY 로 봅니다.

비용

2026년 3월부터 에이전트와 CoWork 에 리소스 예산을 걸 수 있고, 사용자별 AI 한도(2026-08 GA)로 한 사람이 쓰는 양을 막을 수 있습니다.

보안 요점

• 2026년 4월 GA 가 된 Cortex AI Guardrails 는 프롬프트 인젝션과 탈옥 시도를 탐지하고 막습니다. 5월부터 CoWork 와 Agents 에도 적용됩니다.
• 2026 Summit 에서 에이전트에 검증된 신원을 주는 Agent Identity 가 발표되었고, 7월에 SERVICE_AGENT 사용자 유형이 GA 가 되었습니다.
• ACCESS_HISTORY 의 agents_info 열(2026-08)과 QUERY_HISTORY 의 agent_type 열(2026-07)로 에이전트가 낸 쿼리를 구분해 감사할 수 있습니다.

트러블슈팅

• 증상: 에이전트가 숫자를 틀리게 답합니다.

• 원인: 시맨틱 뷰의 지표 정의가 모호하거나, 같은 뜻의 열이 여러 개라 잘못 고릅니다.

• 해결: 지표에 주석과 동의어를 달고, 틀린 질문은 검증된 질의로 등록합니다. 평가 세트로 개선 전후를 비교합니다.

• 증상: 어떤 사용자는 답을 받는데 다른 사용자는 "권한 없음" 이 나옵니다.

• 원인: 에이전트는 사용자 역할로 실행하므로, 그 사용자의 기본 역할에 시맨틱 뷰, 원본 테이블, 검색 서비스, 웨어하우스 권한이 없습니다.

• 해결: 기본 역할과 기본 웨어하우스를 정하고, 필요한 USAGE, SELECT, REFERENCES 를 역할에 줍니다.

공식 문서

• Cortex Agents
• Semantic views
• Transition from Cortex Analyst to Cortex Agents (release note)
• Snowflake-managed MCP server