Katuokdocs
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 (setor, categoria, assunto)escolha, probabilidades, certeza
sim_naoVocê quer saber se uma propriedade está presente (é golpe? cita a lei?)sim (probabilidade de sim), resposta, certeza
notaA resposta fica numa escala ordenada (gravidade, irritação, qualidade)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.

"assunto": {
  "tipo": "escolha",
  "instrucao": "Qual é o assunto principal da mensagem?",
  "opcoes": {
    "Entrega": "atraso, rastreio, transportadora, endereço",
    "Pagamento": "boleto, cartão, Pix, cobrança indevida",
    "Produto": "defeito, dúvida de uso, peça faltando"
  }
}

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".

"cita_prazo": {
  "tipo": "sim_nao",
  "instrucao": "O cliente menciona uma data ou prazo?",
  "criterio": "aparece uma data, dia da semana, evento ou prazo próximo"
}

Resposta:

"cita_prazo": { "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.

"irritacao": {
  "tipo": "nota",
  "instrucao": "Qual o nível de irritação do cliente?",
  "niveis": { "1": "calmo", "2": "incomodado", "3": "irritado", "4": "furioso" }
}

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 uma fila (quem está mais irritado primeiro) e a nota para mostrar a uma pessoa.

"irritacao": { "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 cliente está irritado e quer cancelar?" são duas perguntas: separe e combine no seu código.