Skip to main content

API Model Keputusan

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

https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/systemone

Tiongkok (Beijing)

https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/systemone

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.
type · String · WajibJenis pertanyaan:
  • choice: pilihan tunggal
  • noul: ya/tidak
  • score: skala ordinal
instructions · String · OpsionalDeskripsi pertanyaan atau kriteria penilaian.criteria · Object / Array · Bergantung pada jenis
  • choice: peta nama opsi → deskripsi opsi (1–255 item; disarankan menyediakan semua opsi dan opsi cadangan other).
  • 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).
Batas dan rekomendasi
  • Tidak ada batas tetap untuk jumlah pertanyaan (disarankan: ≤ 16; latensi meningkat hampir secara linear terhadap jumlah pertanyaan).
  • choice opsi: ≤ 255.
  • score tingkat: 2–255 (disarankan 3–7).
  • Konteks: maksimum 65536 token; state yang 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.decision dan akan memunculkan AttributeError). Instal dengan pip install -U "dashscope>=2.0.1". Lihat Menginstal SDK. SDK otomatis menyusun endpoint /compatible-mode/v1/systemone dari 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 lingkungan DASHSCOPE_API_KEY.
  • Jika panggilan gagal, SDK Python memunculkan pengecualian DashScopeError dan SDK Java memunculkan ApiException.
Anda juga dapat menggunakan TypeSafe SDK generik (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
Satu permintaan menangani tiga keputusan sekaligus: penugasan tim (choice), eskalasi (noul), dan tingkat keparahan (score). Contoh berikut menggunakan wilayah Singapura.
  • DashScope Python
  • DashScope Java
  • TypeSafe Python
  • curl
import os

import dashscope

# Berikut adalah konfigurasi untuk wilayah Singapura. Ganti "{WorkspaceId}" dengan ID workspace Anda yang sebenarnya. Konfigurasi berbeda-beda untuk setiap wilayah.
# Endpoint model keputusan selalu berada di bawah jalur compatible-mode gateway workspace; SDK menyusunnya dari workspace dan region.
client = dashscope.Client(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

result = client.decision.create(
    model="decision-model-preview",
    state={"ticket_id": "T-1001", "content": "More than 24 hours after payment, the order has not been credited."},
    questions={
        "department": {"type": "choice", "instructions": "Which team should handle this?",
                       "criteria": {"billing": "Payment, refund, and billing issues", "technical": "Product failure and integration issues"}},
        "escalate": {"type": "noul", "instructions": "Should on-call staff be notified immediately?"},
        "severity": {"type": "score", "instructions": "How severe is this issue?",
                     "criteria": ["Minor issue, no impact on functionality", "Some functionality affected, but a workaround exists",
                                  "Core functionality unavailable, no workaround", "Severe business or security impact"]},
    },
)

print(result.answers["department"].choice)   # opsi yang dipilih
print(result.answers["escalate"].noul)       # P(yes)
print(result.answers["severity"].score)      # indeks tingkat berbobot probabilitas
print(result.usage.input_tokens, result.latency_ms)

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.
type · 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.
usage · ObjectInformasi pengukuran penggunaan:
  • input_tokens (Integer): jumlah token input.
latency_ms · FloatLatensi sisi server (milidetik).

Contoh Respons

Berikut adalah respons untuk contoh perutean tiket (disingkat). Probabilitas dan tingkat keyakinan bergantung pada hasil sebenarnya.
{
  "model": "decision-model-preview",
  "request_id": "7b986c65-b223-9341-b5f0-b988e27ecaac",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "billing",
      "confidence": 0.88,
      "probabilities": {"billing": 0.94, "technical": 0.06}
    },
    "escalate": {
      "type": "noul",
      "noul": 0.99
    },
    "severity": {
      "type": "score",
      "score": 2.25,
      "confidence": 0.91,
      "legend": {
        "0": "Minor issue, no impact on functionality",
        "1": "Some functionality affected, but a workaround exists",
        "2": "Core functionality unavailable, no workaround",
        "3": "Severe business or security impact"
      },
      "probabilities": {"0": 0.0, "1": 0.01, "2": 0.73, "3": 0.26}
    }
  },
  "usage": {"input_tokens": 125},
  "latency_ms": 52.9
}

Kode Kesalahan

Jika panggilan gagal, pesan kesalahan akan dikembalikan. Untuk kode kesalahan dan solusi lainnya, lihat Pesan kesalahan.