Panggil POST /compatible-mode/v1/systemone untuk menggunakan model keputusan Bailian (decision-model-preview), yang mengembalikan klasifikasi, skor, dan keputusan ya/tidak beserta distribusi probabilitas lengkap dan tingkat keyakinan dalam satu kali forward pass tanpa menghasilkan teks. Cocok untuk keputusan terstruktur berfrekuensi tinggi seperti perutean tiket, moderasi konten, perutean agen, dan verifikasi hasil.
Prasyarat
Anda telah membuat API Key dan menetapkannya sebagai variabel lingkungan DASHSCOPE_API_KEY. Untuk informasi selengkapnya, lihat Mengonfigurasi API key dalam variabel lingkungan.
Permintaan
Protokol: TypeSafe System One (POST /compatible-mode/v1/systemone)
Satu permintaan memuat state bisnis dan beberapa pertanyaan bertipe (choice / noul / score). Model mengembalikan hasil keputusan dan distribusi probabilitas setiap pertanyaan dalam satu kali forward pass. choice dan score juga mengembalikan tingkat keyakinan. Model tidak menghasilkan teks, sehingga latensi dan biaya tidak bergantung pada panjang output.
Endpoint
Ganti {WorkspaceId} dengan ID workspace Anda. Lihat Wilayah dan endpoint.
Wilayah | Endpoint |
|---|---|
Singapura |
|
Tiongkok (Beijing) |
|
Parameter Permintaan
Content-Type ·String · Header · WajibJenis permintaan: application/json.Authorization · String · Header · WajibAPI key, dengan format: Bearer $DASHSCOPE_API_KEY.model · String · Isi · WajibNama model: decision-model-preview.state · String / Object / Array · Isi · WajibStatus bisnis yang menjadi dasar keputusan: teks tiket, percakapan, atau objek terstruktur (objek diserialisasi sebelum dikirim ke model).questions · Object · Isi · WajibPeta pertanyaan. Kunci adalah ID pertanyaan yang ditentukan pemanggil; nilainya berupa objek pertanyaan dengan field berikut.Properti objek pertanyaan
Properti objek pertanyaan
String · WajibJenis pertanyaan:choice: pilihan tunggalnoul: ya/tidakscore: skala ordinal
String · OpsionalDeskripsi pertanyaan atau kriteria penilaian.criteria · Object / Array · Bergantung pada jenischoice: peta nama opsi → deskripsi opsi (1–255 item; disarankan menyediakan semua opsi dan opsi cadanganother).noul: deskripsi opsional{"true":…, "false":…}.score: array deskripsi tingkat dari rendah ke tinggi (2–10 tingkat; disarankan 3–7 tingkat yang dapat dibedakan dengan jelas).
- Tidak ada batas tetap untuk jumlah pertanyaan (disarankan: ≤ 16; latensi meningkat hampir secara linear terhadap jumlah pertanyaan).
choiceopsi: ≤ 255.scoretingkat: 2–255 (disarankan 3–7).- Konteks: maksimum 65536 token;
stateyang terlalu panjang ditolak atau dipotong.
Contoh Permintaan
DashScope SDK telah mendukung model keputusan (kompatibel dengan protokol TypeSafe System One):- Python: DashScope SDK 2.0.1 atau yang lebih baru (model keputusan adalah kemampuan baru pada versi 2.0.1; versi sebelumnya tidak memiliki antarmuka
client.decisiondan akan memunculkanAttributeError). Instal denganpip install -U "dashscope>=2.0.1". Lihat Menginstal SDK. SDK otomatis menyusun endpoint/compatible-mode/v1/systemonedari workspace dan wilayah Anda. - Java: DashScope SDK 2.23.3 atau yang lebih baru (model keputusan adalah kemampuan baru pada versi 2.23.3; versi sebelumnya tidak memiliki paket
com.alibaba.dashscope.decision). Koordinat Maven:com.alibaba:dashscope-sdk-java:2.23.3(Gradle:implementation group: 'com.alibaba', name: 'dashscope-sdk-java', version: '2.23.3'). Kunci API secara default dibaca dari variabel lingkunganDASHSCOPE_API_KEY. - Jika panggilan gagal, SDK Python memunculkan pengecualian
DashScopeErrordan SDK Java memunculkanApiException.
typesafe-sdk) dengan base_url mengarah ke gateway Bailian. SDK otomatis menambahkan /v1/systemone dan mengurai respons. Instal dengan pip install typesafe-sdk.- Perutean tiket
- Keputusan ya/tidak
choice), eskalasi (noul), dan tingkat keparahan (score). Contoh berikut menggunakan wilayah Singapura.- DashScope Python
- DashScope Java
- TypeSafe Python
- curl
Parameter Respons
model ·StringNama model yang dikembalikan.request_id · StringID permintaan untuk pemecahan masalah.answers · ObjectPeta jawaban. Kunci sesuai dengan ID pertanyaan dalam permintaan; nilainya berupa objek jawaban dengan field berikut.Properti objek jawaban
Properti objek jawaban
StringSama dengan jenis pertanyaan (choice / noul / score).choice · StringUntuk choice: nama opsi yang dipilih.noul · FloatUntuk noul: P(yes), dengan 0 = tidak dan 1 = ya.score · FloatUntuk score: nilai harapan indeks tingkat yang dibobot berdasarkan probabilitas, yang dapat berada di antara dua tingkat (misalnya 1.43).probabilities · ObjectProbabilitas setiap opsi/tingkat (totalnya 1).confidence · FloatTingkat keyakinan jawaban (dikembalikan untuk choice / score).legend · ObjectUntuk score: peta indeks tingkat → deskripsi tingkat.ObjectInformasi pengukuran penggunaan:input_tokens(Integer): jumlah token input.
FloatLatensi sisi server (milidetik).