Come collegare Jev a Grok Bot: il miglior agente che abbia mai creato

Grok Bot assegna a ogni utente un computer cloud e permette ai bot di eseguire la shell su di esso. La maggior parte delle persone lo indirizza verso dei task e resta a guardare mentre ripete lo stesso errore all'infinito.

Tu aggiungi una skill di routing, la lasci loggare per una settimana prima che possa agire e mantieni un kill switch.

Se lo colleghi nel modo giusto, i tentativi falliti si fermano prima di costarti qualcosa.

Ecco la configurazione completa 👇

Prima di iniziare, pubblico le guide complete sul mio Substack: https://zodchiii.substack.com/ 🧠

Cosa restituisce Jev come risposta

Jev è il modello System One di TypeSafe. Risponde con un valore tipizzato invece che con del testo discorsivo e offre tre primitive:

• Choice seleziona un'opzione da una lista definita da te e restituisce la scelta, le probabilità e il livello di confidenza
• Score valuta lo stato rispetto a una rubrica
• Noul risponde se un'affermazione è vera, restituendo un numero da 0 a 1

Poiché la risposta arriva sotto forma di valore, puoi registrarla nel log, confrontare due settimane di decisioni tra loro e riprodurle sul traffico di ieri.

La chiamata ha questo aspetto:

1from typesafe_sdk import Choice, TypeSafeClient
2
3with TypeSafeClient(model="jev-latest") as client:   # reads 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="What should the agent do next",
9                criteria={
10                    "proceed": "Nothing suggests the next step will fail",
11                    "reuse_cache": "A fresh artifact for this already exists",
12                    "stop_retry": "The same approach failed the same way",
13                    "research_capped": "Enough sources are already gathered",
14                    "ask_human": "The step sends, publishes, pays or deletes",
15                },
16            )
17        },
18    )
19
20print(r.choices["action"].choice, r.choices["action"].confidence)

Il router sceglie una di queste cinque opzioni e non ha alcun modo di rispondere diversamente.

Passaggio 1: ottenere la chiave API

Apri la dashboard di TypeSafe e crea una chiave API. Tienila fuori dalla chat, fuori dal repository e fuori da qualsiasi skill che intendi condividere.

Passaggio 2: trasferire la chiave sul computer

Usa il flusso di richiesta dei secret mascherati. La chiave non passa mai attraverso la chat.

Una cosa da sapere prima di aggiungerla: il tuo computer cloud Grok Bot è una singola macchina per account, e ogni bot che esegui su di essa vede gli stessi file, sessioni e login. La chiave che inserisci lì è leggibile da tutti.

1Devo fornirti una credenziale API per TypeSafe. Usa il flusso di richiesta
2dei secret mascherati, non la chat. Il valore deve essere salvato come
3variabile d'ambiente TYPESAFE_API_KEY sul tuo computer e non deve comparire
4in alcun file, log, skill o repository che crei. Confermami solo che la
5variabile è impostata e leggibile, mai il suo valore.

Passaggio 3: installare l'SDK ed eseguire uno smoke test

1Sul tuo computer, esegui: pip install typesafe-sdk
2
3Poi scrivi /work/jev/smoke.py che apre TypeSafeClient(model="jev-latest")
4e invia una chiamata system_one con una singola domanda Choice. Stato:
5"goal: aprire un ticket di supporto. task: routing. last error: none x0".
6Criteri: billing, technical, sales.
7
8Eseguilo e mostrami l'oggetto della risposta grezza: la scelta, le probabilità
9e il livello di confidenza. Se manca TYPESAFE_API_KEY, fermati e avvisami,
10non inserire nulla in modo hardcoded.

Nell'output devi cercare tre cose: un valore proveniente dalla tua lista, una distribuzione delle probabilità e un numero di confidenza. Se manca anche solo uno di questi elementi, l'SDK sta comunicando con qualcos'altro.

Passaggio 4: costruire il router

1Crea un modulo router in /work/jev/router.py con una sola funzione:
2
3    route(goal: str, task_type: str, last_error: str, repeats: int) -> dict
4
5Invia esattamente questi quattro campi a Jev come stato, con una domanda
6Choice chiamata "action" e i seguenti criteri:
7
8  proceed          nulla suggerisce che il passaggio successivo fallirà
9  reuse_cache      esiste già un artefatto aggiornato per questo
10  stop_retry       lo stesso approccio è fallito nello stesso modo
11  research_capped  sono già state raccolte fonti sufficienti
12  ask_human        il passaggio invia, pubblica, paga o elimina
13
14Restituisci la scelta, la confidenza e le probabilità. Aggiungi ogni chiamata
15a /work/jev/decisions.jsonl con un timestamp, i quattro input e la risposta
16completa. Leggi il comportamento da /work/jev/config.json con due chiavi:
17"enabled" e "mode" ("shadow" o "active"). Per impostazione predefinita, enabled è false.
18
19Nessun testo di prompt nello stato oltre a quei quattro campi. Mostrami il file
20prima di eseguirlo.

Quei quattro campi rappresentano l'intero stato che Jev visualizza. Non riceve mai il tuo prompt, il tuo repository o la tua conversazione, quindi la chiamata rimane leggera e il log leggibile.

Passaggio 5: aggiungere la skill

1Crea una skill chiamata jev-usage-router.
2
3Trigger: prima di qualsiasi sessione del browser, di qualsiasi fase di ricerca,
4di ogni nuovo tentativo dopo un passaggio fallito e prima di generare un bot aggiuntivo.
5
6Passaggi: chiama route() da /work/jev/router.py con l'obiettivo corrente, il
7tipo di task, il testo dell'ultimo errore e quante volte si è ripetuto.
8Poi rispetta l'azione:
9
10  proceed          continua come previsto
11  reuse_cache      usa l'artefatto esistente, salta il lavoro
12  stop_retry       abbandona questo approccio e spiega perché
13  research_capped  fermati a 5 fonti e documenta ciò che hai
14  ask_human        mettiti in pausa e chiedimelo, non procedere da solo
15
16Limite di approvazione: ask_human non viene mai ignorato, indipendentemente dalla confidenza.
17Output: una riga per decisione nel report di esecuzione.

Conserva la copia autorevole di quella skill nel tuo sistema di controllo versione. Grok Bot mantiene solo i 20 record di esecuzione più recenti per routine, quindi trasferisci tutto ciò che ti interessa nella tua archiviazione man mano che avviene.

Passaggio 6: eseguirla in shadow per una settimana

1Imposta /work/jev/config.json su {"enabled": true, "mode": "shadow"}.
2
3In modalità shadow, chiama il router a ogni trigger e registra la decisione, poi
4ignorala e fai quello che avresti fatto comunque. Non cambiare nulla nel tuo
5modo di lavorare.
6
7Alla fine di ogni giorno, aggiungi a /work/jev/report.md: quante chiamate,
8la suddivisione delle azioni, la confidenza media e ogni caso in cui l'azione
9registrata non corrispondeva a ciò che hai effettivamente fatto.

La modalità shadow esiste perché un giudice economico può sbagliare. Analizza il log per individuare le discrepanze. Se stop_retry si attiva su un approccio che avrebbe funzionato al quarto tentativo, vuoi saperlo prima che gli venga permesso di agire.

Una settimana di traffico reale è sufficiente per trarre delle conclusioni. Con un periodo più breve, il campione è troppo piccolo per dirti molto.

Passaggio 7: passare alla modalità active, ma mantenere il kill switch

1Imposta mode su "active". Da ora in poi, rispetta l'azione invece di registrarla nel log.
2
3Due kill switch rimangono sempre a mia disposizione:
4  1. "bypass jev" in qualsiasi messaggio, che ignora il router per quell'esecuzione
5  2. {"enabled": false} in config.json, che lo disabilita completamente
6
7ask_human mi mette ancora in pausa. Continua a scrivere decisions.jsonl esattamente come prima.

Continua a registrare i log anche dopo il passaggio. Il log è l'unico modo per distinguere un router che ti fa risparmiare denaro da uno che blocca silenziosamente lavori che avrebbe dovuto portare a termine.

Cosa instradare per primo

Inizia con l'unica routine che continua a riprovare e lascia in pace il resto della tua configurazione.

Le routine che vale la pena instradare per prime hanno una cosa in comune: l'agente non sa ciò che già sa. Riapre un browser per un file che si trova già sul disco, legge una quattordicesima fonte quando cinque avevano già risposto alla domanda, oppure tenta lo stesso approccio per la terza volta perché nessuno gli ha detto che il secondo è fallito per lo stesso motivo.

Scegline una, eseguila in shadow e leggi il log prima di espanderti.

Quanto costa

Una chiamata Jev trasporta quattro campi brevi, quindi rimane leggera. Ognuna ti compra l'opzione di saltare un passaggio costoso: una sessione del browser, una fase di ricerca, un bot aggiuntivo, un nuovo tentativo.

Misuralo sul tuo traffico anziché fidarti dei numeri di chiunque, compresi i miei. Registra la decisione, registra il passaggio che hai saltato e confronta una settimana in shadow con una in active.

Alcuni limiti da tenere a mente

• Un computer per account. Ogni bot che esegui vede gli stessi file e login, quindi tieni fuori da quella macchina tutto ciò che non consegneresti a tutti quanti.
• Venti record di esecuzione per routine. Trasferisci tutto ciò che ti interessa nella tua archiviazione.
• L'utilizzo non è ancora illimitato. Il router riduce le operazioni costose, ma non elimina il limite massimo.

Quindi, cosa ottieni alla fine?

Grok Bot pensa e lavora, Jev risponde con una delle cinque azioni e tu mantieni l'ultima parola su qualsiasi cosa non possa essere annullata.

Inizia con la routine che continua a fallire nello stesso modo, eseguila in shadow per una settimana, poi attivala.

Grazie per la lettura!

Guide complete e il resto della serie: https://zodchiii.substack.com/