Documentação

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 choice de uma lista de opções, com probabilidades por opção.
  • Um score numa 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.