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 |
|
China (Pequim) |
|
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.Propriedades do objeto de pergunta
Propriedades do objeto de pergunta
String · ObrigatórioTipo de pergunta:choice: escolha únicanoul: sim/nãoscore: escala ordinal
String · OpcionalDescrição da pergunta ou critérios de julgamento.criteria · Object / Array · Depende do tipochoice: um mapa de nome da opção → descrição da opção (1–255 itens; recomenda-se fornecer todas as opções e uma alternativaother).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).
- 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).
choiceopções: ≤ 255.scoreníveis: 2–255 (recomendado: 3–7).- Contexto: máximo de 65536 tokens; um
statemuito 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.decisione geram umAttributeError). Instale compip install -U "dashscope>=2.0.1". Consulte Instalar o SDK. O SDK monta automaticamente o endpoint/compatible-mode/v1/systemonea 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 ambienteDASHSCOPE_API_KEY. - Em caso de falha, o SDK do Python lança uma exceção
DashScopeErrore o SDK do Java lança umaApiException.
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
choice), escalonamento (noul) e gravidade (score). O exemplo abaixo usa a região de Singapura.- DashScope Python
- DashScope Java
- TypeSafe Python
- curl
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.Propriedades do objeto de resposta
Propriedades do objeto de resposta
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.ObjectInformações de medição de uso:input_tokens(Integer): número de tokens de entrada.
FloatLatência do lado do servidor (milissegundos).