Cortex Knowledge Extensions¶

Fonctionnement de CKE¶

Voici comment cela fonctionne :

1. Un fournisseur importe ses données textuelles dans un tableau de son compte et crée un Cortex Search Service sur le tableau. Ce Cortex Search Service est ensuite partagé sur le Snowflake Marketplace. Un service Cortex Search Service partagé sur le Snowflake Marketplace est connu sous le nom de Cortex Knowledge Extension (CKE).

2. Un consommateur construit une application exploitant Cortex AI, telle qu’un chatbot, en utilisant Cortex AISQL ou l’API Cortex Agent avec la CKE.

3. Lorsqu’un prompt est donné à l’application Cortex AI qui est intégrée à une CKE,il est transmis à la CKE pour obtenir des connaissances pertinentes en effectuant une recherche sémantique. Les connaissances pertinentes sont renvoyées au LLM de l’application Cortex AI et analysées avant de renvoyer une réponse à l’utilisateur avec des citations et des attributs.

Fonctions de la CKE¶

Voici quelques-unes des fonctions clés des Cortex Knowledge Extensions :

• Protection du contenu

• Administration

• Prise en charge des essais

• Monétisation

Chacune de ces fonctions est décrite plus en détail ci-dessous.

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

Disponibilité de la région¶

Les Cortex Knowledge Extensions sont disponibles dans toutes les régions où Cortex Search est disponible.

Considérations clés¶

Gardez à l’esprit que lorsque vos clients utilisent votre Cortex Knowledge Extension, soyez prudent lorsque vous désactivez Cortex Search Service, car cela risque d’interrompre les applications de vos clients.

Pour le réglage avancé d’une Cortex Knowledge Extension, référez-vous à la documentation de Cortex Search.

Citations¶

Pour vous assurer que la CKE fournit des citations, lorsque vous configurez les Cortex Search Services, veillez à inclure une colonne SOURCE_URL qui pointe vers la source du document dans les colonnes indexées. Elle peut être utilisée par les LLMs ou Snowflake Intelligence pour fournir des attributs clairs et des liens hypertextes vers le matériel source.

Publication de la CKE sur Snowflake Marketplace¶

Après avoir créé un Cortex Search Service que vous souhaitez publier sur Marketplace, créez une annonce. Veillez à pointer sur l’objet Cortex Search Service que vous avez créé en tant qu’objet à publier.

Discussion avec la CKE¶

Vous pouvez utiliser les méthodes suivantes pour poser des questions à la CKE.

• Utilisez le Cortex Search Playground :

  1. Dans Snowsight, naviguez jusqu’à AI & ML » Cortex Search.

  2. Sélectionnez la CKE dans le menu déroulant Database/Schema.

  3. Cliquez sur Playground dans le coin supérieur droit.

  4. Tapez une requête et voyez les résultats.

• Utilisez l’intelligence Snowflake :

  • Suivez les étapes décrites dans Tutoriel 3 : Ajouter un CKE à Snowflake Intelligence.

• Utiliser l’API de Cortex Agent :

  • Utilisez l’API de Cortex Agent et spécifiez la CKE partagée dans le paramètre CREATE CORTEX SEARCH. Reportez-vous à la documentation de l’API de Cortex Agent pour plus d’informations.

Mise à jour de votre CKE¶

La mise à jour de la CKE est un cas d’utilisation courant pour les fournisseurs qui introduisent régulièrement des contenus nouveaux ou mis à jour. Pour vous assurer que votre Cortex Knowledge Extension est à jour, procédez comme suit :

1. Assurez-vous que le tableau sous-jacent avec le contenu a été mis à jour via un processus séparé d’insertion de documents nouveaux / mis à jour dans votre compte Snowflake.

2. Examinez la latence cible du Cortex Search Service. Le Cortex Search Service est configuré pour actualiser les données et conserver leur fraîcheur jusqu’à un certain target_lag. Reportez-vous à la rubrique Cortex Search Utiliser SQL pour plus d’informations sur target_lag.

3. Exécutez les commandes suivantes pour vous assurer que le Cortex Search Service procède à l’indexation.

   -- 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 et exécution automatique¶

Les consommateurs ne peuvent accéder qu’à une Cortex Knowledge Extension mise à disposition dans leur région. Les fournisseurs peuvent répliquer automatiquement leur Cortex Search Service dans les régions de consommateurs distantes en activant l’exécution automatique sur leur annonce Cortex Knowledge Extension dans Provider Studio.

Limitations¶

• La facturation à l’utilisation avec les CKEs n’est pas prise en charge.