Jev com agentes de código
O que a Jev é (e não é) quando usas um agente de código.
Se chegaste à TypeSafe à procura de um modelo para ligar ao teu agente de código, começa por aqui. A Jev não é um substituto direto do LLM por detrás do Claude Code, Cursor, opencode, Copilot, Muse Spark, Grok Bot ou ferramentas semelhantes. Em vez disso, podes usar o teu agente de código como habitualmente para escrever código que usa a Jev para tomar decisões.
A Jev não é um LLM de chat nem de completar código
A Jev é um modelo System One. Não gera texto, não escreve código nem mantém uma conversa. Recebe um estado e um conjunto de perguntas tipadas e devolve respostas estruturadas que o teu código pode usar diretamente:
- Uma
choicede uma lista de opções, com probabilidades por opção. - Um
scorenuma rubrica que tu defines. - Um
noul(0–1) para uma afirmação verdadeira ou falsa.
Os agentes de código baseiam-se num LLM que emite texto em streaming, chama ferramentas e edita ficheiros com base em instruções em linguagem natural. A Jev não faz nada disso. Não existe uma definição model: "jev-latest" que transforme o teu agente de código num agente movido a Jev, porque os dois sistemas resolvem problemas diferentes.
O que provavelmente queres em vez disso
Escolhe a linha que corresponde ao que estavas a tentar fazer:
| Querias… | Faz isto |
|---|---|
| Tornar o teu agente de código melhor a escrever código que usa a TypeSafe | Instala a skill de agente da TypeSafe. Dá ao Claude Code, ao Codex e a outros agentes o contexto completo sobre a API da Jev, as primitivas e os padrões, para que possam gerar integrações corretas com a TypeSafe. |
| Usar a Jev dentro de uma app ou de um agente que estás a construir — para encaminhamento, classificação, pontuação, guardrails ou qualquer decisão estruturada | Começa pelo Início rápido e lê depois Como construir com a TypeSafe e os Padrões para arquiteturas comuns como o encaminhamento por confiança e o encaminhamento por intenção. |
| Substituir ou trocar o modelo que alimenta um agente de código | A Jev não é a ferramenta para isto. Continua a usar um agente de código baseado em LLM e usa a Jev em separado sempre que o teu produto precisar de uma decisão rápida, calibrada e estruturada. |
| Experimentar a Jev antes de escreveres código | Abre o Playground, cola algum texto como estado e adiciona algumas perguntas. Vê o Início rápido para um guia passo a passo. |
Quando vale a pena recorrer à Jev
Embora a Jev não seja um LLM para agentes de código, muitas vezes é exatamente a ferramenta certa dentro de um agente ou de uma app que estás a construir com um agente de código. Recorre à Jev quando o teu código precisar de:
- Encaminhar um pedido para um de um conjunto fixo de destinos e saber com que confiança esse encaminhamento foi feito.
- Pontuar algo numa rubrica (urgência, qualidade, risco) e ramificar com base no número.
- Verificar se uma afirmação é verdadeira em relação a um documento, uma mensagem ou um registo antes de agir.
- Substituir um prompt frágil que pede a um LLM para “devolver JSON” por uma chamada que devolve valores tipados por construção.
Se algo disto corresponde ao que estás a construir, o caminho mais rápido é o Início rápido e depois a referência das primitivas para os tipos de pergunta.
Próximos passos
- System One — O que é um modelo System One e em que difere de um LLM.
- Início rápido — Experimenta a Jev no Playground, por HTTP ou com o SDK de Python.
- Skill de agente — Dá ao teu agente de código contexto sobre a API da TypeSafe.
- Padrões — Arquiteturas comuns para construir com a TypeSafe.