Skip to main content

API do modelo de decisão

Chame POST /compatible-mode/v1/systemone para usar o modelo de decisão Bailian (decision-model-preview), que retorna classificações, pontuações e decisões de sim/não com distribuições completas de probabilidade e níveis de confiança em uma única passagem de propagação direta, sem gerar texto. É adequado para decisões estruturadas de alta frequência, como roteamento de chamados, moderação de conteúdo, roteamento de agentes e verificação de resultados.

Pré-requisitos

Você criou uma API Key e a definiu como a variável de ambiente DASHSCOPE_API_KEY. Para obter mais informações, consulte Configurar uma chave de API em variáveis de ambiente.

Solicitação

Protocolo: TypeSafe System One (POST /compatible-mode/v1/systemone) Uma única solicitação contém o state do negócio e várias perguntas tipadas (choice / noul / score). O modelo retorna o resultado da decisão e a distribuição de probabilidade de cada pergunta em uma passagem de propagação direta; choice e score também retornam o nível de confiança. Como não gera texto, a latência e o custo não dependem do comprimento da saída. Endpoint Substitua {WorkspaceId} pelo ID do seu espaço de trabalho. Consulte Regiões e endpoints.

Região

Endpoint

Singapura

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

China (Pequim)

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

Parâmetros da solicitação

Content-Type · String · Cabeçalho · ObrigatórioTipo de solicitação: application/json.Authorization · String · Cabeçalho · ObrigatórioChave de API, no formato: Bearer $DASHSCOPE_API_KEY.model · String · Corpo · ObrigatórioNome do modelo: decision-model-preview.state · String / Object / Array · Corpo · ObrigatórioO estado do negócio usado para tomar decisões: texto de um chamado, uma conversa ou um objeto estruturado (os objetos são serializados antes de serem enviados ao modelo).questions · Object · Corpo · ObrigatórioUm mapa de perguntas. A chave é um ID de pergunta definido pelo chamador; o valor é um objeto de pergunta com os campos a seguir.
type · String · ObrigatórioTipo de pergunta:
  • choice: escolha única
  • noul: sim/não
  • score: escala ordinal
instructions · String · OpcionalDescrição da pergunta ou critérios de julgamento.criteria · Object / Array · Depende do tipo
  • choice: um mapa de nome da opção → descrição da opção (1–255 itens; recomenda-se fornecer todas as opções e uma alternativa other).
  • noul: descrições opcionais {"true":…, "false":…}.
  • score: um array de descrições dos níveis, do menor para o maior (2–10 níveis; recomendam-se 3–7 níveis claramente distinguíveis).
Limites e recomendações
  • Não há limite fixo para o número de perguntas (recomendado: ≤ 16; a latência cresce de forma quase linear com o número de perguntas).
  • choice opções: ≤ 255.
  • score níveis: 2–255 (recomendado: 3–7).
  • Contexto: máximo de 65536 tokens; um state muito longo é rejeitado ou truncado.

Exemplos de solicitação

Os SDKs do DashScope já oferecem suporte ao modelo de decisão (compatíveis com o protocolo TypeSafe System One):
  • Python: DashScope SDK 2.0.1 ou posterior (o modelo de decisão é uma capacidade nova da versão 2.0.1; versões anteriores não têm a interface client.decision e geram um AttributeError). Instale com pip install -U "dashscope>=2.0.1". Consulte Instalar o SDK. O SDK monta automaticamente o endpoint /compatible-mode/v1/systemone a partir do espaço de trabalho e da região.
  • Java: DashScope SDK 2.23.3 ou posterior (o modelo de decisão é uma capacidade nova da versão 2.23.3; versões anteriores não têm o pacote com.alibaba.dashscope.decision). Coordenadas do Maven: com.alibaba:dashscope-sdk-java:2.23.3 (Gradle: implementation group: 'com.alibaba', name: 'dashscope-sdk-java', version: '2.23.3'). A chave de API é lida por padrão da variável de ambiente DASHSCOPE_API_KEY.
  • Em caso de falha, o SDK do Python lança uma exceção DashScopeError e o SDK do Java lança uma ApiException.
Você também pode usar o TypeSafe SDK genérico (typesafe-sdk) com base_url apontando para o gateway Bailian. O SDK acrescenta /v1/systemone automaticamente e interpreta a resposta. Instale com pip install typesafe-sdk.
  • Roteamento de chamados
  • Decisão de sim/não
Uma única solicitação trata três decisões ao mesmo tempo: atribuição de equipe (choice), escalonamento (noul) e gravidade (score). O exemplo abaixo usa a região de Singapura.
  • DashScope Python
  • DashScope Java
  • TypeSafe Python
  • curl
import os

import dashscope

# A seguir, a configuração para a região de Singapura. Substitua "{WorkspaceId}" pelo ID real do seu workspace. A configuração varia entre as regiões.
# O endpoint do modelo de decisão sempre fica sob o caminho compatible-mode do gateway do workspace; o SDK o monta a partir do workspace e da região.
client = dashscope.Client(
    # Se não estiver usando uma variável de ambiente, substitua a linha a seguir pela sua chave de API do 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)   # opção selecionada
print(result.answers["escalate"].noul)       # P(yes)
print(result.answers["severity"].score)      # índice de nível ponderado por probabilidade
print(result.usage.input_tokens, result.latency_ms)

Parâmetros de resposta

model · StringNome do modelo retornado.request_id · StringID da solicitação, para solução de problemas.answers · ObjectUm mapa de respostas. A chave corresponde ao ID da pergunta na solicitação; o valor é um objeto de resposta com os campos a seguir.
type · StringCorresponde ao tipo de pergunta (choice / noul / score).choice · StringPara choice: o nome da opção selecionada.noul · FloatPara noul: P(yes), em que 0 = não e 1 = sim.score · FloatPara score: a esperança do índice do nível ponderada pela probabilidade, que pode ficar entre dois níveis (por exemplo, 1.43).probabilities · ObjectA probabilidade de cada opção/nível (a soma é 1).confidence · FloatO nível de confiança da resposta (retornado para choice / score).legend · ObjectPara score: um mapa de índice do nível → descrição do nível.
usage · ObjectInformações de medição de uso:
  • input_tokens (Integer): número de tokens de entrada.
latency_ms · FloatLatência do lado do servidor (milissegundos).

Exemplo de resposta

A seguir está a resposta do exemplo de roteamento de chamados (abreviada). As probabilidades e o nível de confiança dependem do resultado real.
{
  "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
}

Códigos de erro

Se a chamada falhar, uma mensagem de erro será retornada. Para mais códigos de erro e soluções, consulte Mensagens de erro.