Catégories :

Fonctions de chaîne et fonctions binaires (Fonctions AI)

AI_COMPLETE (Image unique)

Note

AI_COMPLETE est la version actualisée de COMPLETE (SNOWFLAKE.CORTEX). Pour obtenir les dernières fonctionnalités, utilisez AI_COMPLETE.

Génère une réponse (exécution) à un prompt textuel à l’aide d’un modèle de langage pris en charge. Cette variante de la fonction améliore AI_COMPLETE avec des capacités de compréhension des documents. L’invite peut faire référence à des informations ou à des images trouvées dans un fichier contenant un document. La fonction prend en charge l’entrée d’un seul document.

Syntaxe

La fonction comporte deux arguments obligatoires et quatre arguments facultatifs. La fonction peut être utilisée avec une syntaxe d’arguments positionnels ou nommés.

Utiliser AI_COMPLETE avec une seule entrée d’image :

AI_COMPLETE(
    <model>, <predicate>, <file> [, <model_parameters> ] )

Arguments

model

Une chaîne spécifiant le modèle à utiliser. Spécifiez l’un des modèles suivants :

  • claude-4-opus

  • claude-4-sonnet

  • claude-3-7-sonnet

  • claude-3-5-sonnet

  • llama4-maverick

  • llama4-scout

  • openai-o4-mini

  • openai-gpt-4.1

  • pixtral-large

Les modèles pris en charge peuvent avoir des coûts différents.

predicate

Une invite de chaîne.

file

Objet de type FILE représentant une image.

model_parameters

Un objet contenant zéro ou plusieurs des options suivantes qui affectent les hyperparamètres du modèle. Voir `Paramètres LLM<https://www.promptingguide.ai/introduction/settings>`_.

  • temperature : une valeur comprise entre 0 et 1 (inclusivement) qui contrôle le caractère aléatoire de la sortie du modèle de langage. Une température plus élevée (par exemple, 0,7) produit des résultats plus divers et aléatoires, tandis qu’une température plus basse (telle que 0,2) rend les résultats plus déterministes et plus ciblés.

    Par défaut : 0

  • top_p : une valeur comprise entre 0 et 1 (inclus) qui contrôle le caractère aléatoire et la diversité du modèle linguistique, généralement utilisée comme alternative à temperature. La différence est que top_p restreint l’ensemble des jetons possibles que le modèle produit, tandis que temperature influence les jetons choisis à chaque étape.

    Par défaut : 0

  • max_tokens : définit le nombre maximum de jetons de sortie dans la réponse. De petites valeurs peuvent entraîner des réponses tronquées.

    Valeur par défaut : 4 096 Valeur maximale autorisée : 8 192

  • guardrails : filtre les réponses potentiellement dangereuses et nuisibles d’un modèle de langage avec Cortex Guard. Soit TRUE soit FALSE. La valeur par défaut est FALSE.

Renvoie

Renvoie la réponse sous forme de chaîne à partir du modèle de langage.

Exemples

Les exemples suivants démontrent les capacités de base de la fonction COMPLETE avec des images.

Réponse visuelle aux questions

Un tableau des taux d’inflation est utilisé pour répondre à une question sur les données.

Graphique des taux d'inflation en 2023 avec des estimations pour 2024

Comparaison entre les taux d’inflation en 2023 et en 2024 (Statista)

SELECT AI_COMPLETE('claude-3-5-sonnet',
    'Which country will observe the largest inflation change in 2024 compared to 2023?',
    TO_FILE('@myimages', 'highest-inflation.png'));

Réponse :

Looking at the data, Venezuela will experience the largest change in inflation rates between 2023 and 2024.
The inflation rate in Venezuela is projected to decrease significantly from 337.46% in 2023 to 99.98% in 2024,
representing a reduction of approximately 237.48 percentage points. This is the most dramatic change among
all countries shown in the chart, even though Zimbabwe has higher absolute inflation rates.

Extraction d’entités à partir d’une image

Cet exemple extrait les entités (objets) d’une image et renvoie les résultats au format JSON.

Photographie d'une cuisine après rénovation 
SELECT AI_COMPLETE('claude-3-5-sonnet',
    'Extract the kitchen appliances identified in this image. Respond in JSON only with the identified appliances.',
    TO_FILE('@myimages', 'kitchen.png'));

Réponse :

{
    "appliances": [ "microwave","electric stove","oven","refrigerator" ]
}

Notes sur l’utilisation pour le traitement des images

  • Seuls le texte et les images sont pris en charge. Les fichiers vidéo et audio ne sont pas pris en charge.

  • Formats d’image pris en charge :

    • .jpg

    • .jpeg

    • .png

    • .gif

    • .webp

    • Les modèles pixtral et llama4 prennent également en charge .bmp.

  • La taille maximale de l’image est de 10 MB pour la plupart des modèles et de 3,75 MB pour les modèles claude. Les modèles claude ne prennent pas en charge les images dont la résolution est supérieure à 8000x8000.

  • La zone de préparation contenant les images doit avoir le chiffrement côté serveur activé. Les zones de préparation chiffrées côté client ne sont pas prises en charge.

  • La fonction ne prend pas en charge les politiques réseau personnalisées.

  • Les noms de zones de préparation ne tiennent pas compte de la casse ; les chemins tiennent compte de la casse.