Categorias:

Funções de cadeia de caracteres e binários (funções de AI), Funções de arquivo (funções de AI)

AI_COMPLETE

Nota

AI_COMPLETE é a versão atualizada do COMPLETE (SNOWFLAKE.CORTEX). Para obter a funcionalidade mais recente, use AI_COMPLETE.

Gera uma resposta (conclusão) a partir de texto ou imagem usando um modelo de linguagem compatível. Você pode fornecer:

Sintaxe

A sintaxe da função depende do tipo de entrada que você fornece. Para obter informações sobre a sintaxe, consulte as seções a seguir:

Todas as variações de sintaxe aceitam um argumento return_error_details ​​BOOLEAN opcional como parâmetro final. Quando definido como TRUE, a função retorna um OBJECT que contém o valor e a mensagem de erro, sendo um deles NULL dependendo se a função foi bem-sucedida ou falhou. Consulte Comportamento de erro para obter detalhes.

Comportamento em caso de erro

Por padrão, se AI_COMPLETE não puder processar a entrada, a função retornará NULL. Se a consulta processar várias linhas, as linhas com erros retornarão NULL e não impedirão a conclusão da consulta.

O valor de retorno em caso de erro depende do argumento return_error_details. A tabela a seguir mostra o valor de retorno com base no argumento return_error_details:

return_error_details

Valor de retorno

Descrição
FALSE

Não passado

NULL

TRUE

OBJECT com campos value e error
value: A resposta de conclusão (mesmo tipo que o valor de retorno normal), ou NULL se ocorrer um erro.

error: um valor VARCHAR que contém a mensagem de erro se ocorreu um erro ou NULL se a função foi bem-sucedida.

Para obter mais informações sobre o tratamento de erros para funções de AI, consulte Snowflake Cortex AI Function: Multirow error handling improvements.

Requisitos de controle de acesso

Os usuários devem usar uma função que tenha a função do banco de dados SNOWFLAKE.CORTEX_USER. Consulte Privilégios de LLM do Cortex para obter mais informações sobre esse privilégio.