Llame a POST /compatible-mode/v1/systemone para utilizar el modelo de decisión Bailian (decision-model-preview), que devuelve clasificación, puntuación y decisiones sí/no con distribuciones de probabilidad completas y confianza en una sola pasada hacia adelante, sin generar texto. Adecuado para decisiones estructuradas de alta frecuencia como el enrutamiento de tickets, la moderación de contenido, el enrutamiento de agentes y la verificación de resultados.
Requisitos previos
Ha creado una Clave API y la ha configurado como la variable de entorno DASHSCOPE_API_KEY. Para obtener más información, consulte Configurar una clave API en variables de entorno.
Solicitud
Protocol: TypeSafe System One (POST /compatible-mode/v1/systemone)
Una sola solicitud transporta el state empresarial y varias preguntas tipadas (choice / noul / score). El modelo devuelve el resultado de la decisión y la distribución de probabilidad para cada pregunta en una sola pasada hacia adelante, con choice y score devolviendo adicionalmente la confianza, y no genera texto, por lo que la latencia y el costo son independientes de la longitud de salida.
Endpoint
Reemplace {WorkspaceId} con su ID de espacio de trabajo. Consulte Regiones y endpoints.
Región | Endpoint |
|---|---|
Singapur |
|
China (Beijing) |
|
Parámetros de solicitud
Content-Type ·String · Encabezado · ObligatorioTipo de solicitud: application/json.Authorization · String · Encabezado · ObligatorioClave API, en el formato: Bearer $DASHSCOPE_API_KEY.model · String · Cuerpo · ObligatorioNombre del modelo: decision-model-preview.state · String / Object / Array · Cuerpo · ObligatorioEl estado empresarial sobre el cual tomar decisiones: texto del ticket, una conversación o un objeto estructurado (los objetos se serializan antes de enviarse al modelo).questions · Object · Cuerpo · ObligatorioUn mapa de preguntas. La clave es un id de pregunta definido por el llamante; el valor es un objeto de pregunta con los siguientes campos.Propiedades del objeto de pregunta
Propiedades del objeto de pregunta
String · ObligatorioTipo de pregunta:choice: opción únicanoul: sí/noscore: escala ordinal
String · OpcionalDescripción de la pregunta o criterios de juicio.criteria · Object / Array · Depende del tipochoice: un mapa de nombre de opción → descripción de opción (1–255 elementos; se recomienda proporcionar todas las opciones y un valor de respaldoother).noul: descripciones opcionales{"true":…, "false":…}.score: un arreglo de descripciones de nivel de bajo a alto (2–255 niveles; se recomiendan 3–7 niveles claramente distinguibles).
- Máximo 16 preguntas (la latencia crece casi linealmente con el número de preguntas).
- Opciones de
choice: ≤ 255. - Niveles de
score: 2–255 (se recomiendan 3–7). - Contexto: máximo 65536 tokens; un
stateexcesivamente largo se rechaza.
Ejemplos de solicitud
Los SDK de DashScope ya son compatibles con el modelo de decisión (compatibles con el protocolo TypeSafe System One):- Python: SDK de DashScope 2.0.1 o posterior (el modelo de decisión es una capacidad nueva de la versión 2.0.1; las versiones anteriores no tienen la interfaz
client.decisiony generan unAttributeError). Instalación:pip install -U "dashscope>=2.0.1". Consulte Instalar el SDK. El SDK construye automáticamente el endpoint/compatible-mode/v1/systemonea partir del espacio de trabajo y la región. - Java: SDK de DashScope 2.23.3 o posterior (el modelo de decisión es una capacidad nueva de la versión 2.23.3; las versiones anteriores no tienen el paquete
com.alibaba.dashscope.decision). Coordenadas de Maven:com.alibaba:dashscope-sdk-java:2.23.3(Gradle:implementation group: 'com.alibaba', name: 'dashscope-sdk-java', version: '2.23.3'). La clave API se lee de forma predeterminada de la variable de entornoDASHSCOPE_API_KEY. - En caso de error, el SDK de Python genera una excepción
DashScopeErrory el SDK de Java genera unaApiException.
typesafe-sdk) con base_url apuntando a la puerta de enlace Bailian. El SDK agrega automáticamente /v1/systemone y analiza la respuesta. Instalación: pip install typesafe-sdk.- Enrutamiento de tickets
- Decisión sí/no
choice), escalación (noul) y gravedad (score). El siguiente ejemplo utiliza la región de Singapur.- DashScope Python
- DashScope Java
- TypeSafe Python
- curl
Parámetros de respuesta
model ·StringNombre del modelo devuelto.request_id · StringID de solicitud, para solución de problemas.answers · ObjectUn mapa de respuestas. La clave corresponde al id de pregunta en la solicitud; el valor es un objeto de respuesta con los siguientes campos.Propiedades del objeto de respuesta
Propiedades del objeto de respuesta
StringCoincide con el tipo de pregunta (choice / noul / score).choice · StringPara choice: el nombre de la opción seleccionada.noul · FloatPara noul: P(sí), donde 0 = no y 1 = sí.score · FloatPara score: la expectativa ponderada por probabilidad del índice de nivel, que puede situarse entre dos niveles (p. ej., 1.43).probabilities · ObjectLa probabilidad de cada opción/nivel (suma 1).confidence · FloatLa confianza de la respuesta (devuelta para choice / score).legend · ObjectPara score: un mapa de índice de nivel → descripción de nivel.ObjectInformación de medición:input_tokens(Integer): número de tokens de entrada.
FloatLatencia del lado del servidor (milisegundos).