Cortexナレッジ拡張¶

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 Extensionsのキー機能の一部をご紹介します：

• コンテンツの保護

• 管理

• トライアルサポート

• 収益化

それぞれの特徴については、以下で詳しく説明します。

-- 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 Extensions は、 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 に公開します。¶

マーケットプレイスに公開したいCortex Search Serviceを作成した後、 リストを作成します。作成したCortex Search Serviceオブジェクトが、公開したいオブジェクトであることを確認してください。

CKE との対話¶

以下の方法で CKE の質問をすることができます。

• Cortex Search Playgroundをご利用ください：

  1. Snowsightで、 AI & ML » 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 までデータを新鮮に保ちます。Cortex Search Use ``target_lag` の詳細情報については、 SQL <label_cortex_search_overview_example_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 による使用ベースの 請求はサポートされていません。