Cortex Knowledge Extension¶
Cortex Knowledge Extensions(CKEs)은 Cortex Search Services 로 Snowflake Marketplace 또는 개인 목록 또는 조직 목록 을 통해 공유할 수 있습니다. 검색 증강 생성(RAG) 아키텍처에서 라이선스 및 독점 내용을 Cortex AI 애플리케이션에 통합하는 데 사용할 수 있습니다. 예를 들어, CKEs 를 사용하여 기사, 시장 조사, 서적 또는 포럼 게시물과 같은 비정형 내용의 지식을 챗봇 및 에이전트 시스템과 같은 Cortex AI 애플리케이션에 통합할 수 있습니다.
CKE 작동 방법¶
작동 방식은 다음과 같습니다.
공급자는 자신의 텍스트 데이터를 계정의 테이블에 업로드하고 테이블에 Cortex Search Service 를 생성합니다. 이 Cortex Search Service는 Snowflake Marketplace 에서 공유됩니다. Snowflake Marketplace에서 공유되는 Cortex Search Service를 Cortex Knowledge Extension(CKE)이라고 합니다.
컨슈머는 Cortex AISQL 또는 Cortex Agent API 를 CKE 와 함께 사용하여 Cortex AI 를 활용해 챗봇과 같은 애플리케이션을 빌드할 수 있습니다.
CKE 와 통합된 Cortex AI 애플리케이션에 프롬프트가 주어지면 이 프롬프트는 CKE 로 전달되어 의미 체계 검색을 수행하여 관련 지식을 얻습니다. 관련 지식은 Cortex AI 애플리케이션의 LLM 에 제공되어 추론된 후 인용 및 특성과 함께 사용자에게 다시 답변을 반환합니다.

CKE 기능¶
Cortex Knowledge Extension의 주요 기능은 다음과 같습니다.
이러한 각 기능에 대해 아래에서 자세히 설명합니다.
내용 보호¶
공급자는 CKE 에서 24시간 동안 컨슈머에게 반환할 수 있는 인덱스된 내용의 비율을 제한할 수 있습니다. 이 작업은 아래 명령을 사용하여 임계값을 설정하면 됩니다. 임계값은 개별 문서 수준에서 적용되는 것이 아니라 인덱스된 내용의 전체 말뭉치에 적용됩니다. 컨슈머는 CKE 에서 인덱스된 내용의 임계값 비율만큼만 액세스할 수 있습니다.
cke_content_protection
필드에 대한 자세한 내용은 목록 매니페스트 참조 섹션을 참조하십시오.
-- Use CREATE to create a new CKE listing with content protection.
-- Use ALTER to update an existing listing with content protection.
-- This example creates a CKE listing targeting to two accounts.
create external listing CKE_LISTING
share CKE_SHARE as
$$
title: "CKE Listing Title"
description: "Cortex Knowledge Extension Listing Description"
listing_terms:
type: "STANDARD"
auto_fulfillment:
refresh_type: "SUB_DATABASE"
refresh_schedule: "1440 MINUTE"
targets:
accounts:
- "ORG1.ACCOUNT1"
- "ORG2.ACCOUNT2"
cke_content_protection:
enable: true,
threshold: 0.2
$$
-- describe listing CKE_LISTING
-- See the manifest_yaml column for the cke_content_protection setting
컨슈머가 임계값에 도달하면 CKE 에 대한 쿼리 실행이 차단되고 컨슈머는 다음과 같은 오류를 받게 됩니다.
You have reached the content protection threshold. Please try again later.
컨슈머는 임계값이 새로 고쳐지면 데이터를 다시 쿼리할 수 있습니다.
관리¶
Snowsight 에 로그인하고 Provider Studio » Home 페이지로 이동하면 CKE 에서 실행한 쿼리 수를 확인할 수 있습니다. Analytics 섹션에는 실행된 쿼리 수가 표시됩니다.
평가판 지원¶
공급자는 고객이 제품을 결제하기 전에 사용해 볼 수 있도록 CKE 의 제한적 평가판 을 제공할 수 있습니다.
Monetization¶
Cortex Knowledge Extension은 구독 또는 플랫폼 외 수익 창출을 통해 플랫폼 내 Snowflake Marketplace Monetization 기능을 사용하여 수익을 창출할 수 있습니다.
리전 가용성¶
Cortex Knowledge Extension은 Cortex Search 이 제공되는 모든 리전에서 사용할 수 있습니다.
주요 고려 사항¶
고객이 Cortex Knowledge Extension을 사용하는 경우 Cortex Search Service 의 서비스를 비활성화하면 고객의 애플리케이션이 중단될 수 있으므로 주의하십시오.
Cortex Knowledge Extension의 고급 튜닝에 대해서는 Cortex Search 설명서를 참조하십시오.
인용¶
CKE 에서 인용을 제공하도록 하려면 Cortex Search Services 를 구성할 때 인덱스된 열에 문서의 출처를 가리키는 SOURCE_URL
열을 포함해야 합니다. LLMs 또는 Snowflake Intelligence에서 이를 사용하여 명확한 특성 및 소스 자료로 돌아가는 하이퍼링크를 제공할 수 있습니다.
CKE 를 Snowflake Marketplace에 게시하기¶
Marketplace에 게시할 Cortex Search Service를 생성한 후 목록을 생성 합니다. 게시할 오브젝트로 생성한 Cortex Search Service 오브젝트를 가리키고 있는지 확인합니다.
CKE 와 대화하기¶
다음 방법을 사용하여 CKE 에 질문할 수 있습니다.
Cortex Search Playground 사용:
Snowsight에서 AI & ML » Cortex Search 로 이동합니다.
Database/Schema 드롭다운 메뉴에서 CKE 를 선택합니다.
오른쪽 상단 모서리에 있는 Playground 를 클릭합니다.
검색 쿼리를 입력하고 결과를 확인합니다
Snowflake Intelligence를 사용합니다.
자습서 3: Snowflake Intelligence에 CKE 추가하기 에 설명된 단계를 따르십시오.
Cortex Agent API 사용:
Cortex Agent API 를 사용하고 CREATE CORTEX SEARCH 매개 변수에 공유 CKE 를 지정합니다. 자세한 내용은 Cortex Agent API 설명서를 참조하십시오.
CKE 업데이트하기¶
CKE 를 최신 상태로 유지하는 것은 정기적으로 새로운 내용이나 업데이트된 내용을 소개하는 공급자의 일반적인 사용 사례입니다. Cortex Knowledge Extension을 최신 상태로 유지하려면 다음과 같이 하십시오.
Snowflake 계정에 새/업데이트된 문서를 삽입하는 별도의 프로세스를 통해 내용이 포함된 기본 테이블이 업데이트되었는지 확인합니다.
Cortex Search Service 목표 지연을 검토합니다. Cortex Search Service는 특정
target_lag
까지 데이터를 새로 고치고 최신 상태로 유지하도록 구성됩니다.target_lag
에 대한 자세한 내용은 Cortex Search SQL 사용 항목을 참조하십시오.다음 명령을 실행하여 Cortex Search Service가 인덱싱 중인지 확인합니다.
-- Get the status of the search service DESCRIBE CORTEX SEARCH SERVICE cke_simple_cortex_search_service; -- If the indexing status is suspended, you can resume it with the following command ALTER CORTEX SEARCH SERVICE cke_simple_cortex_search_service RESUME INDEXING;
CKE 및 자동 복제¶
컨슈머는 해당 리전에서 가용성을 제공하는 Cortex Knowledge Extension에만 액세스할 수 있습니다. 공급자는 Provider Studio의 Cortex Knowledge Extension 목록에서 자동 복제를 활성화 하여 원격 컨슈머 리전으로 Cortex Search Service를 자동 복제할 수 있습니다.
제한 사항¶
CKEs 를 통한 사용량 기반 청구는 지원되지 않습니다.