Como Integrar o Jev ao Grok Bot: O Melhor Agente que Já Construí

O Grok Bot dá a cada usuário um computador na nuvem e permite que os bots rodem shell nele. A maioria das pessoas o direciona para tarefas e fica assistindo ele repetir o mesmo erro.

Você adiciona uma skill de roteamento, deixa registrando logs por uma semana antes que ele possa agir e mantém um botão de emergência (kill switch).

Configure direito e as tentativas param antes de te custar qualquer coisa.

Aqui está a configuração completa 👇

Antes de começarmos, eu publico os guias completos no meu Substack: https://zodchiii.substack.com/ 🧠

O que o Jev retorna como resposta

Jev é o modelo System One da TypeSafe. Ele responde com um valor tipado em vez de texto corrido, e entrega três primitivas:

• Choice escolhe uma opção de uma lista que você define e retorna a escolha, as probabilidades e a confiança
• Score avalia o estado com base em uma rubrica
• Noul responde se uma afirmação é verdadeira, como um número de 0 a 1

Como a resposta volta como um valor, você pode registrar em log, comparar duas semanas de decisões entre si e reproduzi-las sobre o tráfego de ontem.

A chamada funciona assim:

1from typesafe_sdk import Choice, TypeSafeClient
2
3with TypeSafeClient(model="jev-latest") as client:   # lê TYPESAFE_API_KEY
4    r = client.system_one(
5        state=f"goal: {goal}\ntask: {task_type}\nlast error: {err} x{repeats}",
6        questions={
7            "action": Choice(
8                instructions="O que o agente deve fazer a seguir",
9                criteria={
10                    "proceed": "Nada sugere que o próximo passo vai falhar",
11                    "reuse_cache": "Já existe um artefato novo para isso",
12                    "stop_retry": "A mesma abordagem falhou do mesmo jeito",
13                    "research_capped": "Fontes suficientes já foram reunidas",
14                    "ask_human": "O passo envia, publica, paga ou deleta",
15                },
16            )
17        },
18    )
19
20print(r.choices["action"].choice, r.choices["action"].confidence)

O roteador escolhe uma dessas cinco opções e não tem como responder mais nada.

Passo 1: pegue a chave de API

Abra o painel da TypeSafe e crie uma chave de API. Mantenha-a fora do chat, fora do repositório e fora de qualquer skill que você planeje compartilhar.

Passo 2: coloque a chave no computador

Use o fluxo de solicitação de segredo mascarado. A chave nunca passa pelo chat.

Uma coisa importante antes de adicionar: o computador na nuvem do Grok Bot é uma única máquina por conta, e todo bot que você roda nele vê os mesmos arquivos, sessões e logins. A chave que você colocar lá poderá ser lida por todos eles.

1Preciso te passar uma credencial de API da TypeSafe. Use o fluxo de solicitação
2de segredo mascarado, não o chat. O valor deve chegar como a variável de ambiente
3TYPESAFE_API_KEY no seu computador, e não deve aparecer em nenhum arquivo,
4log, skill ou repositório que você criar. Confirme apenas que a variável foi definida
5e está legível, nunca o valor dela.

Passo 3: instale o SDK e faça um teste rápido

1No seu computador, rode: pip install typesafe-sdk
2
3Depois escreva /work/jev/smoke.py que abre TypeSafeClient(model="jev-latest")
4e envia uma chamada system_one com uma única pergunta Choice. Estado:
5"goal: abrir um ticket de suporte. task: roteamento. last error: none x0".
6Critérios: billing, technical, sales.
7
8Rode e me mostre o objeto de resposta bruto: a escolha, as probabilidades
9e a confiança. Se TYPESAFE_API_KEY estiver faltando, pare e me avise,
10não faça hardcode de nada.

Você está procurando três coisas na saída: um valor da sua própria lista, uma distribuição de probabilidade e um número de confiança. Se algum deles faltar, o SDK está falando com outra coisa.

Passo 4: construa o roteador

1Crie um módulo de roteamento em /work/jev/router.py com uma função:
2
3    route(goal: str, task_type: str, last_error: str, repeats: int) -> dict
4
5Ela envia exatamente esses quatro campos para o Jev como estado, com uma pergunta
6Choice chamada "action" e estes critérios:
7
8  proceed          nada sugere que o próximo passo vai falhar
9  reuse_cache      já existe um artefato novo para isso
10  stop_retry       a mesma abordagem falhou do mesmo jeito
11  research_capped  fontes suficientes já foram reunidas
12  ask_human        o passo envia, publica, paga ou deleta
13
14Retorne a escolha, a confiança e as probabilidades. Anexe cada chamada
15em /work/jev/decisions.jsonl com timestamp, as quatro entradas e a resposta
16completa. Leia o comportamento de /work/jev/config.json com duas chaves:
17"enabled" e "mode" ("shadow" ou "active"). Padrão: enabled false.
18
19Nenhum texto de prompt no estado além desses quatro campos. Me mostre o arquivo
20antes de rodar.

Esses quatro campos são todo o estado que o Jev enxerga. Ele nunca recebe seu prompt, seu repositório ou sua conversa, então a chamada continua pequena e o log continua legível.

Passo 5: adicione a skill

1Crie uma skill chamada jev-usage-router.
2
3Gatilho: antes de qualquer sessão de navegador, qualquer rodada de pesquisa,
4qualquer repetição de um passo que falhou e antes de gerar um bot extra.
5
6Passos: chame route() de /work/jev/router.py com o objetivo atual, o tipo
7de tarefa, o texto do último erro e quantas vezes ele se repetiu.
8Depois obedeça à ação:
9
10  proceed          continue como planejado
11  reuse_cache      use o artefato existente, pule o trabalho
12  stop_retry       abandone essa abordagem e explique por quê
13  research_capped  pare em 5 fontes e documente o que você tem
14  ask_human        pause e me pergunte, não siga por conta própria
15
16Limite de aprovação: ask_human nunca é ignorado, independentemente da confiança.
17Saída: uma linha por decisão no relatório de execução.

Mantenha a cópia oficial dessa skill no seu próprio controle de versão. O Grok Bot guarda apenas os 20 registros de execução mais recentes por rotina, então envie tudo o que for importante para o seu próprio armazenamento na hora em que acontecer.

Passo 6: rode em modo shadow por uma semana

1Defina /work/jev/config.json como {"enabled": true, "mode": "shadow"}.
2
3No modo shadow, chame o roteador em cada gatilho e registre a decisão, depois
4ignore e faça o que você faria de qualquer forma. Não mude nada na sua
5forma de trabalhar.
6
7No fim de cada dia, anexe em /work/jev/report.md: quantas chamadas,
8a divisão de ações, a confiança média e todos os casos em que a ação
9registrada divergiu do que você realmente fez.

O modo shadow existe porque um avaliador barato pode errar. Leia o log buscando as divergências. Se stop_retry disparar numa abordagem que teria funcionado na quarta tentativa, você quer saber disso antes de permitir que ele aja.

Uma semana de tráfego real é suficiente para analisar. Menos que isso e a amostra será pequena demais para dizer muita coisa.

Passo 7: ative, mas mantenha o kill switch

1Defina mode como "active". De agora em diante, obedeça à ação em vez de só registrar.
2
3Dois kill switches ficam disponíveis para mim o tempo todo:
4  1. "bypass jev" em qualquer mensagem, que ignora o roteador naquela execução
5  2. {"enabled": false} no config.json, que desativa tudo completamente
6
7ask_human ainda pausa esperando por mim. Continue escrevendo decisions.jsonl exatamente como antes.

Continue registrando os logs depois de ativar. O log é o que te permite diferenciar um roteador que economiza dinheiro de um que silenciosamente interrompe um trabalho que deveria ter sido concluído.

O que rotear primeiro

Comece com aquela rotina que vive tentando de novo e deixe o resto da sua configuração como está.

As rotinas que valem a pena rotear primeiro têm uma coisa em comum: o agente não sabe o que já sabe. Ele reabre o navegador para buscar um arquivo que já está no disco, lê uma décima quarta fonte quando cinco já respondiam à pergunta, ou tenta a mesma abordagem pela terceira vez porque nada avisou que a segunda falhou pelo mesmo motivo.

Escolha uma, rode em modo shadow e leia o log antes de expandir.

Quanto custa

Uma chamada ao Jev carrega quatro campos curtos, então fica leve. Cada uma te compra a opção de pular um passo caro: uma sessão de navegador, uma rodada de pesquisa, um bot extra, uma nova tentativa.

Meça no seu próprio tráfego em vez de aceitar o número de alguém, incluindo o meu. Registre a decisão, registre o passo que você pulou e compare uma semana em shadow com uma semana ativa.

Alguns limites para lembrar

• Um computador por conta. Todo bot que você roda vê os mesmos arquivos e logins, então mantenha fora dessa máquina qualquer coisa que você não entregaria a todos eles.
• Vinte registros de execução por rotina. Envie tudo o que for importante para o seu próprio armazenamento.
• O uso ainda não é ilimitado. O roteador reduz movimentos caros, mas não elimina o teto.

Então, qual é o resultado final?

O Grok Bot pensa e executa, o Jev responde com uma de cinco ações, e você mantém a palavra final sobre qualquer coisa que não possa ser desfeita.

Comece com a rotina que continua falhando do mesmo jeito, rode em modo shadow por uma semana e depois ative.

Obrigado por ler!

Guias completos e o restante da série: https://zodchiii.substack.com/