Cortex Knowledge Extension¶

CKE 작동 방법¶

작동 방식은 다음과 같습니다.

1. 공급자는 자신의 텍스트 데이터를 계정의 테이블에 업로드하고 테이블에 Cortex Search Service 를 생성합니다. 이 Cortex Search Service는 Snowflake Marketplace 에서 공유됩니다. Snowflake Marketplace에서 공유되는 Cortex Search Service를 Cortex Knowledge Extension(CKE)이라고 합니다.

2. 컨슈머는 Cortex AISQL 또는 Cortex Agent API 를 CKE 와 함께 사용하여 Cortex AI 를 활용해 챗봇과 같은 애플리케이션을 빌드할 수 있습니다.

3. CKE 와 통합된 Cortex AI 애플리케이션에 프롬프트가 주어지면 이 프롬프트는 CKE 로 전달되어 의미 체계 검색을 수행하여 관련 지식을 얻습니다. 관련 지식은 Cortex AI 애플리케이션의 LLM 에 제공되어 추론된 후 인용 및 특성과 함께 사용자에게 다시 답변을 반환합니다.

CKE 기능¶

Cortex Knowledge Extension의 주요 기능은 다음과 같습니다.

• 내용 보호

• 관리

• 평가판 지원

• Monetization

이러한 각 기능에 대해 아래에서 자세히 설명합니다.

-- 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

You have reached the content protection threshold. Please try again later.

리전 가용성¶

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 사용:

  1. |sf-web-interface|의 탐색 메뉴에서 :ui:`AI & ML` |raa| :ui:`Cortex Search`를 선택합니다.

  2. Database/Schema 드롭다운 메뉴에서 CKE 를 선택합니다.

  3. 오른쪽 상단 모서리에 있는 Playground 를 클릭합니다.

  4. 검색 쿼리를 입력하고 결과를 확인합니다

• Snowflake Intelligence를 사용합니다.

  • 자습서 3: Snowflake Intelligence에 CKE 추가하기 에 설명된 단계를 따르십시오.

• Cortex Agent API 사용:

  • Cortex Agent API 를 사용하고 CREATE CORTEX SEARCH 매개 변수에 공유 CKE 를 지정합니다. 자세한 내용은 Cortex Agent API 설명서를 참조하십시오.

CKE 업데이트하기¶

CKE 를 최신 상태로 유지하는 것은 정기적으로 새로운 내용이나 업데이트된 내용을 소개하는 공급자의 일반적인 사용 사례입니다. Cortex Knowledge Extension을 최신 상태로 유지하려면 다음과 같이 하십시오.

1. Snowflake 계정에 새/업데이트된 문서를 삽입하는 별도의 프로세스를 통해 내용이 포함된 기본 테이블이 업데이트되었는지 확인합니다.

2. Cortex Search Service 목표 지연을 검토합니다. Cortex Search Service는 특정 target_lag 까지 데이터를 새로 고치고 최신 상태로 유지하도록 구성됩니다. target_lag 에 대한 자세한 내용은 Cortex Search SQL 사용 항목을 참조하십시오.

3. 다음 명령을 실행하여 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;
   

   Copy

CKE 및 자동 복제¶

컨슈머는 해당 리전에서 제공되는 Cortex Knowledge Extension에만 액세스할 수 있습니다. 공급자는 Provider Studio의 Cortex Knowledge Extension 목록에 대해 자동 복제를 활성화하여 Cortex Search Service를 원격 컨슈머 리전에 자동으로 복제할 수 있습니다.

제한 사항¶

• CKEs에 대한 사용량 기반 청구는 지원되지 않습니다.