docs
Conceitos

Tipos de pergunta

Três tipos de pergunta cobrem quase toda decisão: escolha, sim/não e nota.

Resumo

TipoUse quandoDevolve
escolhaUma opção de uma lista deve ganhar (especialidade, tipo de risco, destino do lote)escolha, probabilidades, certeza
sim_naoVocê quer saber se uma propriedade está presente (parar o equipamento? exige isolamento?)sim (probabilidade de sim), resposta, certeza
notaA resposta fica numa escala ordenada (gravidade, prioridade, desgaste)nota, probabilidades, media, certeza

Cada pergunta tem um nome que você escolhe. Esse nome volta na resposta.

Escolha

Uma opção vence. As opções vão como um objeto nome: descrição. A descrição é opcional, mas melhora muito o acerto quando os nomes são parecidos.

"esp": {
  "tipo": "escolha",
  "instrucao": "Qual especialidade atende esta ordem?",
  "opcoes": {
    "Mecânica": "desalinhamento, vibração, rolamentos",
    "Elétrica": "motores, quadros, sobrecorrente",
    "Hidráulica": "cilindros, mangueiras, perda de pressão"
  }
}

De 2 a 26 opções por pergunta. Com mais de 6 opções, o acerto cai: veja Opção "nenhuma" e Pontos fracos.

Sim/não

A pergunta mais barata e mais firme. O campo criterio diz o que conta como "sim".

"parar": {
  "tipo": "sim_nao",
  "instrucao": "É preciso parar o equipamento agora?",
  "criterio": "há risco de quebra, acidente ou dano grave se continuar operando"
}

Resposta:

"parar": { "tipo": "sim_nao", "sim": 0.91, "resposta": "sim", "certeza": 0.91 }

Nota

Para escalas em que a ordem importa. Os níveis vão em ordem, do menor para o maior.

"pri": {
  "tipo": "nota",
  "instrucao": "Qual a prioridade da intervenção?",
  "niveis": { "1": "baixa", "2": "média", "3": "alta", "4": "emergência" }
}

Além da nota mais provável, a resposta traz a media: a nota esperada, somando cada nível pela sua probabilidade. Use a média para ordenar a fila (a ordem mais urgente primeiro) e a nota para mostrar a uma pessoa.

"pri": { "tipo": "nota", "nota": "2", "media": 2.25, "certeza": 0.59,
               "probabilidades": { "1": 0.09, "2": 0.59, "3": 0.30, "4": 0.02 } }

Escreva perguntas estreitas

Uma pergunta, uma propriedade. "O vazamento é grave e precisa parar a linha?" são duas perguntas: separe e combine no seu código.