AI_FILTER¶

Disponibilité de la région¶

La table suivante indique les régions où vous pouvez utiliser la fonction AI_FILTER pour le texte et les images :

Syntaxe¶

Application de AI_FILTER à une chaîne d’entrée :

AI_FILTER( <input> )

Application de AI_FILTER à une seule image :

AI_FILTER( <predicate> , <input> )

Appliquer AI_FILTER à plusieurs colonnes contenant à la fois du texte et des images, en utilisant PROMPT :

AI_FILTER( PROMPT('<template_string>',  <col_1>, … ) )

Arguments¶

Obligatoire :

Si vous spécifiez une chaîne d’entrée :

input

Une chaîne contenant le texte à classer.

Si vous filtrez sur un fichier :

predicate

Une chaîne contenant les instructions pour classer l’entrée du fichier comme TRUE ou FALSE.

file

La colonne dans laquelle le fichier est classé en fonction des instructions spécifiées à l’adresse predicate. Vous pouvez utiliser IMAGE FILE comme entrée de la fonction AI_FILTER.

Si vous utilisez la fonction PROMPT() pour définir le format des entrées :

Pour les prompts plus compliqués, en particulier avec plusieurs colonnes de fichiers, vous pouvez utiliser PROMPT pour vous aider à créer une input.

La fonction PROMPT() prend en charge le formatage des chaînes et des types de données FILE. Pour une utilisation détaillée, voir Exemples.

Renvoie¶

Renvoie une valeur booléenne qui indique si l’instruction correspond à TRUE ou FALSE pour le texte spécifié.

Exigences en matière de contrôle d’accès¶

Les utilisateurs doivent utiliser un rôle auquel le rôle de base de données SNOWFLAKE.CORTEX_USER a été accordé. Voir Privilèges LLM Cortex pour plus d’informations sur ce privilège.

Optimisation des performances et des coûts¶

Par défaut, AI_FILTER inclut une optimisation des performances intégrée dans les requêtes éligibles. Cette optimisation peut fournir des performances 2 à 10 fois plus rapides et jusqu’à 60 % d’utilisation de jetons en moins, avec un impact minimal sur la qualité.

Cette optimisation est déclenchée automatiquement lorsque le moteur de requête détecte un modèle approprié. Comme pour d’autres optimisations de requête, Snowflake ne garantit pas que cette optimisation sera appliquée à chaque requête. Le moteur s’appuie sur le routage adaptatif et la réécriture contextuelle pour exécuter plus efficacement les opérations AI lorsque cela est possible.

Pour désactiver cette optimisation pour votre compte, contactez votre gestionnaire de compte.

Notes sur l’utilisation¶

Pour des performances optimales, suivez ces directives :

• Assurez-vous que les colonnes envoyées à AI_FILTER ne contiennent pas de valeurs NULL.

• Utilisez du texte brut en anglais pour la chaîne d’entrée ou pour les arguments de PROMPT().

• Fournissez des détails sur l’instruction du texte d’entrée. Par exemple, au lieu d’une instruction telle que « semble satisfait », utilisez « Dans la transcription d’assistance suivante, le client semble satisfait ».

• Pensez à formuler l’entrée sous forme de question. Par exemple : « Dans la transcription d’assistance suivante, le client semble-t-il satisfait ? »

Exemples¶

SELECT AI_FILTER('Is Canada in North America?');

TRUE

WITH reviews AS (
            SELECT 'Wow... Loved this place.' AS review
  UNION ALL SELECT 'The pizza is not good.'
)
SELECT * FROM reviews
WHERE AI_FILTER(CONCAT('The reviewer enjoyed the restaurant: ', review));

WITH reviews AS (

SELECT 'Wow... Loved this place.' AS review
UNION ALL SELECT 'The pizza is not good.'
)
SELECT * FROM reviews
WHERE AI_FILTER(PROMPT('The reviewer enjoyed the restaurant: {0}', review));

+--------------------------+
| REVIEW                   |
|--------------------------+
| Wow... Loved this place. |
+--------------------------+

WITH country AS (
          SELECT 'Switzerland' AS country,
UNION ALL SELECT 'Korea'
),
region AS (
            SELECT 'Asia' AS region,
  UNION ALL SELECT 'Europe'
)
SELECT country,
      region,
      AI_FILTER(PROMPT('{0} is in {1}', country, region)) AS result
FROM country CROSS JOIN region ;

+-------------+-------+--------+
| COUNTRY     |REGION | RESULT |
|-------------+-------+--------+
| Switzerland |Europe | TRUE   |
|-------------+-------+--------+
| Switzerland | Asia  | FALSE  |
|-------------+-------+--------+
| Korea       |Europe | FALSE  |
+-------------+-------+--------+
| Korea       | Asia  | TRUE   |
+-------------+-------+--------+

SELECT *
FROM RESUMES
JOIN JOBS
ON AI_FILTER(PROMPT('Evaluate if this resume {0} fits this job description {1}', RESUME.contents, JOBS.jd));

WITH pictures AS (
  SELECT
      TO_FILE(file_url) AS img
  FROM DIRECTORY(@file_stage)
)
SELECT
FL_GET_RELATIVE_PATH(img) AS file_path FROM pictures
WHERE AI_FILTER('Is this a picture of a cat?', img);

WITH pictures AS (
  SELECT
      TO_FILE(file_url) AS img
  FROM DIRECTORY(@file_stage)
)
SELECT
    FL_GET_RELATIVE_PATH(img) AS file_path FROM pictures
WHERE AI_FILTER(PROMPT('{0} is a cat picture', img));

+--------------------------+
|        FILE_PATH         |
|--------------------------+
|        2cats.jpg         |
+--------------------------+
|        cat1.png          |
+--------------------------+
|      orange_cat.jpg      |
+--------------------------+

Limitations¶

• Les fonctions AI de Snowflake ne fonctionnent pas sur des FILEs créés à partir de fichiers de préparation provenant des types de zones de préparation suivantes :

  • Zones de préparation interne avec mode de chiffrement TYPE = 'SNOWFLAKE_FULL'

  • Zones de préparation externe avec n’importe quel mode de chiffrement côté client :

    • TYPE = 'AWS_CSE'

    • TYPE = 'AZURE_CSE'

  • Zone de préparation de l’utilisateur, zone de préparation de table

  • Zone de préparation avec des noms entre guillemets doubles