Seis ferramentas remotas, não um modelo de chat

Uma chamada no limite

O agente mantém o seu próprio modelo. Num limite de decisão chama uma das seis ferramentas. A resposta é um julgamento estruturado, não um parágrafo, e não uma ferramenta que o servidor execute por si.

Os nomes dos campos alinham com as rotas REST abaixo. Este hub não acrescenta outra ferramenta nem faz de proxy das chamadas.

POST JSON-RPC em HTTPS www

O extremo é Streamable HTTP sem estado. O cliente envia POST JSON-RPC. GET não é um fluxo SSE.

Use HTTPS e o anfitrião www: https://www.jevai.org/api/mcp. O http simples e o domínio sem www redirecionam. Muitos clientes reenviam esse POST como GET e recebem 405.

Uma chave Bearer, não um cookie de sessão

A autenticação é uma chave Bearer pessoal. O cookie de login não basta. initialize, ping e tools/list não chamam o Jev nem gastam a quota diária. tools/call gasta.

A versão do protocolo é 2025-03-26. O nome do servidor é jevai. As chaves continuam a vir de jevai.org/agent/keys, não do JEV Hub.

As seis ferramentas

Chame uma ferramenta quando o limite dela coincide com o momento. Uma probabilidade devolvida é um sinal, não uma autorização.

jev_guard_tool_call

Antes de uma chamada de ferramenta com consequências. Devolve allow, confirm, review ou deny. Não executa essa ferramenta. Obrigatórios: tool e action. Opcionais: arguments_summary, side_effects, safeguards, policy e reversibility. REST: POST /api/v1/decisions/tool-guard.

jev_route_model

Quando vários modelos conseguem fazer o trabalho e a qualidade, o custo, a latência ou o acesso a ferramentas mudariam a escolha. Obrigatórios: task e candidates. Opcionais: priorities, constraints e stakes. REST: /decisions/model-route.

jev_route_task

Quando o caminho seguinte é vago ou arriscado. Devolve proceed_fast, deep_review, split_task ou block. Obrigatório: task. Opcionais: evidence e constraints. REST: /decisions/route.

jev_check_research

A evidência já está na mão. Julgue uma afirmação como accept, verify_more ou reject. Não navega. Obrigatório: claim. Opcionais: evidence, source_quality e stakes. REST: /decisions/research.

jev_review_completion

Antes de declarar concluído um objetivo não trivial. Devolve complete, verify_more ou incomplete. Obrigatório: objective. Opcionais: completed_work, verification e known_gaps. REST: /decisions/completion.

jev_decide

Quando nenhum predefinido serve, envie state e perguntas choice, noul ou score. Obrigatórios: state e questions. Opcional: model, e esse valor só pode ser um id de modelo do Jev. REST: POST /api/v1/decisions. Os tipos de pergunta são Choice, Score e Noul neste hub.

Uma probabilidade não é permissão

Os números da resposta são um sinal, não uma autorização. Não saltam uma aprovação que o utilizador ou a plataforma já exigiu.

Este hub não hospeda este servidor. Veja como um agente pede um julgamento, os ficheiros Skill que nomeiam estas ferramentas e o construtor de pedidos que não chama uma API.