Imagine que você pudesse colocar um “árbitro” entre um assistente de inteligência artificial e uma decisão importante: qual modelo usar, quais informações manter, qual ação é segura ou se uma tarefa realmente terminou. Esse é o papel do Jev: ele não conversa como o Claude, nem escreve código como um agente de programação. Ele avalia situações estruturadas e devolve uma decisão que outro sistema pode usar.
🧠 Primeiro: o que é o Jev?
O Jev é apresentado como a API System One, da TypeSafe AI. Em vez de gerar uma resposta longa em linguagem natural, ele recebe um estado — um conjunto de informações sobre o que está acontecendo — e perguntas com respostas estruturadas.
Essas perguntas podem ser do tipo Noul, para decisões como sim ou não; Choice, para escolher uma opção; ou Score, para atribuir uma pontuação. O resultado inclui probabilidades, permitindo que o programa saiba não apenas qual alternativa venceu, mas também quão segura foi a avaliação.
O Jev não substitui o assistente principal. Ele funciona como uma camada de julgamento dentro do fluxo de trabalho.
🚫 Jev não é o modelo do Claude Code
Uma confusão comum é imaginar que basta trocar a URL da API do Claude Code ou do Codex para “rodar a ferramenta no Jev”. Isso não funciona. O Claude Code espera uma API capaz de produzir mensagens, texto em streaming e chamadas de ferramentas. O Codex espera uma interface compatível com o formato da OpenAI.
O Jev tem outra finalidade: seu endpoint avalia um estado e responde a perguntas tipadas. Portanto, ele não gera o texto que aparece na tela, não substitui o modelo conversacional e não deve ser configurado como se fosse um provedor de chat.
🧩 Quatro formas de usar o Jev com agentes
1. 📚 Uma skill que ensina o agente
A primeira possibilidade é instalar uma skill que ensine o Claude Code, o Codex ou outro agente a construir chamadas corretas para o Jev. Nesse caso, a skill não intercepta as mensagens nem modifica o modelo principal. Ela apenas orienta o agente a formular perguntas tipadas, reunir várias perguntas em uma mesma chamada e interpretar as probabilidades.
Para quem está começando, essa é a alternativa mais simples: o agente continua funcionando como antes, mas passa a saber quando uma decisão estruturada pode ser mais barata e previsível do que pedir uma nova análise textual ao modelo.
2. 🛡️ Hooks nas fronteiras do agente
Outra estratégia é executar uma avaliação antes ou depois de um momento sensível. Um hook pode analisar um comando de terminal antes da execução, verificar se uma resposta está realmente pronta, escolher quais partes do histórico devem ser mantidas ou reduzir uma saída muito longa antes que ela chegue ao modelo.
Para um leigo, pense em um funcionário que trabalha ao lado do assistente e confere cada etapa crítica. Ele não faz o trabalho inteiro, mas pode perguntar: “Este comando parece destrutivo?”, “Esta tarefa tem evidência de conclusão?” ou “Este trecho do histórico ainda é necessário?”.
3. 🔌 Ferramentas MCP
O MCP é um protocolo que permite conectar ferramentas a agentes de IA. Por meio de um servidor MCP, o Claude pode receber ferramentas capazes de listar modelos Jev, executar avaliações, comparar alternativas e classificar informações.
Essa opção é interessante quando você deseja que o agente escolha conscientemente quando chamar o Jev. A integração do Composio descrita na fonte funciona como uma ponte: Claude Web, Desktop e Cowork conectam-se a um servidor MCP hospedado, enquanto a autenticação e a autorização da conta Jev são conduzidas pelo fluxo do Composio.
4. 🔀 Roteamento de modelo por turno
No roteamento, o Jev não responde ao usuário. Ele decide qual modelo deve atender ao turno atual. Uma tarefa simples pode ir para um modelo mais rápido e barato; uma tarefa complexa pode ser encaminhada para um modelo mais capaz.
O agente continua sendo Claude Code ou Codex. O Jev atua nos bastidores como um controlador de tráfego, escolhendo a faixa adequada para cada solicitação. Em caso de falha, uma boa implementação deve deixar o modelo atual continuar trabalhando, em vez de bloquear todo o agente.
🔐 Como o Composio conecta Jev ao Claude
A página da Composio descreve um conector baseado em MCP para Claude Web, Claude Desktop e Claude Cowork. A configuração pode ser iniciada por um botão de conexão ou adicionando manualmente o servidor MCP:
https://connect.composio.dev/mcpDepois de adicionar o conector, o usuário autoriza o Composio no navegador e, em seguida, pede ao Claude uma tarefa relacionada ao Jev. O Claude solicita a conexão da conta Jev quando necessário. A mesma conexão pode ser utilizada nas superfícies Web, Desktop e Cowork, conforme a documentação consultada.
🛠️ O que é possível pedir ao Claude?
Com a conexão configurada, a documentação da Composio apresenta exemplos como:
- listar os modelos e versões Jev disponíveis;
- executar uma avaliação Noul em um modelo;
- comparar dois modelos usando perguntas do tipo Score;
- usar avaliações estruturadas dentro de uma tarefa de conhecimento.
O agente pode transformar uma solicitação em linguagem natural em uma chamada de ferramenta. Porém, isso não significa que todas as decisões devam ser delegadas automaticamente. A equipe precisa definir quais ações são permitidas, quais escopos serão concedidos e quando uma pessoa deve revisar o resultado.
👤 Exemplo para entender
Suponha que Claude Cowork precise escolher entre três modelos para analisar uma pasta de documentos. O estado pode informar o tamanho dos arquivos, a necessidade de raciocínio, o prazo e o orçamento. O Jev pode receber perguntas como:
- o trabalho exige o modelo mais capaz?
- o modelo rápido é suficiente?
- qual opção oferece o melhor equilíbrio entre custo e qualidade?
O Jev retorna as alternativas e suas probabilidades. Um programa pode então escolher o modelo recomendado ou encaminhar o caso para revisão humana quando a diferença entre as opções for pequena.
⚠ Limites e cuidados
- Não trate probabilidade como garantia: uma avaliação confiante ainda precisa ser validada em situações de alto risco.
- Controle as permissões: conectores e ferramentas devem ter apenas os escopos necessários.
- Verifique a conexão: tokens podem expirar, permissões podem ser revogadas e uma integração pode perder autorização.
- Não confunda projetos: um servidor MCP oficial e uma integração comunitária podem ter nomes e recursos diferentes.
- Tenha um plano de falha: se o Jev ou o conector estiver indisponível, o sistema deve informar o problema ou seguir uma política segura previamente definida.
✅ Resumo
- ✔ O Jev é uma camada de decisão estruturada, não um chatbot.
- ✔ Ele não substitui o modelo do Claude Code, do Codex ou do Claude Cowork.
- ✔ Pode ser usado por skills, hooks, ferramentas MCP ou roteadores.
- ✔ O Composio oferece uma conexão MCP gerenciada para Claude Web, Desktop e Cowork.
- ✔ A segurança depende de permissões mínimas, revisão e tratamento explícito de falhas.
