Snowflake 데이터 Clean Rooms 에이전트를 소개해요

현재 these regions에서 사용할 수 있습니다.

정부 및 VPS 배포에서는 사용할 수 없습니다.

출처: 문서

본문

개요

Snowflake Data Clean Room(DCR) 에이전트는 Snowflake CoWork에서 대화형 인터페이스를 제공하여 데이터 Clean Room을 비즈니스 사용자와 비기술 사용자도 직관적으로 쉽게 사용할 수 있게 해요. 승인된 분석을 간편하게 실행하고 결과를 이해하기 쉬운 형식으로 제공하는 주요 워크플로를 지원합니다.

에이전트는 현재 다음 Snowflake Data Clean Rooms 템플릿을 지원해요:

Audience Overlap: 두 데이터 세트 간에 겹치는 레코드 수를 측정하는 템플릿이에요.
Audience Overlap Activation: 겹치는 레코드 목록과 해당 속성을 생성하고 승인된 계정으로 내보내는 템플릿이에요.

이 시나리오의 협업 역할, 샘플 데이터, 설정 노트북은 Overlap and activation을 참조하세요. 노트북은 공개 DCR 샘플 데이터 세트의 데이터를 기반으로 샘플 데이터 세트를 생성해요.

에이전트는 LLM으로 Claude Sonnet 4.6을 사용해요.

지원되는 흐름

DCR 에이전트는 현재 협업에서 다음 작업을 수행할 수 있어요:

협업에 참여하기.
협업의 상태, 템플릿, 데이터 제공 항목을 포함한 협업 정보 보기.
협업에서 오디언스 오버랩 분석 실행하기.
오버랩 분석 결과 데이터 활성화하기.
이 계정에서 에이전트를 사용해 실행한 모든 분석의 분석 기록 보기.

요구 사항

API 버전 15.6 이상을 사용 중인지 확인하세요.
이 항목에서 Agent setup 및 Access requirements를 완료하세요.

에이전트 설정

계정에서 다음 SQL을 실행하여 에이전트 기능을 활성화하세요:

-- Enable cross-region inference.
USE ROLE ACCOUNTADMIN;
ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'AWS_US';

-- Ensure DCR application has the appropriate grants via caller.
GRANT CALLER FULL MANAGEMENT ON ACCOUNT TO APPLICATION SAMOOHA_BY_SNOWFLAKE;

사용자가 Snowflake CoWork 인터페이스에서 DCR 에이전트에 액세스할 수 있도록 DCR 에이전트를 Snowflake CoWork에 등록하세요:

USE ROLE ACCOUNTADMIN;
CREATE SNOWFLAKE INTELLIGENCE IF NOT EXISTS SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT;
ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT
  ADD AGENT SAMOOHA_BY_SNOWFLAKE.AGENTS.SNOWFLAKE_DCR_AGENT;

액세스 요구 사항

DCR 에이전트와 Data Clean Rooms 권한은 별도로 관리돼요. 에이전트를 사용하려면 에이전트와 협업 모두에 대한 권한이 필요해요. 다음과 같이 적절한 권한을 부여하세요:

역할에 DCR 에이전트를 사용하고 Snowflake CoWork에서 액세스할 수 있는 권한을 부여하세요:

USE ROLE ACCOUNTADMIN;
GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT
  TO ROLE <your role name>;
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE(
  'USE DCR AGENT',
  '<your role name>'
);

GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE을 호출하여 역할에 협업에서 분석을 실행할 수 있는 권한을 부여하세요:

USE ROLE ACCOUNTADMIN;
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE(
  'RUN',
  'COLLABORATION',
  '<collaboration name>',
  '<your role name>'
);

참고

SAMOOHA_APP_ROLE에는 Snowflake Data Clean Room 에이전트를 사용하기 위해 USE DCR AGENT 권한이 별도로 부여되어 있어야 해요.

사용법

협업을 설정한 후 에이전트를 사용하여 분석을 실행하고 결과를 활성화하세요. 에이전트에 액세스하는 방법은 두 가지가 있어요:

Snowsight에 로그인하고 탐색 메뉴에서 AI & ML » Snowflake CoWork를 선택하세요.
https://ai.snowflake.com/로 직접 이동하세요.

참고

역할에 협업에 참여하는 데 필요한 모든 권한이 있으면 에이전트에게 계정이 초대된 현재 협업에 참여하도록 요청할 수도 있어요. 추가해야 할 데이터 제공 항목이 있다면 Collaboration API 또는 Snowsight UI를 통해 수행해야 해요.

분석 실행 및 결과 활성화

Snowflake CoWork에서 에이전트에게 참여한 협업에서 분석을 실행하도록 요청하세요. 에이전트에게 수행할 수 있는 작업, 사용 가능한 데이터, 사용 가능한 템플릿, 기타 상황별 질문을 물어볼 수도 있어요.

협업에서 활성화가 활성화된 경우 에이전트에게 분석 결과를 협업에서 사용 가능한 대상으로 활성화하도록 요청할 수 있어요.

분석 결과 저장

에이전트에게 저장할 분석 이름을 지정하여 오버랩 분석 결과를 저장하도록 요청하세요. 나중에 저장된 분석을 이름으로 나열하거나 가져올 수 있어요.

Snowflake 데이터 Clean Rooms 에이전트를 소개해요