목록 및 공유를 위한 자동 데이터 에이전트¶
자동 데이터 에이전트는 데이터 목록 및 공유에 대한 AI 기반 에이전트와 의미 체계 뷰를 즉시 생성하여 정적 데이터를 기술적인 전문 지식 없이도 최종 사용자가 자연어를 사용해 데이터를 쿼리할 수 있는 지능적인 대화 환경으로 변환합니다.
자동 데이터 에이전트 이해¶
전통적으로, Snowflake 목록과 공유는 컨슈머가 기본 스키마를 이해하고 SQL 쿼리를 작성하여 데이터를 추출해야 합니다. 자동 데이터 에이전트는 목록 메타데이터와 데이터 스키마를 분석하여 다음 오브젝트를 자동으로 구성해 이러한 장벽을 해결합니다.
의미 체계 뷰: Cortex Analyst와 호환되는 비즈니스 친화적인 데이터 표현입니다.
Cortex Agent: 데이터의 특정 도메인과 컨텍스트를 이해하는 AI 오케스트레이션 계층입니다.
공급자로서 이러한 자동화는 “Cortex AI 지원” 목록을 만들거나 공유하는 데 필요한 시간을 크게 줄여 수동 엔지니어링 없이 대화형 데이터 환경을 제공할 수 있게 해줍니다. 이러한 오브젝트가 생성된 후 목록 또는 공유에 첨부하기만 하면 고객과 최종 컨슈머가 Cortex AI 제품 및 기능을 사용하여 데이터와 쉽게 상호 작용할 수 있습니다.
팁
Cortex AI 지원 목록을 생성할 때 Cortex AI ready 카테고리를 목록에 추가합니다. 이 카테고리를 사용하면 컨슈머가 목록을 더 쉽게 찾을 수 있습니다.
자동 데이터 에이전트의 주요 기능¶
원클릭 생성 은 기존 메타데이터 및 테이블 구조를 기반으로 에이전트와 의미 체계 오브젝트를 모두 자동으로 생성합니다.
테이블 및 뷰 선택 을 사용하면 의미 체계를 생성할 때 포함할 테이블과 뷰를 선택할 수 있으므로 에이전트를 통해 노출되는 데이터를 제어할 수 있습니다.
AI 기반 의미 체계 모델링 은 의미 체계 뷰 Autopilot 을 사용하여 테이블 관계, 메트릭 및 차원을 식별합니다.
동적 에이전트 지침 은 목록 메타데이터에서 파생된 컨텍스트 인식 가상 및 오케스트레이션 지침을 생성합니다. (직접 공유의 경우 정적 명령이 사용됩니다.)
공급자는 통합 테스트 를 통해 에이전트의 응답을 확인한 후 컨슈머에게 게시할 수 있습니다.
원활한 게시 는 생성된 자산을 기존 보안 공유에 직접 첨부하여 컨슈머가 즉시 사용할 수 있도록 합니다.
고려 사항¶
테이블이나 뷰가 포함된 새 목록/기존 목록 또는 공유에 대한 AI 기능을 빠르게 활성화하려면 자동 데이터 에이전트를 사용합니다.
이 기능은 다음 기준을 충족하는 목록과 공유에 가장 적합합니다.
데이터 구조는 테이블이나 뷰에 잘 정의되어 있습니다.
목록의 경우 목록 설명이 데이터 도메인을 명확하게 설명합니다. (이를 통해 AI에서 생성된 지침이 개선됩니다.)
공유에 수동으로 첨부된 기존 의미 체계 또는 에이전트가 없습니다.
제한 사항¶
재생성: 에이전트를 재생성하면 기존 에이전트 및 의미 체계 뷰 오브젝트가 바뀝니다. 이전 버전은 보존되지 않습니다.
오브젝트 위치: 생성된 에이전트와 의미 체계 뷰는 공유 콘텐츠와 동일한 데이터베이스에 저장해야 합니다.
독점 생성: 공유에 에이전트, 의미 체계 뷰 또는 Cortex Search Services가 이미 포함되어 있으면 이 기능을 사용할 수 없습니다.
생성 시간: 이 프로세스는 공유 스키마의 복잡성과 크기에 따라 최대 10분이 걸릴 수 있습니다.
공급자로서 자동 데이터 에이전트 사용하기¶
자동 데이터 에이전트를 사용하면 목록 및 공유에 대한 AI 에이전트를 Provider Studio 내에서(공개 및 비공개 Snowflake Marketplace 목록의 경우), Internal Sharing 내에서(내부 마켓플레이스 목록의 경우) 또는 External sharing 페이지에서(목록 없이 직접 공유의 경우) 직접 구성, 테스트, 관리할 수 있습니다.
필수 권한¶
자동 데이터 에이전트를 생성, 편집, 관리하려면 다음 권한이 필요합니다.
오브젝트 생성에 필요한 권한(에이전트 생성)¶
권한 |
오브젝트 |
목적 |
|---|---|---|
CORTEX_USER |
데이터베이스 |
사용자가 Snowflake AI 함수를 호출하고 LLMs를 사용하여 의미 체계 뷰를 생성할 수 있는 권한을 포함합니다. 기본적으로 CORTEX_USER 역할은 PUBLIC 역할에 부여됩니다. |
CREATE SEMANTIC VIEW |
스키마 |
새 의미 체계 뷰를 생성하는 데 필요합니다. |
CREATE AGENT |
스키마 |
Cortex Agent를 생성하는 데 필요합니다. |
SELECT |
공유의 테이블/뷰 |
의미 체계 뷰 정의에 사용되는 모든 테이블 또는 뷰에 필요합니다. |
USAGE |
데이터베이스 |
공유 오브젝트가 포함된 데이터베이스에 액세스하는 데 필요합니다. |
USAGE |
스키마 |
오브젝트가 생성될 대상 스키마에 액세스하는 데 필요합니다. |
참고
의미 체계 뷰를 생성하는 동안에는 테이블에 대한 SELECT 권한이 필요합니다. 그러나 나중에 의미 체계 뷰를 쿼리하려면 의미 체계 뷰 자체에 대한 SELECT 권한만 필요합니다.
공유에 오브젝트를 추가하는 데 필요한 권한(게시)¶
권한 |
오브젝트 |
목적 |
|---|---|---|
OWNERSHIP |
공유 |
오브젝트에 대한 권한을 공유에 부여하는 데 필요합니다. |
OWNERSHIP 또는 MODIFY |
목록 |
목록을 수정하고 승인을 위해 제출하는 데 필요합니다(목록을 사용하는 경우에만 적용 가능). |
공유에 오브젝트를 추가하면 다음 권한이 자동으로 부여됩니다.
GRANT USAGE ON AGENT ... TO SHAREGRANT SELECT ON SEMANTIC VIEW ... TO SHAREGRANT REFERENCES ON SEMANTIC VIEW ... TO SHARE
오브젝트 관리에 필요한 권한(재생성/삭제)¶
권한 |
오브젝트 |
목적 |
|---|---|---|
OWNERSHIP |
에이전트 |
에이전트를 삭제하거나 교체하는 데 필요합니다(생성자에게 자동으로 부여됨). |
OWNERSHIP |
시맨틱 뷰 |
의미 체계 뷰를 삭제하거나 대체하는 데 필요합니다(생성자에게 자동으로 부여됨). |
자동 데이터 에이전트 워크플로¶
자동 데이터 에이전트 시작¶
공급자의 경우 자동 데이터 에이전트 설정 프로세스에서 목록 또는 공유를 분석하고 필요한 Cortex AI 오브젝트를 생성합니다. 자동 데이터 에이전트를 Snowflake Marketplace 목록, Internal Marketplace 목록(조직) 또는 직접 공유와 함께 사용할 수 있습니다. 자동 데이터 에이전트를 시작하려면 먼저 모든 필수 정보 를 제공해야 합니다.
아래 예제에서는 Snowflake Marketplace 목록, Internal Marketplace 목록 또는 직접 공유에 자동 데이터 에이전트를 구성하는 방법을 설명합니다. 적절한 옵션을 선택합니다.
참고
자동 생성 마법사는 Snowsight 에서만 사용할 수 있습니다.
옵션 1. Snowflake Marketplace 목록에서 자동 데이터 에이전트 시작¶
아래 단계에서는 이미 Snowflake Marketplace 목록을 생성하고 데이터 제품에 첨부했다고 가정합니다. 자세한 내용은 목록 만들기 및 게시하기 섹션을 참조하십시오.
Snowsight 에 로그인합니다.
탐색 메뉴에서 Marketplace » Provider Studio 를 선택합니다.
Listings 탭에서 구성하려는 공개 목록을 선택합니다.
목록의 Secure share 탭에 있는 Add an Agent to your listing 배너에서 Get started 를 선택합니다.
참고
목록에는 첨부된 공유가 있어야 합니다. 그렇지 않은 경우 Secure share 탭을 사용할 수 없습니다. 목록에는 모든 필수 정보도 포함되어야 합니다. 그렇지 않은 경우 Get started 버튼이 비활성화됩니다.
구성 대화 상자에 다음 값을 입력합니다.
Agent Display Name: 에이전트의 이름을 입력합니다(기본값은 목록 제목).
Location: 생성된 오브젝트의 대상 스키마를 선택합니다.
Tables/Views: 의미 체계 뷰에 포함할 테이블과 뷰를 선택합니다. 공유에서 사용 가능한 테이블과 뷰의 하위 세트를 선택하여 에이전트가 액세스할 수 있는 데이터를 제어할 수 있습니다.
참고
이 스키마는 공유 데이터와 동일한 데이터베이스에 있어야 합니다.
Create 를 선택합니다.
생성 프로세스가 즉시 시작됩니다. 메타데이터 검색, 의미 체계 뷰 생성, 에이전트 생성 등 각 단계의 상태를 확인할 수 있습니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다.
옵션 2. Internal Marketplace 목록에서 자동 데이터 에이전트 시작¶
아래 단계에서는 이미 Internal Marketplace 목록을 생성하고 데이터 제품에 첨부했다고 가정합니다. 자세한 내용은 조직 목록 만들기 섹션을 참조하십시오.
Snowsight 에 로그인합니다.
탐색 메뉴에서 Data sharing » Internal sharing 를 선택합니다.
Internal sharing 페이지에서 구성하려는 목록을 선택합니다.
목록의 Secure share 탭에 있는 Add an Agent to your listing 배너에서 Get started 를 선택합니다.
참고
목록에는 첨부된 공유가 있어야 합니다. 그렇지 않은 경우 Secure share 탭을 사용할 수 없습니다. 목록에는 모든 필수 정보도 포함되어야 합니다. 그렇지 않은 경우 Get started 버튼이 비활성화됩니다.
구성 대화 상자에 다음 값을 입력합니다.
Agent Display Name: 에이전트의 이름을 입력합니다(기본값은 목록 제목).
Location: 생성된 오브젝트의 대상 스키마를 선택합니다.
Tables/Views: 의미 체계 뷰에 포함할 테이블과 뷰를 선택합니다. 공유에서 사용 가능한 테이블과 뷰의 하위 세트를 선택하여 에이전트가 액세스할 수 있는 데이터를 제어할 수 있습니다.
참고
이 스키마는 공유 데이터와 동일한 데이터베이스에 있어야 합니다.
Create 를 선택합니다.
생성 프로세스가 즉시 시작됩니다. 메타데이터 검색, 의미 체계 뷰 생성, 에이전트 생성 등 각 단계의 상태를 확인할 수 있습니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다.
옵션 3. 직접 공유에서 자동 데이터 에이전트 시작¶
목록과 연결되지 않은 직접 공유에 대한 자동 데이터 에이전트를 생성할 수도 있습니다.
Snowsight 에 로그인합니다.
탐색 메뉴에서 Data sharing » External sharing 를 선택합니다.
Shared by your account 탭에서 구성하려는 공유를 선택합니다.
Add an Agent to your share 배너에서 Get started 를 선택합니다.
구성 대화 상자에 다음 값을 입력합니다.
Agent Display Name: 앱의 이름을 입력합니다.
Location: 생성된 오브젝트의 대상 스키마를 선택합니다.
Tables/Views: 의미 체계 뷰에 포함할 테이블과 뷰를 선택합니다. 공유에서 사용 가능한 테이블과 뷰의 하위 세트를 선택하여 에이전트가 액세스할 수 있는 데이터를 제어할 수 있습니다.
참고
이 스키마는 공유 데이터와 동일한 데이터베이스에 있어야 합니다.
Create 를 선택합니다.
생성 프로세스가 즉시 시작됩니다. 메타데이터 검색, 의미 체계 뷰 생성, 에이전트 생성 등 각 단계의 상태를 확인할 수 있습니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다.
SQL을 사용하여 생성된 오브젝트 확인¶
SQL을 사용하여 생성된 오브젝트를 확인할 수 있습니다.
-- Verify the agent was created SHOW AGENTS IN SCHEMA my_database.my_schema; -- Verify the semantic view was created SHOW SEMANTIC VIEWS IN SCHEMA my_database.my_schema;
데이터 에이전트 테스트¶
게시하기 전에 에이전트가 데이터에 대한 질문에 정확하게 답변하는지 확인합니다.
목록 또는 공유의 Agent 섹션에서 생성된 에이전트를 찾습니다.
사용 가능한 Try 버튼 중 하나를 선택하여 Cortex Studio를 엽니다.
에이전트 응답을 테스트하거나 의미 체계 뷰의 유효성을 검사할 수 있습니다.
데이터와 관련된 자연어 쿼리를 입력합니다(예: “지난 달 평균 판매량?”).
생성된 SQL 및 텍스트 응답이 정확한지 검토합니다.
조정이 필요한 경우 의미 체계 뷰를 수동으로 편집하거나 목록 설명을 업데이트한 후 에이전트를 다시 생성합니다.
데이터 에이전트 관리¶
에이전트 재생성¶
데이터 스키마가 변경되거나 에이전트의 컨텍스트를 개선하기 위해 목록 설명을 업데이트하는 경우 에이전트를 재생성할 수 있습니다.
조심
재생성은 기존 에이전트 및 의미 체계 뷰를 삭제하고 새 버전을 생성합니다. 이전 의미 체계 뷰에 대한 모든 수동 편집 내용은 손실됩니다.
More actions (…) 메뉴의 Agent 섹션에서 Regenerate agent 를 선택합니다.
작업을 확인하여 프로세스를 시작합니다.
에이전트 삭제¶
공유에 첨부되지 않은 에이전트를 삭제할 수 있습니다. 삭제하려는 에이전트가 공유에 첨부된 경우 해당 에이전트를 공유에서 제거해야 삭제할 수 있습니다.
Agent 섹션에서 More actions (…) 메뉴를 선택합니다.
Drop agent 를 선택합니다.
확인한 후 계정에서 에이전트와 의미 체계 뷰를 모두 제거합니다.
목록 또는 공유에 자동 데이터 에이전트 첨부¶
컨슈머가 에이전트를 사용할 수 있도록 하려면 에이전트를 보안 공유에 첨부합니다.
컨슈머로 자동 데이터 에이전트 사용¶
컨슈머는 자동 데이터 에이전트를 사용하여 자연어를 통해 데이터를 쿼리할 수 있습니다.
Snowflake Marketplace 목록의 경우 다음 단계를 따릅니다.
Snowsight 에 로그인합니다.
탐색 메뉴에서 Marketplace » Snowflake Marketplace 를 선택합니다.
액세스하려는 Cortex AI 지원 목록을 선택하고, 목록이 아직 없는 경우 목록에 Get 을 수행합니다.
Open 을 선택한 후 에이전트 이름을 선택하여 에이전트를 테스트합니다.
Internal Marketplace 목록의 경우 다음 단계를 따릅니다.
Snowsight 에 로그인합니다.
탐색 메뉴에서 Catalog » Internal Marketplace 를 선택합니다.
액세스하려는 Cortex AI 지원 목록을 선택하고, 목록이 아직 없는 경우 목록에 Get 을 수행합니다.
Open 을 선택한 후 에이전트 이름을 선택하여 에이전트를 테스트합니다.
비공개로 공유된 목록의 경우 다음 단계를 따릅니다.
Snowsight 에 로그인합니다.
탐색 메뉴에서 Data sharing » External sharing 를 선택합니다.
Shared with you 탭에서 액세스하려는 Cortex AI 지원 목록 또는 공유를 선택하고 아직 없는 경우 Get 을 수행합니다.
Open 을 선택한 후 에이전트 이름을 선택하여 에이전트를 테스트합니다.
