Categorias:: Funções de cadeia de caracteres e binários (funções de AI)

AI_COMPLETE (objeto de prompt)¶

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) para um objeto de prompt. O prompt pode conter objetos FILE, que podem conter imagens ou documentos.

Sintaxe¶

A função pode ser usada com a sintaxe de argumentos posicionais ou nomeados.

AI_COMPLETE(
    <model>, <prompt> [ , <model_parameters> ] )

Argumentos¶

model

Uma cadeia de caracteres especificando o modelo a ser usado. Para entradas somente de texto, você pode usar um dos seguintes modelos:

claude-4-opus
claude-4-sonnet
claude-3-7-sonnet
claude-3-5-sonnet
deepseek-r1
llama3-8b
llama3-70b
llama3.1-8b
llama3.1-70b
llama3.1-405b
llama3.3-70b
llama4-maverick
llama4-scout
mistral-large
mistral-large2
mistral-7b
mixtral-8x7b
openai-gpt-4.1
openai-o4-mini
snowflake-arctic
snowflake-llama-3.1-405b
snowflake-llama-3.3-70b

Para entradas de imagem, você pode usar um dos seguintes modelos:

claude-4-opus
claude-4-sonnet
claude-3-7-sonnet
claude-haiku-4-5
claude-sonnet-4-5
claude-opus-4-5
claude-sonnet-4-6
claude-opus-4-6
llama4-maverick
llama4-scout
pixtral-large
openai-o4-mini
openai-gpt-4.1
openai-gpt-5
openai-gpt-5-chat
openai-gpt-5-mini
openai-gpt-5-nano
openai-gpt-5.1
openai-gpt-5.2
gemini-2.5-flash
gemini-2.5-flash-lite
gemini-3-pro

Para entradas de documentos, você pode usar um dos seguintes modelos:

gemini-3-pro
claude-4-opus
claude-4-sonnet
claude-3-7-sonnet
claude-haiku-4-5
claude-sonnet-4-5
claude-opus-4-5

Os modelos suportados podem ter custos diferentes.

prompt

Um objeto prompt contendo texto e, como opção, imagens ou documentos.

model_parameters Um objeto contendo zero ou mais das seguintes opções que afetam os hiperparâmetros do modelo. Consulte Configurações do LLM.

temperature: um valor de 0 a 1 (inclusive) que controla a aleatoriedade da saída do modelo de linguagem. Uma temperatura mais alta (por exemplo, 0,7) resulta em uma saída mais diversificada e aleatória, enquanto uma temperatura mais baixa (como 0,2) torna a saída mais determinística e focada.

Padrão: 0

top_p: um valor de 0 a 1 (inclusive) que controla a aleatoriedade e a diversidade do modelo de linguagem, geralmente usado como alternativa a temperature. A diferença é que top_p restringe o conjunto de possíveis tokens gerados pelo modelo, enquanto temperature influencia quais tokens são escolhidos em cada etapa.

Padrão: 0

max_tokens: define o número máximo de tokens de saída na resposta. Valores pequenos podem resultar em respostas truncadas.

Padrão: 4096 Valor máximo permitido: 8192

guardrails: filtra respostas potencialmente inseguras e prejudiciais de um modelo de linguagem usando o Cortex Guard. TRUE ou FALSE. O valor padrão é FALSE.

Importante

Se você estiver usando AI_COMPLETE com um objeto de prompt, não poderá fornecer um esquema JSON para obter uma saída estruturada como uma resposta.

Para obter uma saída estruturada como resposta, use o parâmetro response_format com AI_COMPLETE (Cadeia de caracteres única). Para obter mais informações usando saídas estruturadas, consulte Saídas estruturadas de AI_COMPLETE.

Exemplo¶

Como passar várias imagens como entrada¶

O exemplo a seguir compara duas imagens, passando ambas como entrada para a função AI_COMPLETE e perguntando se ambas são fotos de gatos:

SELECT AI_COMPLETE('claude-3-5-sonnet',
  PROMPT('Are both image {0} and image {1} pictures of cats?',
    TO_FILE('@myimages', 'sleepingcat.png'), TO_FILE('@myimages', 'jumpingcat.png'))) AS image_classification;

Processamento em lote de imagens de um diretório ou tabela¶

Para o processamento em lote de várias imagens, executando a mesma operação em cada uma, armazene os arquivos de imagem no mesmo estágio. Aplique a função AI_COMPLETE a cada linha da tabela.

Nota

O estágio deve ter uma tabela de diretório para recuperar os caminhos de seus arquivos.

Primeiro, crie a tabela recuperando os locais das imagens do diretório, convertendo-os em objetos FILE e armazenando os objetos FILE resultantes em uma coluna de uma tabela. Use SQL da seguinte forma:

CREATE TABLE image_table AS
    (SELECT TO_FILE('@myimages', RELATIVE_PATH) AS img FROM DIRECTORY(@myimages));

Em seguida, aplique a função AI_COMPLETE à coluna que contém os objetos FILE. O exemplo a seguir classifica cada imagem na tabela:

SELECT AI_COMPLETE('claude-3-5-sonnet',
    PROMPT('Classify the input image {0} in no more than 2 words. Respond in JSON', img_file)) AS image_classification
FROM image_table;

Resposta:

{ "classification": "Inflation Rates" }
{ "classification": "beverage refrigerator" }
{ "classification": "Space Needle" }
{ "classification": "Modern Kitchen" }
{ "classification": "Pie Chart" }
{ "classification": "Economic Graph" }
{ "classification": "Persian Cat" }
{ "classification": "Labrador Retriever" }
{ "classification": "Jedi Cat" }
{ "classification": "Sleeping cat" }
{ "classification": "Persian Cat" }
{ "classification": "Garden Costume" }
{ "classification": "Floral Fashion" }

Se você já tiver uma tabela com caminhos para as imagens, poderá usar a função TO_FILE para construir os objetos FILE dentro da consulta:

SELECT AI_COMPLETE('claude-3-5-sonnet',
    PROMPT('Classify the input image {0} in no more than 2 words. Respond in JSON',
        TO_FILE('@myimages', img_path)) AS image_classification
FROM image_table;

Você também pode recuperar as imagens a serem processadas diretamente do diretório de um estágio, como mostrado aqui:

SELECT AI_COMPLETE('claude-3-5-sonnet',
    PROMPT('Classify the input image {0} in no more than 2 words. Respond in JSON',
        TO_FILE('@myimages', RELATIVE_PATH))) as image_classification
FROM DIRECTORY(@myimages);

Fornecimento de imagens e prompts em uma tabela¶

Para executar uma operação diferente em cada imagem de uma tabela, forneça as imagens e seus prompts correspondentes em uma tabela. No exemplo a seguir, a tabela contém o caminho do estágio de cada imagem na coluna img_path e o prompt na coluna prompt.

AI_COMPLETE('claude-3-5-sonnet',
    PROMPT('Given the input image {0}, {1}. Respond in JSON',
        TO_FILE('@myimages', img_path), prompt) as image_result)
FROM image_table;

Notas de uso para o processamento de imagens¶

Para processar várias imagens, especifique um objeto de prompt na chamada da função que define um modelo de prompt e os arquivos de imagem associados. Você pode usar a função PROMPT para criar esse objeto. O modelo de prompt pode conter espaços reservados numerados ({0}, {1}, etc.) que correspondem às imagens no objeto de prompt. Use a função TO_FILE para especificar os arquivos de documento no objeto de prompt.
Somente texto e imagens são suportados. Não há suporte para arquivos de vídeo e áudio.
Formatos de imagem suportados:
- .jpg
- .jpeg
- .png
- .gif
- .webp
Os modelos pixtral e llama4 também oferecem suporte a .bmp.
O tamanho máximo da imagem é 10 MB para a maioria dos modelos e 3,75 MB para os modelos claude. Os modelos claude não oferecem suporte a imagens com resoluções acima de 8000x8000.
O estágio que contém as imagens deve ter a criptografia do lado do servidor ativada. Não há suporte para estágios criptografados no lado do cliente.
A função não é compatível com políticas de rede personalizadas.
Os nomes dos estágios não diferenciam maiúsculas de minúsculas; os caminhos diferenciam maiúsculas de minúsculas.

Notas de uso para processamento de documentos¶

Para processar vários documentos, especifique um objeto de prompt na chamada da função que define um modelo de prompt e os arquivos de documento associados. Você pode usar a função PROMPT para criar esse objeto. O modelo de prompt pode conter espaços reservados numerados ({0}, {1}, etc.) que correspondem aos documentos no objeto de prompt. Use a função TO_FILE para especificar os arquivos de documento no objeto de prompt.
Somente texto e documentos são aceitos. Arquivos de vídeo e áudio não são aceitos.
Todos os modelos são compatíveis com estes formatos: .txt, .md e .pdf. Os modelos Claude também são compatíveis com .txt, .md, .pdf, .doc, .docx, .xls, .xlsx, .csv e .xhtml.
Os modelos Claude têm um tamanho máximo de documento de 4,5 MB. O Gemini 3 Pro tem um tamanho máximo de documento de 10 MB.
A função não é compatível com políticas de rede personalizadas.
Os nomes dos estágios não diferenciam maiúsculas de minúsculas; os caminhos diferenciam maiúsculas de minúsculas.