Visão geral
Uma camada de decisão para software.
O JEVaaS recebe contexto e perguntas com formato definido. A aplicação consumidora decide o que fazer com as respostas e controla a execução.
Resultados tipados
Respostas em formato que o código pode validar e encaminhar.
Perguntas paralelas
Avalie múltiplas perguntas sobre o mesmo estado enviado.
Confiança
Use o resultado conforme os critérios do seu produto.
Quickstart
Faça a primeira chamada.
Instale o SDK TypeScript e guarde a chave em uma variável de ambiente.
npm install @jevaas/sdk
const jevaas = new Jevaas({
apiKey: process.env.JEVAAAS_API_KEY
});
const result = await jevaas.judge({
contract: "ticket-router",
decision_id: "ticket_9931",
state: { ticket: { message: "Preciso de ajuda" } }
});Ver exemplos TypeScript, Python, Go, CLI e MCP →
Cookbook: da primeira chamada à decisão em produção →
Cookbook: revisor com teto de rodadas →
Viés e decisões reguladas: o que medimos e como reduzir o risco →
Boas práticas de decisão: perguntas, estado, divergência e texto não confiável →
Entrada
Forneça o contexto necessário.
Use texto ou JSON estruturado conforme os dados que a decisão precisa considerar. Evite incluir dados que não sejam necessários.
Tipos de pergunta
Escolha o formato de resposta.
Choice
Escolhe uma opção em conjunto limitado de respostas.
choice · probabilities · confidenceScore
Avalia o estado conforme uma rubrica ordenada.
score · legend · confidenceNoul
Estima probabilidade para uma questão de sim ou não.
noul · yes probabilityResposta
Resultados para o seu código.
Uma decisão pode incluir o identificador do recibo, rota, resultados tipados, confiança, consumo e estado. O conteúdo exato depende do endpoint utilizado.
Referência
Especificação OpenAPI.
Consulte a especificação publicada para endpoints, esquemas e códigos de resposta.
Erros e retries
Trate timeout com cuidado.
Use o mesmo decision_id em retries da mesma decisão. Um timeout após o envio pode significar que o uso ocorreu; acompanhe o estado de reconciliação antes de iniciar uma chamada lógica nova.