Guia das primitivas
Choice, Score e Noul
Jev é o modelo System One da TypeSafe. Não é um modelo de chat. Você envia um state e perguntas tipadas, e recebe dados estruturados nos quais o seu código pode ramificar. Ele não escreve um parágrafo. Esta página é a reformulação do JEV Hub para quem constrói. Não é a documentação da TypeSafe. A introdução oficial continua sendo a fonte: docs.typesafe.ai/introduction.
O mesmo state, perguntas separadas
Um pedido pode misturar Choice, Score e Noul. Elas são julgadas contra o mesmo state, separadamente e em paralelo. Acrescentar perguntas não faz com que elas compartilhem contexto.
Choice escolhe em uma lista e devolve uma probabilidade por opção, mais confidence. Score avalia o state numa rubrica e devolve um score, probabilities e confidence. Noul responde se uma afirmação é verdadeira, como uma probabilidade de 0 a 1. Noul não acrescenta um campo confidence separado.
Você pode rodar uma requisição neste site: o Jev Playground a envia para https://api.typesafe.ai/v1/systemone com sua própria chave da TypeSafe e mostra a resposta real.
Uma pergunta estreita
Cada pergunta deve pedir uma única coisa estreita. Se um julgamento tem vários fatores, pergunte cada fator em separado e combine os resultados no seu próprio código.
Um ticket de suporte deixa isso concreto. Não pergunte ao Jev se o ticket foi bem tratado. Pergunte se ele cita um produto, se pede reembolso e se o tom é urgente. O seu código decide como essas três respostas se somam. Se o peso mudar, mude o código, não o texto da pergunta.
State e questions
A orientação oficial coloca o material a julgar em state e os julgamentos em questions. Os ids das perguntas são chaves na resposta; escreva a pergunta inteira em instructions.
Peça um julgamento rápido que uma pessoa informada faria com o contexto certo. “Esta mensagem transmite urgência?” está no escopo. “Analise isto e decida a melhor ação” é um prompt de System 2; divida. Fonte: TypeSafe primitives.
O pedido hospedado que este hub valida é POST https://api.typesafe.ai/v1/systemone com autenticação Bearer e os campos JSON model, state e questions. Trechos da comunidade que acrescentam um campo mode não são a forma oficial.
Choice
Escolha uma opção nomeada de um conjunto fechado. Documentação oficial: acrescente uma opção other quando a lista pode não cobrir cada entrada. Devolve choice, probabilities, confidence.
Use Choice quando as opções têm nome, mas não ordem: cobrança, técnico, outro. A documentação oficial recomenda other se a lista pode estar incompleta. choice é a opção selecionada; probabilities cobre cada opção; confidence resume o quanto essa distribuição está concentrada.
Fonte: Choice primitive.
Score
Coloque o state em níveis ordenados que você define. A nota devolvida pode cair entre dois níveis. Devolve score, legend, probabilities, confidence.
Os níveis são ordenados e numerados a partir de 0. Três descrições significam notas de 0 a 2. A nota devolvida pode ficar entre os níveis. O limiar fica no código da aplicação, não no prompt. legend repete os níveis pelo número.
Fonte: Score primitive.
Noul
Faça uma pergunta de sim ou não. O sinal é a probabilidade; não há um campo confidence separado. Devolve noul (probabilidade de 0 a 1).
Perto de 1 é um sim forte, perto de 0 um não forte, perto de 0,5 incerteza. Critérios opcionais de true/false podem dizer o que conta. Respostas Noul não trazem um campo confidence separado.
Fonte: Noul primitive.
O que este hub não vai afirmar
O JEV Hub não inventa probabilidades nem trata campos de playgrounds da comunidade como oficiais. As respostas do playground vêm da TypeSafe sem alteração. Os ids de modelo aceitos são os documentados: jev-latest, jev-preview e ids versionados como jev-1.13.0. Fixe um id versionado se ajustar limiares.
Continue no Jev Playground, no servidor MCP do Jev ou nos guias de fluxo.