“System One” não é nome comercial de um modelo: é o nome de uma classe. Segundo a documentação oficial, modelos System One são feitos para tomar decisões rápidas e estruturadas que o software usa direto. O Jev é o primeiro modelo dessa classe e o carro-chefe da TypeSafe.
A definição parece abstrata até você olhar o contrato de entrada e saída. Entra um state — o conteúdo a avaliar — e um mapa de perguntas tipadas. Sai um valor por pergunta, com a distribuição de probabilidade e, em dois dos três tipos, a confiança. Nenhuma frase para interpretar.
O que ele faz e o que ele não faz
Um modelo System One entende linguagem natural, como um LLM. A diferença está na saída. A documentação lista o que ele não faz: não escreve respostas, não produz código e não gera explicação do próprio raciocínio. Você define o espaço de respostas possíveis pelas primitivas.
| Primitiva | Pergunta que ela responde | Exemplo de espaço de resposta |
|---|---|---|
| Choice | Qual destas opções? | cobranca, tecnico ou conta |
| Score | Qual nível desta régua? | 0 calmo, 1 irritado, 2 muito irritado |
| Noul | Isto é verdade? | verdadeiro ou falso, com probabilidade |
Essa restrição é o produto. Como o conjunto de respostas é definido antes, o código nunca precisa recuperar um valor de dentro de uma prosa, e não existe resposta fora do formato. O que sobra para o seu lado é a parte que sempre foi sua: decidir o que fazer com o número.
Calibração, com a ressalva que a documentação faz
Modelos System One são treinados para decisões calibradas: as probabilidades são otimizadas contra desfechos para refletir incerteza. Em português claro, a intenção é que 0,7 signifique aproximadamente setenta por cento de chance, e não apenas “provavelmente”.
Aqui vem a frase que merece destaque, e ela é da própria documentação: a calibração é medida em grupos de previsões e não garante que uma resposta individual esteja correta. Isso muda como você usa o número. Você não ganha certeza em cada caso; ganha uma escala que se comporta de forma estável ao longo de muitos casos. Um sistema que decide milhares de vezes por dia aproveita isso. Uma decisão única e irreversível continua pedindo cuidado — e é exatamente para isso que existe confiança.
O nome vem de Kahneman
A documentação explica a escolha: o nome remete à distinção popularizada por Daniel Kahneman em Rápido e devagar, entre o pensamento rápido e intuitivo (Sistema 1) e o raciocínio lento e deliberado (Sistema 2). A ênfase está no julgamento rápido e focado.
Vale ler a metáfora com cuidado, porque ela tem um lado ruim: no livro, o Sistema 1 é também a fonte dos vieses. A TypeSafe usa o nome para falar de velocidade e foco, não para prometer intuição infalível. O contraponto útil é o critério de uso que a própria documentação repete: peça o julgamento que uma pessoa competente faria em um segundo, com o contexto na mão. “Esta mensagem transmite urgência?” é uma boa pergunta. “Analise esta mensagem e determine a melhor linha de ação” não é.
Como isso entra num fluxo real
O exemplo que a documentação usa é um pedido de reembolso, e ele mostra a divisão de trabalho:
- O seu código monta um state com a mensagem do cliente, as transações relevantes e a política de reembolso.
- Você faz perguntas independentes juntas: se houve pedido de reembolso, se as evidências indicam cobrança duplicada, se a política sustenta o reembolso.
- O código combina as respostas com verificações determinísticas e roteia o caso para ação ou revisão.
Repare em quem manda: o código. O modelo responde perguntas estreitas; a decisão final é composta por você. É essa inversão que faz a arquitetura ficar previsível, e é o motivo de o pilar o que é Jev insistir que a mudança é de contrato, não de potência.
Como chamar
A chamada é uma requisição HTTP ou uma linha de SDK. O campo model escolhe quem
responde; os exemplos da documentação usam jev-latest, que é também o padrão dos
SDKs oficiais.
{
"state": "Fiz a atualização ontem e o sistema não abre mais.",
"model": "jev-latest",
"questions": {
"urgente": {
"type": "noul",
"instructions": "A mensagem transmite urgência?"
}
}
}
A resposta chega com um campo por pergunta, sob o identificador que você
escolheu, e o model informa a versão exata que respondeu — útil para registrar
qual modelo produziu cada decisão, já que um alias pode se mover.
O próximo passo natural é aprender a montar bem a entrada, em state, e a ler a incerteza, em confiança. O índice completo do vocabulário está em conceitos.
Perguntas frequentes
System One é um LLM menor?
Não. Segundo a documentação oficial, é outra classe de modelo: entende linguagem natural como um LLM, mas devolve decisões tipadas e probabilidades em vez de texto gerado. Não escreve respostas, não produz código e não explica o raciocínio.
De onde vem o nome System One?
Do conceito que Daniel Kahneman popularizou em Rápido e devagar: o Sistema 1 é o julgamento rápido e intuitivo, o Sistema 2 é o raciocínio lento e deliberado. A documentação usa o nome para marcar a ênfase em julgamentos rápidos e focados.
Calibrado quer dizer que a resposta está certa?
Não, e a documentação oficial é explícita: a calibração é medida em grupos de previsões e não garante que uma resposta individual esteja correta. O que ela oferece é que os números signifiquem algo estável ao longo de muitas decisões.
Que tipo de entrada o Jev aceita?
Somente texto: string, objeto JSON ou lista de textos. Imagem, áudio e vídeo não são aceitos, segundo a documentação. Conteúdo que não é texto precisa ser convertido antes de virar state.
Como eu chamo um modelo System One?
Por um dos SDKs oficiais ou por POST em https://api.typesafe.ai/v1/systemone, com o campo model escolhendo quem responde. Os exemplos da documentação usam jev-latest, que também é o padrão dos SDKs.