Jev Use

Visão Geral

Divide um loop de agente com base em se uma etapa precisa produzir texto. Etapas que produzem apenas uma decisão - a compilação está pronta, qual destes 30 elementos clicar, este comando shell é seguro, manter ou descartar esta mensagem - são entregues ao Jev, o modelo de julgamento da TypeSafe, que responde a perguntas de sim/não digitadas, escolha uma e pontuação sobre um estado em uma única passagem direta em vez de gerar tokens. O agente permanece o planejador e o escritor; Jev toma as decisões rápidas.

Tudo o que Jev não deve decidir retorna sob um contrato de escalonamento digitado, de modo que a entrega seja explícita em ambas as direções, em vez de um palpite.

Quando Usar Esta Habilidade

• Use quando a próxima etapa for um julgamento sobre o contexto que você já tem ("X teve sucesso?", "qual opção?", "quão ruim é isso?") em vez de algo para escrever.
• Use quando você estiver prestes a verificar o mesmo estado várias vezes seguidas, para que as perguntas possam ser agrupadas em uma única chamada.
• Use quando você quiser uma verificação de risco em uma chamada de ferramenta proposta antes de executá-la.
• Não use quando a etapa deve produzir conteúdo novo - texto, código, argumentos de ferramenta de forma livre - ou quando as opções não podem ser enumeradas. Essas são estruturalmente o trabalho do próprio modelo.

Como Funciona

Etapa 1: Instalar e conectar o servidor

npx -y jev-use install

install conecta o servidor MCP stdio ao Claude Code, Codex e pi através da CLI de cada harness - qual quer que ele encontre - e npx -y jev-use doctor verifica a resolução de backend com uma única viagem de ida e volta. Defina uma credencial de provedor no ambiente em que o agente é executado (TYPESAFE_API_KEY, OPENROUTER_API_KEY ou AI_GATEWAY_API_KEY, detectado automaticamente nessa ordem), ou defina JEV_BACKEND=mock para executar sem chave e sem chamadas de rede.

Etapa 2: Roteie cada etapa antes de trabalhar nela

Etapa 3: Agrupe todas as perguntas sobre um estado em uma única chamada

jev_judge recebe uma única string state mais um array questions[]. A latência é plana em relação ao número de perguntas, e o custo do estado compartilhado se amortiza entre o lote, então 13 perguntas agrupadas custam muito menos do que 13 chamadas separadas. Nunca o chame uma vez por pergunta.

Etapa 4: Honre o contrato de escalonamento

Cada veredicto carrega {id, type, answer, confidence, escalate}, mais reason e hint exatamente quando escalate é verdadeiro. Um veredicto escalonado é devolvido a você - é um veredicto normal com uma dica, nunca uma exceção:

As duas razões pré-chamada vêm de um roteador determinístico, então uma etapa que nunca foi do Jev não gasta uma requisição.

Exemplos

Exemplo 1: Um estado, três perguntas, uma chamada

// jev_judge input
{
  "state": "CI run #142: build ok, 214 tests passed, 0 failed; 1 test quarantined as flaky last week",
  "questions": [
    { "id": "passed", "type": "noul",   "question": "Did the run fully succeed?" },
    { "id": "next",   "type": "choice", "question": "Next action?",
      "options": { "merge": "everything green", "rerun": "looks flaky", "hold": "needs attention" } },
    { "id": "risk",   "type": "score",  "question": "How risky is merging now?",
      "levels": ["routine", "worth a look", "incident"] }
  ]
}

…