Skip to main content

API du modèle de décision

Appelez POST /compatible-mode/v1/systemone pour utiliser le modèle de décision Bailian (decision-model-preview), qui renvoie des classifications, des scores et des décisions oui/non avec des distributions complètes de probabilités et des niveaux de confiance en une seule passe de propagation avant, sans générer de texte. Il convient aux décisions structurées à haute fréquence, telles que le routage des tickets, la modération de contenu, le routage des agents et la vérification des résultats.

Prérequis

Vous avez créé une clé API et l’avez définie dans la variable d’environnement DASHSCOPE_API_KEY. Pour plus d’informations, consultez Configurer une clé API dans les variables d’environnement.

Requête

Protocole: TypeSafe System One (POST /compatible-mode/v1/systemone) Une requête contient le state métier et plusieurs questions typées (choice / noul / score). Le modèle renvoie le résultat de décision et la distribution de probabilités de chaque question en une passe de propagation avant ; choice et score renvoient également un niveau de confiance. Il ne génère pas de texte : la latence et le coût ne dépendent donc pas de la longueur de sortie. Point de terminaison Remplacez {WorkspaceId} par l’ID de votre espace de travail. Consultez Régions et points de terminaison.

Région

Point de terminaison

Singapour

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

Chine (Pékin)

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

Paramètres de requête

Content-Type · String · En-tête · ObligatoireType de requête : application/json.Authorization · String · En-tête · ObligatoireClé API, au format : Bearer $DASHSCOPE_API_KEY.model · String · Corps · ObligatoireNom du modèle : decision-model-preview.state · String / Object / Array · Corps · ObligatoireL’état métier sur lequel portent les décisions : texte d’un ticket, conversation ou objet structuré (les objets sont sérialisés avant d’être envoyés au modèle).questions · Object · Corps · ObligatoireUne table de questions. La clé est un ID de question défini par l’appelant ; la valeur est un objet question contenant les champs suivants.
type · String · ObligatoireType de question :
  • choice: choix unique
  • noul: oui/non
  • score: échelle ordinale
instructions · String · FacultatifDescription de la question ou critères de jugement.criteria · Object / Array · Dépend du type
  • choice: une table nom de l’option → description de l’option (1 à 255 éléments ; il est recommandé de fournir toutes les options et une option de repli other).
  • noul: descriptions facultatives {"true":…, "false":…}.
  • score: un tableau de descriptions des niveaux, du plus bas au plus haut (2 à 10 niveaux ; 3 à 7 niveaux clairement distincts sont recommandés).
Limites et recommandations
  • Aucune limite fixe du nombre de questions (recommandation : ≤ 16 ; la latence augmente de façon quasi linéaire avec le nombre de questions).
  • choice options : ≤ 255.
  • score niveaux : 2 à 255 (3 à 7 recommandés).
  • Contexte : 65536 tokens au maximum ; un state trop long est rejeté ou tronqué.

Exemples de requêtes

Les SDK DashScope prennent déjà en charge le modèle de décision (compatibles avec le protocole TypeSafe System One) :
  • Python : SDK DashScope 2.0.1 ou version ultérieure (le modèle de décision est une capacité nouvelle de la version 2.0.1 ; les versions antérieures ne disposent pas de l’interface client.decision et lèvent une AttributeError). Installation : pip install -U "dashscope>=2.0.1". Voir Installer le SDK. Le SDK construit automatiquement le point de terminaison /compatible-mode/v1/systemone à partir de l’espace de travail et de la région.
  • Java : SDK DashScope 2.23.3 ou version ultérieure (le modèle de décision est une capacité nouvelle de la version 2.23.3 ; les versions antérieures ne disposent pas du package com.alibaba.dashscope.decision). Coordonnées Maven : com.alibaba:dashscope-sdk-java:2.23.3 (Gradle : implementation group: 'com.alibaba', name: 'dashscope-sdk-java', version: '2.23.3'). La clé API est lue par défaut dans la variable d’environnement DASHSCOPE_API_KEY.
  • En cas d’échec, le SDK Python lève une exception DashScopeError et le SDK Java lève une ApiException.
Vous pouvez également utiliser le SDK TypeSafe générique (typesafe-sdk) avec base_url pointant vers la passerelle Bailian. Le SDK ajoute automatiquement /v1/systemone et analyse la réponse. Installation : pip install typesafe-sdk.
  • Routage des tickets
  • Décision oui/non
Une requête traite trois décisions à la fois : affectation d’équipe (choice), escalade (noul) et gravité (score). L’exemple ci-dessous utilise la région de Singapour.
  • DashScope Python
  • DashScope Java
  • TypeSafe Python
  • curl
import os

import dashscope

# Voici la configuration pour la région de Singapour. Remplacez "{WorkspaceId}" par l'ID réel de votre espace de travail. La configuration diffère selon la région.
# Le point de terminaison du modèle de décision se trouve toujours sous le chemin compatible-mode de la passerelle de l'espace de travail ; le SDK le construit à partir de l'espace de travail et de la région.
client = dashscope.Client(
    # Si vous n'utilisez pas de variable d'environnement, remplacez la ligne suivante par votre clé API Model Studio : 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)   # option sélectionnée
print(result.answers["escalate"].noul)       # P(yes)
print(result.answers["severity"].score)      # indice de niveau pondéré par probabilité
print(result.usage.input_tokens, result.latency_ms)

Paramètres de réponse

model · StringNom du modèle renvoyé.request_id · StringID de requête, utilisé pour le dépannage.answers · ObjectUne table de réponses. La clé correspond à l’ID de question dans la requête ; la valeur est un objet réponse contenant les champs suivants.
type · StringCorrespond au type de question (choice / noul / score).choice · StringPour choice : le nom de l’option sélectionnée.noul · FloatPour noul : P(yes), où 0 = non et 1 = oui.score · FloatPour score : l’espérance de l’indice de niveau pondérée par les probabilités, qui peut se situer entre deux niveaux (par exemple 1.43).probabilities · ObjectLa probabilité de chaque option/niveau (la somme est égale à 1).confidence · FloatLe niveau de confiance de la réponse (renvoyé pour choice / score).legend · ObjectPour score : une table indice de niveau → description du niveau.
usage · ObjectInformations de mesure de l’utilisation :
  • input_tokens (Integer) : nombre de tokens d’entrée.
latency_ms · FloatLatence côté serveur (millisecondes).

Exemple de réponse

Voici la réponse de l’exemple de routage des tickets (abrégée). Les probabilités et le niveau de confiance dépendent du résultat réel.
{
  "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
}

Codes d’erreur

Si l’appel échoue, un message d’erreur est renvoyé. Pour d’autres codes d’erreur et leurs solutions, consultez Messages d’erreur.