La dashboard locale: il tuo workspace visto dall’agente

La dashboard locale è una piccola web app che mostra il tuo workspace così come lo vede il tuo agente: i prodotti, cosa sa l’agente di ciascuno, l’avanzamento dell’onboarding, ogni stato di invio registrato, le cose che richiedono il tuo intervento e le date di follow-up. Gira solo sulla tua macchina, non contatta nessuna directory ed è stata aggiunta con la release del 15 settembre 2026 riportata nel changelog. Questa guida spiega come avviarla, a cosa serve ogni schermata e quali regole applica.

Avviarla

Su Windows, nei comandi seguenti usa py -3 al posto di python3 (oppure python, se è quello il tuo comando per Python 3.10+). Tieni il workspace in una cartella locale privata, fuori da OneDrive o da altre cartelle sincronizzate.

python3 scripts/dashboard.py            # opens 127.0.0.1:8765 in your browser
python3 scripts/dashboard.py --demo     # explore a throwaway sample workspace
python3 scripts/dashboard.py --port 8790 --no-open

Usa solo la libreria standard di Python 3.10+: nessuna dipendenza, nessuno step di build. Avviala dal tuo workspace privato, la cartella creata da scripts/init-workspace.py. Se invece la avvii dal checkout di consegna condiviso, si limita a proporti di creare quel workspace. La strada più semplice resta il prompt di avvio di una riga della guida all’avvio in tre passaggi: l’agente crea il workspace, avvia il server e ti passa il link.

La panoramica

La prima schermata risponde prima di tutto alla domanda “cosa richiede il mio intervento?”: i passaggi di consegne per CAPTCHA e autenticazione a due fattori che l’agente non ha potuto completare, le piattaforme segnate come bloccate, i follow-up scaduti e l’onboarding non terminato. Sotto trovi i tuoi prodotti con i totali per gruppo di stati (da gestire, problemi, in revisione, programmati, live) e lo stato di salute del workspace letto da workspace.json. Se apri la dashboard solo una volta a settimana, è questa la pagina da guardare.

La pagina del prodotto

Ogni prodotto ha una checklist di preparazione generata da doctor.py, il riepilogo dell’ultima sessione, i suoi invii con i filtri, i controlli di onboarding, il brief di prodotto, l’identità, i permessi e le note. Una “vista agente” elenca quali file sono compilati e quali sono ancora vuoti: utile quando una sessione finisce in anticipo e vuoi sapere su cosa ti farà domande la prossima. Il vocabolario degli stati mostrato qui è quello del tracker; la voce di glossario sullo stato della scheda spiega il significato di ciascuno.

Pianificare e riprendere una run

Parti con un obiettivo di 10 nuovi invii confermati e al massimo 2 worker. Il pianificatore delle run usa le informazioni sull’hardware locale per raccomandare un limite di parallelismo. Valuta anche il carico attuale: se la capacità è sconosciuta o la macchina è occupata, scegline uno. Due worker richiedono inoltre workspace del browser controllati separatamente e piattaforme assegnate distinte; una raccomandazione basata sull’hardware, da sola, non lo garantisce.

Salva la run, poi copia il suo prompt nel tuo agente. Usa /goal se il tuo host lo supporta; altrimenti incolla lo stesso testo come un normale messaggio. La dashboard memorizza il piano e mostra il lavoro rimanente, ma non avvia worker dell’agente né esegue azioni nel browser. Un obiettivo non può scavalcare i limiti del provider o le verifiche che richiedono una persona.

Contano solo i nuovi invii confermati: in attesa di revisione, in coda, programmati o live, una volta per piattaforma. Bozze e schede già esistenti non contano. Riprendi una run salvata invece di avviarne una sostitutiva che dimentica i progressi precedenti. La guida alla run spiega completamento, passaggi di consegne e chiusura delle finestre.

Registrazione degli esiti, catalogo e prompt

Il modulo Record outcome scrive tramite scripts/record.py e applica esattamente le regole della riga di comando: uno solo degli stati previsti, niente link né segreti nelle note, un URL pubblico più la tua attestazione per live, una data di lancio uguale o successiva alla data minima per scheduled, e una sostituzione esplicita quando una riga esiste già. La guida alla registrazione degli esiti passa in rassegna ciascuna di queste regole e il motivo per cui esiste.

New product crea una cartella vuota a partire da templates/project e ti fornisce il prompt di onboarding per il tuo agente oppure i moduli da compilare tu stesso. Catalog ti permette di cercare e filtrare tutte le piattaforme, leggere qualsiasi playbook, sovrapporre lo stato di un prodotto e registrare direttamente dall’elenco. Agent prompts and docs mostra i prompt per l’agente con i pulsanti per copiarli e visualizza la documentazione del toolkit direttamente lì, così raramente devi aprire a mano i file markdown.

Cosa non farà mai

I limiti sono voluti, ed è bene conoscerli prima di affidarti alla dashboard:

• Si collega solo a 127.0.0.1 e rifiuta le richieste cross-site.
• Modifica solo i file JSON e markdown del prodotto che modifica anche l’agente. credentials.json viene mostrato come piattaforma, metodo e stato; i suoi valori non vengono mai inviati al browser.
• Non invia nulla, non controlla un browser e non verifica una scheda. Registrare uno stato è una dichiarazione di chi opera, non una prova: la dashboard rende quella dichiarazione facile da fare e difficile da fare in modo sbagliato, niente di più.

La posizione della dashboard tra prodotto, agente e directory è illustrata nella pagina su come funziona. Se vuoi provarla senza un workspace tuo, --demo è il punto d’ingresso.