A função AI_SUMMARIZE no MaxCompute chama um modelo pré-treinado para gerar um resumo conciso do texto de entrada diretamente em SQL. Ela suporta ajustes de parâmetros para controlar o tamanho da saída e a aleatoriedade. - MaxCompute: Central de Documentação do Alibaba Cloud

A AI_SUMMARIZE é uma função de IA do MaxCompute que chama um modelo para gerar um resumo do texto de entrada.

Sintaxe

STRING AI_SUMMARIZE(
  STRING <model_name>,
  STRING <version_name>,
  STRING <input>
  [, BIGINT <max_words>]
  [, STRING <model_parameters>]
);

Parâmetros

model_name: Obrigatório. STRING que especifica o nome do modelo. Para mais informações, consulte SQL AI function.
version_name: Obrigatório. STRING que especifica a versão do modelo. Para chamar a versão padrão, especifique DEFAULT_VERSION.
input: Obrigatório. STRING que especifica o texto a resumir.
max_words: Opcional. Inteiro que define o número máximo de palavras geradas pelo modelo grande. O valor padrão é 50. Se definido como 0, não há limite imposto, mas a saída ainda fica restrita pelo próprio modelo e pelo parâmetro max_tokens. Caso o limite seja excedido, a saída será truncada.
model_parameters: Opcional. STRING. Especifica parâmetros do modelo como max_tokens, temperature e top_p. O formato é uma string JSON:

'{"max_tokens": 500, "temperature": 0.6, "top_p": 0.95}'.
- max_tokens: Número máximo de tokens gerados em uma única chamada de modelo. Para modelos públicos do MaxCompute, o valor padrão é 4.096.
- temperature: Valor entre 0 e 1 que controla a aleatoriedade da saída. Valores mais altos resultam em saídas mais criativas e diversificadas; valores mais baixos produzem saídas mais determinísticas e conservadoras.
- top_p: Valor entre 0 e 1 que limita o intervalo de rótulos candidatos disponíveis para o modelo. Valores mais altos permitem um intervalo mais amplo e maior diversidade; valores mais baixos reduzem o intervalo e produzem resultados mais focados.

Valor de retorno

Retorna uma STRING com o resumo do texto de entrada. Ocorrerá erro se:

input não for uma STRING.
max_words for NULL.

Exemplos

Exemplo 1: Resumo com limite de palavras padrão

Chame o modelo público qwen3.7-max para gerar um resumo de texto com o limite padrão de 50 palavras.

SET odps.namespace.schema=true;

SELECT AI_SUMMARIZE(
  bigdata_public_modelset.default.`qwen3.7-max`, 
  default_version, 
  'MaxCompute provides the SQL AI function, which supports AI inference by calling built-in large language models, user-imported models, or remote PAI-EAS models through SQL.') AS info;
-- The following result is returned:
+------+
| info |
+------+
| MaxCompute provides the SQL AI function, supporting inference by calling built-in large language models, user-imported models, or remote PAI-EAS models via SQL. |
+------+

Exemplo 2: Resumo com limite de palavras especificado

Use o modelo público deepseek-v4-pro para gerar resumos em lote de vários artigos com limite de 30 palavras.

-- Sample data
CREATE TABLE articles (
    article STRING
);

INSERT INTO articles VALUES
    ('Artificial intelligence is reshaping the global economy. Industries from healthcare to finance are adopting AI solutions to automate processes, reduce costs, and improve decision-making. Machine learning models can analyze massive datasets to identify patterns that are difficult for humans to detect. However, the rapid adoption of AI has also raised concerns about job displacement, data privacy, and algorithmic bias. Governments and organizations are actively developing ethical guidelines and regulatory frameworks to ensure the healthy development of AI.'),
    ('Cloud computing has become a key infrastructure for modern businesses. Through cloud migration, companies can reduce capital expenditure on hardware, achieve elastic scaling of resources on demand, and use cutting-edge technologies with low upfront investment. Major cloud service providers like Alibaba Cloud, AWS, and Azure offer a rich set of services covering computing, storage, databases, and AI capabilities. The rise of cloud-native architecture has also driven the widespread adoption of technologies such as microservices, containers, and Serverless.');

-- Generate summaries for the articles in the table in a batch
SET odps.namespace.schema=true;

SELECT
    AI_SUMMARIZE(
        bigdata_public_modelset.default.`deepseek-v4-pro`,
        DEFAULT_VERSION,
        article,
        30
    ) AS summary,
    article
FROM articles;

-- The following result is returned:
+------------------------------------------------------+--------------------------------------------------------------------+
|summary                                               |article                                                        |
+------------------------------------------------------+--------------------------------------------------------------------+
| AI is driving automation and data analysis across industries but also raises ethical and regulatory concerns. |Artificial intelligence is reshaping the global economy. Industries from healthcare to finance are adopting AI solutions to automate processes, reduce costs, and improve decision-making. Machine learning models can analyze massive datasets to identify patterns that are difficult for humans to detect. However, the rapid adoption of AI has also raised concerns about job displacement, data privacy, and algorithmic bias. Governments and organizations are actively developing ethical guidelines and regulatory frameworks to ensure the healthy development of AI.    |
| Cloud computing reduces business costs and provides easy access to elastic resources and cutting-edge technologies.        |Cloud computing has become a key infrastructure for modern businesses. Through cloud migration, companies can reduce capital expenditure on hardware, achieve elastic scaling of resources on demand, and use cutting-edge technologies with low upfront investment. Major cloud service providers like Alibaba Cloud, AWS, and Azure offer a rich set of services covering computing, storage, databases, and AI capabilities. The rise of cloud-native architecture has also driven the widespread adoption of technologies such as microservices, containers, and Serverless.              |
+-------------------------------------------------------+--------------------------------------------------------------------+

Perguntas frequentes

Solucionar problemas comuns com modelos públicos

Sintoma: A chamada a um modelo público compatível com o service de computação de modelos retorna o seguinte erro:

FAILED: ODPS-0130071:[1,8] Semantic analysis exception - inference quota status check failed, error message: region cn-shanghai not found in inference quota

Causa: O service de computação de modelos não está ativo na região do seu projeto, como China (Shanghai), o que impede chamadas aos recursos de inferência de IA.

Solução: Acesse o console do Alibaba Cloud e ative o service de computação de modelos para a região do seu projeto. Para instruções detalhadas, consulte Purchase and use the MaxCompute model computing service.