- Catégories :
Fonctions de chaîne et fonctions binaires (Large Language Model)
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.
Syntaxe¶
La fonction contient deux arguments obligatoires et quatre arguments facultatifs. La fonction peut être utilisée avec la syntaxe des arguments positionnels ou nommés.
Utilisation de 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
llama-4-maverick
llama-4-scout
pixtral-large
Les modèles pris en charge peuvent avoir des coûts différents.
predicate
Un prompt de chaînes
file
Un objet de type FILE représentant une image
model_parameters
Un objet contenant plusieurs ou aucune des options suivantes qui affectent les hyperparamètres du modèle. Voir Paramètres LLM.
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 quetop_p
restreint l’ensemble des jetons possibles que le modèle produit, tandis quetemperature
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. SoitTRUE
soitFALSE
. La valeur par défaut estFALSE
.
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.

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.

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
etllama4
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èlesclaude
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.