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 |
|
Chine (Pékin) |
|
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.Propriétés de l’objet question
Propriétés de l’objet question
String · ObligatoireType de question :choice: choix uniquenoul: oui/nonscore: échelle ordinale
String · FacultatifDescription de la question ou critères de jugement.criteria · Object / Array · Dépend du typechoice: 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 repliother).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).
- Aucune limite fixe du nombre de questions (recommandation : ≤ 16 ; la latence augmente de façon quasi linéaire avec le nombre de questions).
choiceoptions : ≤ 255.scoreniveaux : 2 à 255 (3 à 7 recommandés).- Contexte : 65536 tokens au maximum ; un
statetrop 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.decisionet lèvent uneAttributeError). 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’environnementDASHSCOPE_API_KEY. - En cas d’échec, le SDK Python lève une exception
DashScopeErroret le SDK Java lève uneApiException.
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
choice), escalade (noul) et gravité (score). L’exemple ci-dessous utilise la région de Singapour.- DashScope Python
- DashScope Java
- TypeSafe Python
- curl
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.Propriétés de l’objet réponse
Propriétés de l’objet réponse
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.ObjectInformations de mesure de l’utilisation :input_tokens(Integer) : nombre de tokens d’entrée.
FloatLatence côté serveur (millisecondes).