StaffDeck Open Source: Piattaforma Aziendale per la Creazione di Dipendenti Digitali

Introduzione

Il 15 luglio 2026, OpenBMB ha reso open source StaffDeck, una piattaforma aziendale progettata specificamente per creare, gestire e far operare dipendenti digitali.

Il progetto segue un percorso diverso dai comuni chatbot aziendali. Invece di considerare l'IA come una finestra di dialogo temporanea, StaffDeck mira a trasformare l'esperienza professionale, i processi aziendali, le procedure operative standard e i criteri decisionali in dipendenti digitali in grado di lavorare in modo continuativo e migliorarsi costantemente.

Il codice sorgente è stato pubblicato su GitHub, insieme a pacchetti di installazione desktop per macOS, Windows e Linux. StaffDeck può anche essere distribuito dal codice sorgente tramite endpoint di modello compatibili con OpenAI.

Dai Chatbot Aziendali ai Dipendenti Digitali

Molti prodotti IA aziendali iniziano e finiscono ancora con un'interfaccia di chat. L'utente apre una conversazione, fa una domanda, riceve una risposta e chiude la sessione.

Questo modello è utile per attività di supporto semplici, ma mostra i suoi limiti quando un'azienda desidera che l'IA partecipi a lavori ripetibili.

Un dipendente digitale necessita di molto più della capacità di conversazione. Deve comprendere il proprio ruolo, seguire le regole organizzative, utilizzare conoscenze approvate, richiamare strumenti, conservare registri delle esecuzioni e supportare l'intervento umano quando necessario.

StaffDeck è costruito proprio attorno a questa visione più ampia. Caratterizza i dipendenti digitali attraverso attributi organizzativi come:

• Ruolo e confini del ruolo
• Identità del dipendente
• Profilo delle competenze
• Risorse di conoscenza
• Competenze e procedure operative standard
• Permessi degli strumenti
• Registri di lavoro ed esecuzione
• Ambito di accesso
• Storico di feedback e miglioramenti

Questa struttura avvicina il sistema a una piattaforma di gestione digitale del personale, piuttosto che a un'interfaccia chatbot generica.

Trasformare la Conoscenza Organizzativa in Capacità Riutilizzabili

Uno dei problemi più spinosi nelle operazioni aziendali è che la conoscenza preziosa è spesso sparsa ovunque.

Alcune informazioni sono registrate nei documenti, altre sono incorporate in fogli di calcolo e manuali di processo, e una grande quantità di conoscenza risiede nell'esperienza dei dipendenti senior, comprese quelle sottili valutazioni raramente formalizzate nelle procedure operative standard.

Quando un dipendente esperto se ne va o cambia ruolo, parte di questa conoscenza può scomparire con lui.

StaffDeck mira a trasformare varie forme di competenza organizzativa in capacità digitali persistenti:

1. Esperienza professionale
2. Processi aziendali
3. Procedure operative standard
4. Criteri decisionali
5. Conoscenza documentata
6. Regole operative informali
7. Feedback generato dal lavoro reale

L'obiettivo non è letteralmente "l'immortalità digitale", ma un tentativo pragmatico di rendere le competenze importanti riutilizzabili, tracciabili e più facili da migliorare.

Progetto Congiunto Industria-Università-Ricerca

StaffDeck non si presenta come un prodotto interno di una singola azienda.

Secondo le informazioni del repository ufficiale, la piattaforma è stata sviluppata congiuntamente da:

• ModelBest
• Laboratorio Congiunto Dati e IA di Northeastern University-ModelBest
• Laboratorio di Elaborazione del Linguaggio Naturale dell'Università di Tsinghua (THUNLP)
• OpenBMB
• AI9Stars

Questa combinazione riunisce competenze nella ricerca sui modelli, nell'elaborazione del linguaggio naturale, nell'esperienza di implementazione aziendale e nell'ingegneria open source.

Il pubblico di riferimento include aziende e istituzioni che desiderano trasformare l'intelligenza artificiale da strumento di produttività individuale a capacità organizzativa riutilizzabile.

Funzionalità Principali di StaffDeck

Il progetto ufficiale descrive quattro aree di capacità.

Creare e Gestire Dipendenti Digitali

Gli utenti possono definire dipendenti digitali con ruoli indipendenti, numeri di matricola, profili di competenze, permessi e registri di lavoro.

I dipendenti digitali possono essere pubblicati, riutilizzati o modificati in base alle diverse esigenze organizzative. Un meccanismo di isolamento dei permessi aiuta a impedire che ogni utente modifichi direttamente le risorse condivise.

Questa funzionalità è particolarmente utile quando un'azienda desidera mantenere una serie di ruoli digitali controllati e approvati, piuttosto che consentire a ogni dipendente di costruire robot personali isolati.

Competenze Procedurali Guidate da Macchina a Stati

StaffDeck può trasformare descrizioni di processo in linguaggio naturale in procedure operative standard strutturate, eseguite tramite una macchina a stati.

La macchina a stati aiuta a scomporre lavori complessi in fasi definite, condizioni di transizione e rami di stato. Questo approccio è più prevedibile che chiedere al modello di improvvisare l'intero processo in un unico prompt.

La piattaforma supporta:

• Esecuzione parallela di più processi
• Commutazione in tempo reale tra processi
• Conservazione del contesto
• Editing visivo dei processi
• Gestione delle versioni
• Evoluzione ramificata

Queste funzionalità sono particolarmente adatte per attività che devono seguire processi stabili ma richiedono comunque un giudizio limitato dell'IA.

Recupero della Conoscenza con Consapevolezza della Struttura Documentale

I sistemi di recupero tradizionali spesso suddividono i documenti in piccoli blocchi di testo e li cercano direttamente. Sebbene questo metodo funzioni, può perdere le informazioni strutturali del documento originale.

StaffDeck costruisce indici navigabili su più livelli, tra cui documenti, sezioni, pagine e riepiloghi.

I dipendenti digitali possono prima stimare dove potrebbero trovarsi le informazioni pertinenti, quindi individuare con maggiore precisione il testo originale.

La piattaforma supporta anche:

• Contenitori di conoscenza indipendenti
• Recupero preciso
• Citazione delle fonti
• Debug del recupero
• Accesso consapevole dei permessi

Questo consente ai team di comprendere più chiaramente perché un dipendente digitale ha scelto una fonte specifica.

Esecuzione Autonoma e Miglioramento Continuo

StaffDeck può eseguire lavori tramite interfacce HTTP, strumenti del protocollo di contesto del modello e attività pianificate.

Il processo di esecuzione non è una scatola nera nascosta. La piattaforma registra eventi intermedi come riconoscimento dell'intento, recupero, selezione delle competenze, utilizzo degli strumenti, revisione e generazione della risposta.

Quindi, può utilizzare memoria a lungo termine, feedback degli utenti, registri delle conversazioni e analisi del feedback per migliorare le capacità del dipendente digitale.

Gli utenti umani possono anche intervenire quando necessario, annullare esecuzioni, mettere in coda attività o subentrare nelle attività.

Come StaffDeck Conserva la Conoscenza Oltre le Singole Conversazioni

La differenza più importante tra una piattaforma di dipendenti digitali e un chatbot standard risiede nella persistenza.

Nei normali prodotti di chat, la maggior parte del contesto utile appartiene a una singola conversazione. Una volta che quella sessione termina, la conoscenza correlata potrebbe non diventare un asset organizzativo gestito.

StaffDeck separa le capacità riutilizzabili dal contesto di conversazione temporaneo.

I dipendenti digitali possono conservare e riutilizzare:

• Knowledge base approvati
• Definizioni di processo
• Competenze
• Strumenti collegati
• Regole specifiche del ruolo
• Memoria a lungo termine
• Registri di feedback
• Tracce di esecuzione
• Attività pianificate

Ciò non significa che ogni conversazione debba diventare automaticamente una memoria permanente. I sistemi aziendali devono ancora seguire regole di autorizzazione, protezione della privacy, processi di revisione e politiche di conservazione chiare.

Il punto chiave è che la conoscenza può essere trasformata consapevolmente in una risorsa controllabile, piuttosto che rimanere bloccata nelle chat personali dei dipendenti.

Flusso di Lavoro Principale

Il flusso di lavoro ufficiale di StaffDeck può essere riassunto in sei fasi.

1. Creare un Dipendente Digitale

Definire ruolo, confini del ruolo, stile di servizio, creatore e ambito di accesso.

Una chiara definizione del ruolo aiuta a impedire che il dipendente digitale agisca al di fuori delle sue responsabilità previste.

2. Configurare le Capacità

Collegare knowledge base, competenze generali, procedure operative standard e strumenti.

I team possono copiare risorse dal mercato o crearne di proprie, senza modificare i modelli condivisi originali.

3. Avviare una Sessione

Aprire il dipendente digitale dal mercato o dall'elenco dei dipendenti e inviare la prima richiesta.

Dopo l'invio del primo messaggio, la sessione formale verrà salvata in modo persistente.

4. Eseguire e Osservare

Seguire i registri di esecuzione mentre il dipendente digitale lavora.

L'interfaccia può mostrare eventi relativi a intento, recupero, competenze, strumenti, revisione e risposta finale.

5. Intervenire Quando Necessario

Gli utenti possono gestire le richieste in coda, annullare esecuzioni, trasferire attività alla gestione umana o gestire le risposte in sospeso.

Per attività incerte, sensibili o di grande impatto, l'intervento umano rimane importante.

6. Ottimizzare Continuamente le Prestazioni del Dipendente

Utilizzare memoria, feedback, registri di conversazione e attività pianificate per ottimizzare le prestazioni del dipendente digitale.

Quando i team analizzano i casi di fallimento e aggiornano conoscenze, definizioni di processo o strumenti, il dipendente digitale diventa più prezioso.

Guida Rapida a StaffDeck

L'articolo originale ha annunciato il rilascio open source ma non includeva istruzioni di installazione. I seguenti comandi sono tratti dal repository ufficiale di StaffDeck per consentire ai lettori di verificare e testare direttamente la piattaforma.

Requisiti di Ambiente

Preparare il seguente ambiente:

• macOS, Linux o WSL (per script di sviluppo)
• Python 3.11 o versione successiva
• Node.js 20 o versione successiva
• npm
• Interfaccia di completamento chat compatibile con OpenAI
• Chiave API valida per il servizio di modello scelto

StaffDeck stesso non richiede CUDA. I requisiti hardware dipendono dall'interfaccia del modello che si sceglie di eseguire o a cui si accede.

1. Clonare e Installare

git clone https://github.com/OpenBMB/StaffDeck.git
cd StaffDeck

python3 -m venv backend/.venv
backend/.venv/bin/python -m pip install -e "backend[dev]"
npm --prefix

enterprise ci
cp

```plaintext
backend/.env.example backend/.env

2. Configurare il modello

Apri il file backend/.env, imposta la chiave applicativa e le informazioni sul servizio modello:

APP_SECRET="replace-with-a-long-random-secret"
DEMO_MODEL_BASE_URL="https://your-openai-compatible-endpoint/v1"
DEMO_MODEL_NAME="your-model-name"
DEMO_MODEL_API_KEY="your-api-key"

La chiave API viene utilizzata per creare la configurazione iniziale del modello e viene crittografata prima di essere memorizzata nel database.

Non inviare backend/.env su repository pubblici.

Dopo l’avvio, è possibile gestire il provider del modello anche dal seguente percorso:

Gestione → Configurazione modelli

3. Avviare la demo Web

DETACH=1 scripts/dev_up.sh

Questo script costruisce il frontend e avvia, sulla porta 5173, un processo FastAPI per servire interfaccia, API e documentazione Swagger.

Le credenziali iniziali dell’amministratore sono:

Nome utente: admin
Password: admin

Dopo il primo accesso, modificare immediatamente la password predefinita.

4. Verificare l’installazione

Esegui un controllo di integrità:

curl http://127.0.0.1:5173/api/health

Risposta prevista:

{"status":"ok"}

Apri quindi:

http://127.0.0.1:5173/workspace/gallery

Seleziona un dipendente digitale e invia un messaggio. La risposta e il registro di esecuzione dovrebbero apparire nella stessa sessione di dialogo.

Comandi comuni

scripts/dev_status.sh       # Controllare lo stato dei servizi
scripts/dev_down.sh         # Arrestare i servizi locali
scripts/dev_up.sh           # Eseguire in primo piano

Download versione desktop

Gli utenti che non vogliono implementare tramite codice sorgente possono utilizzare le release desktop ufficiali del progetto StaffDeck.

Piattaforma	Architettura	Pacchetto ufficiale
macOS	Apple Silicon, arm64	Scarica.dmg
Windows	x64	Scarica installer.exe
Linux	x86_64, Debian o Ubuntu	Scarica.deb

Poiché il progetto è ancora in fase beta iniziale, prima di utilizzarlo per carichi di lavoro produttivi critici, il team dovrebbe testare ciascuna versione in ambienti controllati.

Struttura del progetto

Il repository ufficiale suddivide l’applicazione in componenti backend, frontend, documentazione, script e pacchetti.

StaffDeck/
├── backend/                  # API FastAPI, runtime agent, archiviazione e worker per attività
├── frontend-enterprise/      # Workspace StaffDeck in React/TypeScript
├── docs/                     # Tutorial, API, definizioni schema e flussi di esempio
├── scripts/                  # Gestione ciclo di vita servizi e script di verifica
├── packaging/                # Risorse per packaging su macOS, Linux e Windows
├── README.md                 # Documentazione in inglese
└── README.zh.md              # Documentazione in cinese semplificato

Il backend si basa principalmente su Python, mentre il frontend enterprise utilizza React e TypeScript.

Casi d’uso aziendali

StaffDeck può fungere da base per numerosi ruoli digitali interni.

Assistente conoscenze interne

Il dipendente digitale può recuperare documenti aziendali approvati, citare le fonti e assistere i colleghi nella ricerca di informazioni relative a procedure o policy.

Assistente esecuzione SOP

I team possono trasformare procedure ripetitive in flussi strutturati, lasciando al dipendente digitale il compito di guidare o eseguire ciascuna fase.

Coordinatore operativo

Grazie ad attività pianificate e API collegate, il dipendente digitale può monitorare il lavoro ordinario e attivare azioni già approvate.

Supporto clienti

Il dipendente digitale può integrare conoscenze di prodotto, regole di servizio e procedure di escalation, conservando i registri di esecuzione per revisioni successive.

Assistente ricerca o analisi

Il sistema può assemblare materiali, seguire processi di ricerca stabiliti e conservare i passaggi seguiti per generare risposte.

Conservazione conoscenze esperti

Prima di cambiare ruolo o lasciare l’organizzazione, i dipendenti esperti possono trasformare in capacità digitali riutilizzabili i criteri di giudizio, le linee guida di revisione e i metodi di lavoro che applicano regolarmente.

Rischi e limitazioni

L’open source non significa che un sistema AI sia automaticamente pronto per un’implementazione aziendale senza limiti.

Il repository StaffDeck elenca alcune limitazioni importanti:

• Le risposte del modello possono essere errate, incomplete o incoerenti.
• I registri di esecuzione migliorano la verificabilità ma non garantiscono la correttezza.
• La qualità del recupero dipende dalla qualità dei documenti, dall’analisi, dall’indicizzazione, dalle autorizzazioni e dalle capacità del modello.
• Strumenti esterni possono produrre effetti collaterali concreti.
• Le attività pianificate richiedono worker sempre attivi e una corretta configurazione del fuso orario.
• Le operazioni ad alto rischio devono utilizzare credenziali con privilegi minimi e richiedere l’approvazione umana.
• La piattaforma non sostituisce la revisione professionale qualificata in settori regolamentati.
• Le decisioni importanti necessitano di autorizzazione, protezione della privacy e supervisione umana.

Le organizzazioni dovrebbero iniziare con flussi di lavoro a basso rischio, limitare i privilegi degli strumenti e verificare i risultati prima di estendere le responsabilità del sistema.

Licenza open source

StaffDeck è pubblicato sotto la GNU Affero General Public License v3.0, comunemente nota come AGPL-3.0.

I team che intendono modificare la piattaforma o fornirla in rete dovrebbero leggere attentamente la licenza. AGPL-3.0 può imporre obblighi di divulgazione del codice sorgente per le versioni modificate fornite agli utenti tramite servizi di rete.

Per decisioni commerciali o legali, le organizzazioni dovrebbero consultare il testo integrale della licenza e, se necessario, richiedere una consulenza professionale.

Domande frequenti

Che cos’è StaffDeck?

StaffDeck è una piattaforma enterprise open source per creare e gestire dipendenti digitali. Integra definizione dei ruoli, knowledge base, SOP, strumenti, autorizzazioni, memoria e registri di esecuzione in un unico sistema.

In cosa si differenzia StaffDeck da un chatbot?

I chatbot gestiscono principalmente conversazioni. StaffDeck, invece, è progettato per supportare ruoli persistenti, conoscenze controllate, flussi strutturati,

StaffDeck può funzionare senza una GPU locale?

Sì. L'applicazione si connette a endpoint di modelli compatibili con OpenAI, quindi StaffDeck non richiede una GPU locale. I requisiti hardware dipendono dal fatto che il servizio di modello selezionato sia ospitato localmente o in remoto.

Quali fornitori di modelli può utilizzare StaffDeck?

La piattaforma richiede un endpoint di completamento chat compatibile con OpenAI. La compatibilità dipende dal fatto che il fornitore implementi il comportamento API richiesto e che il modello selezionato funzioni correttamente con il flusso di lavoro di StaffDeck.

StaffDeck può essere distribuito su Windows?

Il progetto ufficiale fornisce un programma di installazione desktop per Windows x64. Per i flussi di lavoro di sviluppo basati sul codice sorgente, il repository supporta macOS, Linux o Windows Subsystem for Linux come ambienti di esecuzione.

Perché gli utenti normali possono utilizzare le risorse di mercato ma non modificarle?

Le risorse di mercato sono modelli condivisi protetti dai permessi dei creatori e degli amministratori. Gli utenti normali possono copiare o associare risorse autorizzate ai propri dipendenti digitali, ma non possono modificare le risorse originali.

StaffDeck è pronto per l'uso in produzione?

Il progetto è open source e include già funzionalità orientate alle aziende, ma la versione attuale è ancora in fase beta iniziale. Le organizzazioni dovrebbero testare sicurezza, privacy, affidabilità e flussi di lavoro prima di distribuire in produzione.

Quale licenza utilizza StaffDeck?

StaffDeck utilizza la licenza AGPL-3.0. Le organizzazioni che modificano o eseguono questo software tramite servizi di rete devono rivedere i termini della licenza e gli obblighi relativi al codice sorgente.

Strumenti correlati

• StaffDeck: Sito ufficiale della piattaforma per dipendenti digitali aziendali.
• OpenBMB: Ecosistema di modelli linguistici di grandi dimensioni open source che ha incubato StaffDeck.
• FastAPI: Framework web Python utilizzato per fornire l'API e il backend dell'applicazione StaffDeck.
• React: Libreria frontend utilizzata nello spazio di lavoro aziendale di StaffDeck.
• Model Context Protocol: Protocollo utilizzato da StaffDeck per connettere i dipendenti digitali a strumenti esterni.
• GitHub: Piattaforma che ospita il codice sorgente, i problemi, le versioni e la cronologia del progetto StaffDeck.

Collegamenti correlati

• Repository GitHub di StaffDeck: Repository ufficiale del codice sorgente e principale riferimento tecnico.
• Sito ufficiale di StaffDeck: Sito ufficiale del prodotto e punto di accesso alla documentazione.
• Versioni di StaffDeck: Versioni beta ufficiali e pacchetti di installazione desktop.
• Documentazione in inglese di StaffDeck: Informazioni ufficiali su funzionalità, passaggi di distribuzione, flussi di lavoro, rischi e licenze.
• Documentazione in cinese di StaffDeck: Documentazione in cinese semplificato mantenuta nel repository del progetto.
• Feedback sui problemi di StaffDeck: Canale ufficiale per segnalazioni di bug riproducibili e suggerimenti di funzionalità.
• Organizzazione GitHub di OpenBMB: Altri modelli, sistemi e progetti open source mantenuti da OpenBMB.

Panoramica

StaffDeck rappresenta il passaggio da chatbot aziendali temporanei a dipendenti digitali continui. È progettato per trasformare conoscenze specialistiche, procedure operative standard, regole decisionali, strumenti e feedback in capacità governabili, riutilizzabili in tutta l'organizzazione.

La piattaforma integra gestione dei ruoli, flussi di lavoro a macchina a stati, recupero strutturato delle informazioni, chiamate API e strumenti MCP, attività pianificate, memoria a lungo termine, intervento umano e registri dettagliati delle esecuzioni. Il codice sorgente, il pacchetto di installazione desktop e le istruzioni di distribuzione sono tutti disponibili pubblicamente.

Il progetto è ancora in fase beta iniziale, quindi le aziende dovrebbero iniziare con scenari controllati a basso rischio e applicare rigorosamente politiche di autorizzazione, privacy e revisione umana.

Il concetto centrale di StaffDeck è molto diretto: quando la conoscenza e i processi appartengono all'organizzazione anziché svanire con la fine della conversazione, il valore dell'IA aziendale aumenta significativamente.