Partilhar via

Função ai_classify

  • Artigo

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime

Importante

Esta funcionalidade está em Pré-visualização Pública.

Na pré-visualização:

  • O modelo de linguagem subjacente pode lidar com vários idiomas, no entanto, essas funções são ajustadas para o inglês.
  • Há limite de taxa para as APIs subjacentes do Modelo de Base. Consulte Limites das APIs do Modelo de Base atualizar esses limites.
  • Devido ao limite de taxa, esta função foi projetada para testes em pequenos conjuntos de dados com menos de 100 linhas. Para casos de uso com mais de 100 linhas de dados, o Databricks recomenda o uso de ai_query e um endpoint com taxa de transferência provisionada. Consulte Executar inferência LLM em lote usando ai_query.

A ai_classify() função permite que você invoque um modelo de IA generativa de última geração para classificar o texto de entrada de acordo com os rótulos fornecidos usando SQL. Essa função usa um modelo de chat que serve o ponto de extremidade disponibilizado pelas APIs do Databricks Foundation Model.

Requisitos

Importante

Os modelos subjacentes que podem ser usados neste momento são licenciados sob a Apache 2.0 License, Copyright © The Apache Software Foundation ou a LLAMA 3.3 Community License Copyright © Meta Platforms, Inc. Todos os direitos reservados. Os clientes são responsáveis por garantir a conformidade com as licenças de modelo aplicáveis.

A Databricks recomenda a revisão dessas licenças para garantir a conformidade com quaisquer termos aplicáveis. Se surgirem modelos no futuro com melhor desempenho de acordo com os benchmarks internos da Databricks, a Databricks poderá alterar o modelo (e a lista de licenças aplicáveis fornecida nesta página).

Atualmente, Meta-Llama-3.3-70B-Instruct é o modelo subjacente que alimenta essas funções de IA.

  • Esta função só está disponível em espaços de trabalho em AI Functions usando regiões suportadas por APIs do Foundation Model.
  • Esta função não está disponível no Azure Databricks SQL Classic.
  • Verifique a página de preços do Databricks SQL.

Nota

No Databricks Runtime 15.1 e superior, essa função é suportada em blocos de anotações Databricks, incluindo blocos de anotações que são executados como uma tarefa em um fluxo de trabalho Databricks.

Sintaxe

ai_classify(content, labels)

Argumentos

  • content: Uma STRING expressão, o texto a ser classificado.
  • labels: Um ARRAY<STRING> literal, os rótulos de classificação de saída esperados. Deve conter pelo menos 2 elementos, e não mais de 20 elementos.

Devoluções

A STRING. O valor corresponde a labels uma das cadeias de caracteres fornecidas no argumento. Devolve null se não content puder ser classificado.

Exemplos

> SELECT ai_classify("My password is leaked.", ARRAY("urgent", "not urgent"));
  urgent

> SELECT
    description,
    ai_classify(description, ARRAY('clothing', 'shoes', 'accessories', 'furniture')) AS category
  FROM
    products
  LIMIT 10;