Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Informazioni su DaxBax Neo

DaxBax Neo è un pannello di controllo per un team di agenti IA che operano sui tuoi server. Mostra cosa sta facendo ogni agente in questo momento, ti permette di creare o disattivare agenti, collegare loro servizi e messenger, e assegnare attività pianificate — senza dover accedere manualmente a ogni server via SSH.

Un agente in Neo è un’istanza di Claude Code (o Codex) in esecuzione su un tuo server, mostrata in Neo come un “dipendente”: ha un nome, una scheda, le sue connessioni e — se lo attivi — un browser proprio e i suoi argomenti su Telegram. Gli agenti stessi vengono eseguiti sui tuoi server; Neo è lo strumento con cui li gestisci e li osservi, non un servizio che svolge il lavoro per te da qualche parte nel cloud.

Di cosa si compone

  • Server — le macchine su cui i tuoi agenti effettivamente lavorano. Colleghi un server una sola volta, e Neo può poi eseguire su di esso uno o più agenti.
  • Agenti — singoli “dipendenti” IA, ciascuno con il proprio contesto e le proprie connessioni.
  • Progetti — contesto condiviso per più agenti contemporaneamente: chi sei, cosa fai, chi sono i tuoi clienti. Ogni agente collegato a un progetto vede questa descrizione nelle proprie istruzioni.
  • Integrazioni — messenger (Telegram, MAX) e i tuoi servizi personali (REST API, webhook, server MCP) che un agente può utilizzare.
  • Attività pianificate — ciò che un agente fa secondo una pianificazione, senza il tuo intervento.
  • Sessioni — i terminali in tempo reale degli agenti, e le loro sessioni browser quando chiedi a un agente di accedere a qualcosa con il tuo account.

A chi è destinata questa documentazione

A chi usa effettivamente Neo: configura server e agenti, collega servizi, osserva le attività e cosa fanno gli agenti. Non è un riferimento API — Neo non dispone di un’API pubblica per integrazioni con terze parti, come invece avviene in un normale prodotto SaaS tramite un token. Tutto viene gestito tramite questa interfaccia.

Per iniziare

Il percorso più breve dall’accesso al primo agente funzionante.

1. Accedi o registrati

Nella pagina di accesso puoi registrarti con email e password, oppure accedere tramite un provider collegato (Google, Yandex — la disponibilità dipende dal dominio da cui accedi). Registrandoti ottieni subito il tuo spazio di lavoro isolato — i tuoi server, agenti e connessioni non sono visibili a nessun altro.

Hai dimenticato la password? Nella pagina di accesso c’è un link “Password dimenticata?”: ti invia via email un link per impostarne una nuova, senza bisogno di quella vecchia.

2. Collega un server

Server → “Aggiungi un server”. Indica un indirizzo, un utente e un metodo di accesso:

  • Chiave DaxBax Neo (predefinita) — Neo genera una chiave per questo server e ti mostra un comando da eseguire sul server, per aggiungere la parte pubblica della chiave ad authorized_keys.
  • Chiave personale — incolla una chiave privata esistente per intero (prima e ultima riga incluse).
  • Password — Neo accede una sola volta, aggiunge la propria chiave e la usa da quel momento in poi; puoi mantenere la password salvata se il server rifiuta l’accesso tramite chiave.

L’utente non deve necessariamente essere root — è sufficiente il sudo senza password.

3. Crea un agente

Agenti → “Nuovo agente”. Assegna un nome (il nome tecnico viene generato automaticamente) e scegli un server verificato su cui farlo funzionare. Puoi collegarlo subito a un progetto, in modo che riceva il contesto condiviso del team, e scegliere la sua memoria: isolata, oppure condivisa con un altro agente sullo stesso server.

Una volta creato, l’agente compare in Sessioni — è lì che vedi il suo terminale in tempo reale.

4. Collega ciò di cui hai bisogno

Integrazioni: messenger (Telegram, MAX) e opzioni generiche — la tua REST API personale, webhook in entrata, server MCP. Colleghi un servizio una sola volta e lo assegni agli agenti che ne hanno bisogno.

5. Attività pianificate, se ti servono

Attività pianificate: cosa deve fare un agente secondo una pianificazione (cron, ogni N minuti, o una sola volta) e a quali agenti è assegnata. Qualsiasi membro del tuo spazio di lavoro può gestire le attività; solo gli agenti con una propria sessione Claude persistente possono eseguirle.

Da qui, leggi la sezione dedicata a ciascun argomento per maggiori dettagli.

Server

Un server è una macchina che svolge effettivamente il lavoro degli agenti. Neo non memorizza nulla su di esso a parte la propria chiave SSH (o certificato) e ciò di cui hanno bisogno le connessioni e gli agenti che configuri.

Aggiungere un server

Server → “Aggiungi un server” → “Collega un nodo di lavoro”: indirizzo, porta, utente e un metodo di accesso.

Metodi di accesso:

  • Chiave DaxBax Neo (predefinita). Neo genera una chiave dedicata per questo server e ti mostra un singolo comando da eseguire su di esso, per aggiungere la parte pubblica ad authorized_keys. Da quel momento in poi Neo accede solo con questa chiave.
  • Chiave personale. Incolla una chiave privata esistente per intero (prima e ultima riga incluse). Se la chiave è protetta da passphrase, questa viene usata solo una volta, per leggere la chiave, e non viene mai memorizzata — la chiave stessa è conservata cifrata, senza la passphrase.
  • Password. Per impostazione predefinita, la password viene usata una sola volta: Neo accede, aggiunge la propria chiave ad authorized_keys, verifica che la chiave funzioni, e da quel momento in poi accede con la chiave, dimenticando la password. Se il server rifiuta l’accesso tramite chiave, puoi invece mantenere la password salvata, e Neo continuerà a usarla (anche per rispondere alle richieste di sudo).

Né la chiave né la password vengono mai mostrate nuovamente tramite l’interfaccia — il registro di controllo registra il metodo usato, non il segreto stesso.

L’utente non deve essere root: è sufficiente il sudo senza password (<utente> ALL=(ALL) NOPASSWD:ALL). Il pulsante “Verifica” rifiuta il server senza questa configurazione.

Modificare l’indirizzo o l’utente

Modificare l’host, la porta o l’utente richiede una nuova verifica della connessione.

Un server, più agenti

Più di un agente può essere collegato allo stesso server; possono condividerlo, ma ciascuno ha una propria memoria — isolata, oppure condivisa con un altro agente specifico sullo stesso server, scelto al momento della creazione dell’agente.

Certificati SSH invece di una chiave permanente

Alcuni spazi di lavoro hanno un ulteriore livello di protezione attivato: invece di una chiave permanente, Neo firma ogni connessione con un certificato a breve durata (valido per circa 30 minuti) emesso da un servizio di certificazione separato. Se questo è attivo per il tuo spazio di lavoro, i server passano a questo sistema automaticamente, in background, senza alcuna azione da parte tua — la vecchia chiave semplicemente smette di essere usata. Impostazioni → “Certificati SSH” mostra quanti server sono già passati al nuovo sistema.

Agenti

Un agente in Neo è un’istanza di Claude Code (o Codex) in esecuzione su uno dei tuoi server, mostrata nell’interfaccia come un “dipendente” separato: con un proprio nome, una scheda, connessioni e uno stato.

Creare un agente

Agenti → “Nuovo agente”: un nome (in qualsiasi lingua — il nome tecnico viene generato automaticamente) e il server su cui funzionerà. Ti serve almeno un server verificato; se non ne hai ancora uno, puoi aggiungerlo direttamente da questa stessa schermata.

Puoi anche:

  • collegare l’agente a un progetto — riceverà così il contesto condiviso del progetto (chi sei, cosa fai, chi sono i tuoi clienti);
  • assegnargli una memoria isolata, oppure condividere la memoria con un altro agente già in esecuzione sullo stesso server.

Una volta creato, l’agente appare immediatamente in Sessioni.

Il browser dell’agente

Puoi attivare un browser proprio dell’agente (scheda dell’agente → “Sessioni browser”). Mantiene un profilo persistente: un accesso effettuato una volta viene conservato e riutilizzato automaticamente in seguito.

Se l’agente deve accedere a qualcosa con il tuo account personale, non digita mai la password da solo e non te la chiede mai in chat — invia una richiesta di accesso, che vedi e approvi in Sessioni (vedi Sessioni).

Argomenti Telegram

Scheda dell’agente → “Argomenti Telegram”: un agente può gestire un intero gruppo Telegram tramite i propri argomenti, ciascuno una conversazione separata con il proprio contesto — /new in un argomento lo riavvia, chiudere un argomento lo archivia. Tutti gli argomenti di un agente condividono la sua memoria a lungo termine. Un gruppo viene collegato con un codice mostrato sulla scheda dell’agente (/bind <codice> inviato nel gruppo) — un gruppo in cui il bot è stato semplicemente aggiunto non riceve nulla finché il codice non viene inviato. Il bot deve essere amministratore del gruppo, oppure avere la modalità privacy disattivata su @BotFather — altrimenti non vedrà i messaggi all’interno degli argomenti.

Se Neo è temporaneamente irraggiungibile

Il browser e gli argomenti Telegram funzionano con una licenza che continua a operare per fino a una settimana anche se Neo non risponde — una breve interruzione da entrambe le parti non disattiverà queste funzioni.

Sessioni: osservare il lavoro degli agenti e accedere per loro

Sessioni mostra cosa sta facendo in questo momento ogni agente su tutti i tuoi server.

Terminale in tempo reale

Ogni agente ha la sua sessione di lavoro attuale — ciò che sta digitando e vedendo nel proprio terminale. Puoi aprirla, osservarla e digitare tu stesso al suo interno se devi guidare o correggere l’agente al volo.

Sessioni browser

Se un agente ha il proprio browser attivato (scheda dell’agente → “Sessioni browser”), è qui che emerge il suo uso principale: a volte un agente deve accedere a qualcosa con il tuo account personale — un sito che non si apre senza login. Quando ciò accade:

  1. l’agente invia una richiesta di accesso — la vedi proprio qui in Sessioni;
  2. apri il browser dell’agente da questa schermata, vedi la pagina di accesso e prendi il controllo;
  3. accedi tu stesso, come al solito;
  4. restituisci il browser all’agente.

Finché non lo restituisci, i comandi dell’agente verso il browser attendono. L’agente stesso non vede né memorizza mai la password — apprende solo che l’accesso è riuscito. Il profilo del browser viene conservato, quindi non dovrai accedere di nuovo la prossima volta: viene ricordato nello stesso modo in cui un browser normale ricorda un accesso.

Argomenti Telegram in Sessioni

Se un agente ha gli argomenti Telegram attivati, anche ogni argomento (una conversazione separata) appare qui, con i suoi messaggi e le azioni “Riavvia” / “Archivia”.

Progetti

Un progetto è un contesto condiviso per più agenti contemporaneamente: chi sei, dove ti trovi, cosa fai, chi sono i tuoi clienti. Questo testo diventa parte delle istruzioni di lavoro di ogni agente collegato al progetto — ogni “dipendente” del progetto lo vede.

Perché è utile

Se più agenti lavorano sulla stessa cosa, non devi spiegare chi sei e cosa fa la tua azienda a ciascuno separatamente — lo scrivi una sola volta, nel progetto, e qualsiasi agente che collegherai riceverà immediatamente quel contesto.

Creazione e modifica

Progetti → “Crea progetto”: un nome e una descrizione dell’azienda e del progetto. Puoi vedere come apparirà la scheda nell’elenco (“Anteprima progetto”) prima di salvarla.

Le modifiche alla descrizione possono essere applicate contemporaneamente a tutti gli agenti del progetto.

Collegare un agente a un progetto

Si fa al momento della creazione dell’agente (il campo opzionale “Progetto”) — un agente senza progetto lavora solo con il proprio contesto.

Integrazioni e connessioni

Integrazioni è un catalogo di servizi che puoi collegare, e un elenco di ciò che è già collegato. Un servizio viene collegato una sola volta, poi assegnato agli agenti che ne hanno bisogno.

Messenger

Telegram e MAX — un agente può avere un proprio bot dedicato (risponde solo per lui, istantaneamente), oppure un bot condiviso tramite una connessione che instrada i messaggi all’agente giusto.

Telegram dispone anche di argomenti: un agente gestisce ogni argomento di un gruppo come una propria conversazione separata — vedi Agenti per i dettagli.

I tuoi servizi personali

Se non esiste una scheda pronta per un servizio di cui hai bisogno, la categoria “Generici” ne coprirà qualsiasi altro, in tre modi:

  • Il tuo servizio (REST API) — indirizzo base, metodo di accesso, un segreto e, opzionalmente, un indirizzo OpenAPI. L’agente chiama il servizio direttamente; il segreto non lascia mai il tuo server.
  • Eventi in entrata (webhook) — la connessione riceve un proprio indirizzo, come /api/hooks/<token>, opzionalmente firmato con HMAC-SHA256. Ogni evento in entrata diventa un messaggio che l’agente legge e su cui può agire, nello stesso modo in cui agirebbe su un messaggio in un messenger. Fino a 120 eventi al minuto per connessione; nulla nel corpo di un evento viene mai eseguito come comando.
  • Server MCP — Neo aggiunge il server al set di strumenti dell’agente, senza esporre segreti in chiaro. L’agente vede i nuovi strumenti dopo un riavvio.

Quando una voce del catalogo viene rinominata o unificata

A volte una scheda del catalogo ne sostituisce diverse più vecchie (Bitrix24, ad esempio, offre una scelta del metodo di connessione — webhook oppure login e password). Le connessioni create con la vecchia scheda passano automaticamente a quella nuova, mantenendo i loro valori; i campi del metodo non scelto vengono semplicemente nascosti, non richiesti.

Attività pianificate

Attività pianificate è ciò che un agente fa da solo, senza di te: su una pianificazione cron, ogni N minuti, o una sola volta.

Come funziona

Neo valida la pianificazione e la trasmette al server stesso dell’agente; da quel momento in poi è il server a eseguirla — Neo non deve essere raggiungibile perché un’attività venga avviata, e una breve interruzione di Neo non fermerà alcuna attività. Le esecuzioni non riuscite vengono ritentate, e le esecuzioni perse durante un’interruzione vengono recuperate in seguito.

Chi può assegnare attività

Qualsiasi membro del tuo spazio di lavoro può gestire le attività, non solo chi ha creato l’agente.

Quali agenti possono eseguire attività

Solo gli agenti con una propria sessione Claude persistente — gli agenti che funzionano solo tramite Codex, o tramite un bot condiviso senza una propria sessione, non eseguono attività pianificate.

Se la pianificazione non corrisponde

Se Neo rileva che il server sta eseguendo una pianificazione diversa da quella impostata, la invia di nuovo (al massimo una volta ogni cinque minuti) — non c’è nulla da correggere manualmente.

Accesso, uscita e sicurezza

Accesso

Puoi accedere con email e password, oppure tramite un provider collegato (Google, Yandex — la disponibilità dipende dal dominio da cui accedi). La registrazione via email richiede la conferma del tuo indirizzo: un link viene inviato alla tua casella di posta, e non puoi accedere finché non lo segui.

Password dimenticata

Nella pagina di accesso c’è un link “Password dimenticata?”. Inserisci la tua email: se esiste un account per essa, riceverai un link per impostare una nuova password. Se non esiste alcun account per quell’indirizzo, la pagina risponde esattamente nello stesso modo — è intenzionale, affinché il modulo di recupero non possa essere usato per verificare se un determinato indirizzo è registrato.

Uscita

Impostazioni → “Esci” termina la tua sessione attuale. Esci da ovunque termina tutte le tue sessioni contemporaneamente, inclusa quella attuale — dovrai accedere di nuovo. Utile se hai effettuato l’accesso da un dispositivo che non usi più.

Il tuo spazio di lavoro

Registrandoti ottieni subito il tuo spazio di lavoro isolato — i tuoi server, agenti, connessioni e progetti non sono visibili a nessuno tranne le persone che hai invitato.

Sicurezza delle connessioni ai server

I server a cui Neo si connette per tuo conto vengono verificati dopo che il nome si risolve in un indirizzo: le connessioni a localhost, a reti private e interne (inclusi gli indirizzi dei metadati cloud) sono rifiutate senza eccezioni, e gli errori di connessione vengono sempre segnalati in forma generica, così non possono essere usati per sondare la tua rete interna.

Domande frequenti

Neo ha un’API pubblica per collegarlo ai nostri sistemi?

No. Neo non è una piattaforma con un’API per integrazioni con terze parti — è un’interfaccia per gestire e osservare i tuoi agenti. Se devi far arrivare dati dal tuo sistema a un agente, o viceversa, ciò si fa tramite Integrazioni, non collegandosi a Neo dall’esterno: l’agente chiama direttamente il tuo servizio, oppure il tuo servizio invia eventi all’indirizzo webhook che Neo ti fornisce.

Posso aggiungere un server senza esporre chiavi o password in chiaro?

Sì — il metodo di accesso “Chiave DaxBax Neo” genera una chiave da solo e ti chiede solo di eseguire un comando sul server; né la chiave né una password vengono mai mostrate nuovamente tramite l’interfaccia in seguito. Vedi Server.

Cosa succede se Neo è temporaneamente irraggiungibile?

Le attività pianificate già assegnate continuano a essere eseguite — la pianificazione vive sul server stesso dell’agente. Il browser e gli argomenti Telegram continuano a funzionare con la licenza esistente per almeno una settimana.

Come rientro se ho dimenticato la password?

Il link “Password dimenticata?” nella pagina di accesso. Vedi Accesso, uscita e sicurezza.

In cosa un agente è diverso da un normale chatbot?

Un agente ha una propria sessione di lavoro sul tuo server (un terminale che puoi osservare in Sessioni), una memoria che persiste tra le conversazioni, e accesso ai servizi che gli hai collegato — non si limita a rispondere ai messaggi, svolge il lavoro.