Catégories :

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

AI_COMPLETE

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) à partir d’un texte ou d’une image à l’aide d’un modèle de langage pris en charge. Vous pouvez fournir :

  • Une requête textuelle, pour générer une réponse du modèle. Pour plus d’informations, voir AI_COMPLETE (Chaîne unique).

  • Une image unique et une requête textuelle, pour générer une réponse sur la base de l’image et du prompt. Pour plus d’informations, voir AI_COMPLETE (Image unique).

  • Un objet de prompt qui peut prendre en charge plusieurs images et du texte. Pour plus d’informations, voir AI_COMPLETE (Objet de prompt).

Syntaxe

La syntaxe de la fonction dépend du type d’entrée que vous fournissez. Pour plus d’informations sur la syntaxe, reportez-vous aux sections suivantes :

Toutes les variations syntaxiques acceptent un argument facultatif``return_error_details``BOOLEAN comme paramètre final. Lorsqu’il est défini sur TRUE, la fonction renvoie un OBJECT qui contient la valeur et le message d’erreur, dont l’un est NULL selon que la fonction réussit ou échoue. Voir Comportement d’erreur pour plus de détails.

Comportement d’erreur

Par défaut, si AI_COMPLETE ne peut pas traiter l’entrée, la fonction renvoie NULL. Si la requête traite plusieurs lignes, les lignes contenant des erreurs renvoient NULL et n’empêchent pas l’achèvement de la requête.

La valeur de retour sur l’erreur dépend de l’argument return_error_details. La table suivante indique la valeur de retour basée sur l’argument return_error_details :

return_error_details

Valeur de retour

Description
FALSE

Non transmise

NULL

TRUE

OBJECT avec les champs value et error
value : la réponse d’achèvement (même type que la valeur de retour normale) ouNULL si une erreur s’est produite.

error : Une valeur VARCHAR qui contient le message d’erreur si une erreur s’est produite, ou NULL si la fonction a fonctionné.

Pour plus d’informations sur le traitement des erreurs pour les fonctions AI, consultez Snowflake Cortex AI Function: Multirow error handling improvements.

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.