AI_CLASSIFY adalah fungsi SQL MaxCompute yang mengklasifikasikan teks tidak terstruktur dan mengembalikan label yang paling cocok. - MaxCompute

AI_CLASSIFY adalah fungsi AI di MaxCompute yang memanggil model untuk mengembalikan label dari himpunan yang diberikan yang paling sesuai dengan input.

Sintaksis

STRING AI_CLASSIFY(
  STRING <model_name>,
  STRING <version_name>,
  STRING <input>,
  ARRAY<STRING> <labels>
  [, STRING <model_parameters>]
);

Parameter

model_name: Wajib. STRING. Nama model yang akan digunakan. Untuk informasi selengkapnya, lihat fungsi AI SQL.
version_name: Wajib. STRING. Nama versi model yang akan digunakan. Untuk memanggil versi default, tentukan DEFAULT_VERSION.
input: Wajib. STRING. Teks yang ingin Anda klasifikasikan.
labels: Wajib. ARRAY<STRING>. Daftar label kandidat untuk klasifikasi. Parameter ini menerima konstanta dan input kolom. Jika menggunakan konstanta, jumlah label harus antara 2 hingga 20 (inklusif).
model_parameters: Opsional. STRING. Menentukan parameter model seperti max_tokens, temperature, dan top_p. Formatnya berupa string JSON:
'{"max_tokens": 500, "temperature": 0.6, "top_p": 0.95}'.
- max_tokens: Jumlah maksimum token yang dihasilkan dalam satu panggilan model. Untuk model publik MaxCompute, nilai default-nya adalah 4.096.
- temperature: Nilai antara 0 dan 1 yang mengatur tingkat keacakan output. Nilai yang lebih tinggi menghasilkan output yang lebih kreatif dan beragam, sedangkan nilai yang lebih rendah menghasilkan output yang lebih deterministik dan konservatif.
- top_p: Nilai antara 0 dan 1 yang membatasi rentang label kandidat yang dapat dipilih oleh model. Nilai yang lebih tinggi memungkinkan rentang yang lebih luas dan variasi yang lebih besar, sedangkan nilai yang lebih rendah mempersempit rentang dan menghasilkan hasil yang lebih fokus.

Nilai kembalian

Mengembalikan nilai STRING yang merepresentasikan label yang paling sesuai dengan input.

Mengembalikan error jika input bukan STRING atau labels bukan ARRAY<STRING>.
Mengembalikan error jika labels berupa konstanta dan jumlah label-nya 1 atau lebih dari 20.
Mengembalikan NULL jika input atau labels bernilai NULL atau string kosong ("").

Contoh

Contoh 1: Klasifikasikan teks konstan

Memanggil model publik qwen3.7-max yang disediakan oleh MaxCompute untuk mengklasifikasikan teks input dan mengembalikan hasil yang paling sesuai dari label yang diberikan.

SET odps.namespace.schema=true;

SELECT AI_CLASSIFY(
    bigdata_public_modelset.default.`qwen3.7-max`,
    DEFAULT_VERSION,
    'MaxCompute is a fully managed, high-performance big data computing platform that provides fast and scalable data warehousing and analysis capabilities.',
    ARRAY('Technology', 'Sports', 'Finance', 'Healthcare', 'Education')
) AS classified_label;
-- Result
+------------------+
| classified_label |
+------------------+
| Technology       |
+------------------+

Contoh 2: Klasifikasikan data tabel

Anda dapat memanggil model publik MaxCompute deepseek-v4-pro untuk melakukan klasifikasi batch terhadap beberapa entri data teks dalam sebuah tabel.

-- Sample data
CREATE TABLE news_articles (
    content STRING
);

INSERT INTO news_articles VALUES
    ('Artificial intelligence is changing the healthcare industry with new diagnostic tools.'),
    ('Driven by a rally in the tech sector, the stock market hit a record high today.'),
    ('The team won the championship after a thrilling overtime.'),
    ('Cloud computing enables businesses to scale their infrastructure on demand.');

-- Use the model to classify the text in the table
SET odps.namespace.schema=true;

SELECT
    content,
    AI_CLASSIFY(
        bigdata_public_modelset.default.`deepseek-v4-pro`,
        DEFAULT_VERSION,
        content,
        ARRAY('Technology', 'Sports', 'Finance', 'Healthcare')
    ) AS category
FROM news_articles;

-- Result
+------------------------------------------------------------------------------------------+------------+
| content                                                                                  | category   |
+------------------------------------------------------------------------------------------+------------+
| Artificial intelligence is changing the healthcare industry with new diagnostic tools.   | Healthcare |
| Driven by a rally in the tech sector, the stock market hit a record high today.          | Finance    |
| The team won the championship after a thrilling overtime.                                | Sports     |
| Cloud computing enables businesses to scale their infrastructure on demand.              | Technology |
+------------------------------------------------------------------------------------------+------------+

FAQ

Pemecahan masalah terkait model publik

Gejala: Saat Anda memanggil model publik yang didukung oleh MaxCompute Model Computing Service, layanan mengembalikan pesan error berikut:

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

Penyebab: MaxCompute Model Computing Service belum diaktifkan untuk wilayah proyek Anda (misalnya, cn-shanghai). Akibatnya, Anda tidak dapat memanggil sumber daya inferensi AI.

Solusi: Buka Konsol Alibaba Cloud dan aktifkan MaxCompute Model Computing Service untuk wilayah proyek Anda. Untuk informasi selengkapnya, lihat Pembelian dan penggunaan MaxCompute Model Computing Service.