The AI_SUMMARIZE function in MaxCompute calls a pre-trained model to generate a concise summary of input text directly within SQL. It supports parameter adjustments to control output length and randomness. - MaxCompute

La fonction AI_SUMMARIZE de MaxCompute appelle un modèle pour générer un résumé du texte d'entrée.

Syntaxe

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

Paramètres

model_name : Obligatoire. Chaîne (STRING) spécifiant le nom du modèle. Pour plus d'informations, consultez la rubrique Fonctions IA SQL.
version_name : Obligatoire. Chaîne (STRING) spécifiant la version du modèle. Pour appeler la version par défaut, spécifiez DEFAULT_VERSION.
input : Obligatoire. Chaîne (STRING) correspondant au texte à résumer.
max_words : Facultatif. Entier définissant le nombre maximal de mots que le grand modèle de langage peut générer. La valeur par défaut est 50. Si ce paramètre est défini sur 0, aucune limite n'est imposée ; toutefois, la sortie reste contrainte par les capacités intrinsèques du modèle ainsi que par le paramètre max_tokens. En cas de dépassement, la sortie est tronquée.
model_parameters : Facultatif. Chaîne (STRING) spécifiant les paramètres du modèle, tels que max_tokens, temperature et top_p. Le format attendu est une chaîne JSON :

'{"max_tokens": 500, "temperature": 0.6, "top_p": 0.95}'.
- max_tokens : Nombre maximal de jetons générés lors d'un seul appel au modèle. Pour les modèles publics de MaxCompute, la valeur par défaut est 4 096.
- temperature : Valeur comprise entre 0 et 1 contrôlant le degré d'aléatoire de la sortie. Une valeur élevée favorise des résultats plus créatifs et diversifiés, tandis qu'une valeur faible produit des sorties plus déterministes et conservatrices.
- top_p : Valeur comprise entre 0 et 1 limitant l'éventail des candidats parmi lesquels le modèle peut choisir. Une valeur élevée élargit la gamme des possibilités et accroît la diversité, alors qu'une valeur faible restreint le champ des choix et produit des résultats plus ciblés.

Valeur de retour

Renvoie une chaîne (STRING) contenant le résumé du texte d'entrée. Une erreur est renvoyée dans les cas suivants :

Le paramètre input n'est pas de type STRING.
Le paramètre max_words a la valeur NULL.

Exemples

Exemple 1 : Résumé avec la limite de mots par défaut

Appelez le modèle public qwen3.7-max pour générer un résumé de texte en appliquant la limite par défaut de 50 mots.

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. |
+------+

Exemple 2 : Résumé avec une limite de mots spécifiée

Utilisez le modèle public deepseek-v4-pro pour générer par lots les résumés de plusieurs articles, avec une limite de 30 mots.

-- 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.              |
+-------------------------------------------------------+--------------------------------------------------------------------+

FAQ

Résolution des problèmes courants liés aux modèles publics

Symptôme : L'appel à un modèle public pris en charge par le service de calcul de modèles renvoie l'erreur suivante :

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

Cause : Le service de calcul de modèles n'est pas activé dans la région de votre projet, par exemple Chine (Shanghai), ce qui empêche l'accès aux ressources d'inférence IA.

Solution : Accédez à la console Alibaba Cloud et activez le service de calcul de modèles pour la région de votre projet. Pour obtenir des instructions détaillées, consultez la rubrique Acheter et utiliser le service de calcul de modèles MaxCompute.