# Panoramica della Piattaforma

## Cos'è Neotask?

Il **Gateway** è il motore principale che alimenta Neotask. È un singolo servizio a lunga esecuzione che gestisce tutto: sessioni degli agenti, integrazioni di messaggistica, esecuzione degli strumenti, automazioni pianificate e connessioni dei dispositivi.

Pensalo come il cervello a cui si collegano l'app desktop di Neotask, le app mobili e la dashboard web. Mentre interagisci tramite queste interfacce, il Gateway fa il lavoro pesante dietro le quinte.

## Architettura

Neotask utilizza un modello hub-and-spoke:

- **Il Gateway** è l'hub centrale, un server WebSocket che gira sulla tua macchina (o nel cloud). Gestisce tutte le sessioni degli agenti, instrada i messaggi tra i canali, orchestra l'esecuzione degli strumenti e persiste lo stato.
- **I Client** (l'app desktop, le app mobili, la dashboard web o il terminale) si connettono al Gateway e inviano/ricevono messaggi attraverso di esso.
- **I Nodi** (app companion su iOS, Android, macOS) espongono le capacità del dispositivo, fotocamera, canvas, registrazione schermo, posizione e voce, agli agenti in esecuzione sul Gateway.
- **I Canali** (WhatsApp, Telegram, Discord, Slack, ecc.) sono i trasporti di messaggistica a cui il Gateway si connette per inviare e ricevere messaggi.

Tutte le operazioni AI passano attraverso la pipeline Gateway → Provider LLM. L'app desktop non chiama mai direttamente un LLM.

## Capacità Principali

### Messaggistica Multi-Canale
Connettiti a 20+ piattaforme di messaggistica simultaneamente. I tuoi agenti possono inviare e ricevere messaggi su WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Google Chat, Microsoft Teams, Matrix, IRC e altro, tutto da una singola istanza del Gateway. Vedi [Canali](channels.md).

### Sistema Multi-Agente
Esegui più agenti isolati, ciascuno con il proprio workspace, personalità, configurazione del modello e associazioni ai canali. Instrada automaticamente i messaggi in entrata da canali, server o contatti specifici all'agente giusto. Vedi [Agenti](agents.md).

### Capacità del Dispositivo tramite Nodi
Connetti le app companion di iOS, Android e macOS come "nodi" che espongono l'hardware del dispositivo ai tuoi agenti. Gli agenti possono scattare foto, registrare video, catturare lo schermo, ottenere la posizione GPS, renderizzare canvas interattivi ed eseguire comandi di sistema, tutto tramite linguaggio naturale. Vedi [App Companion](companion-apps.md).

### Automazione del Browser
Gli agenti possono controllare un browser Chromium completo, aprire pagine, cliccare elementi, compilare form, fare screenshot, estrarre contenuto, caricare file ed eseguire JavaScript. Sono supportati più profili browser per l'isolamento degli account. Vedi [Strumenti e Capacità](tools-capabilities.md).

### Canvas e A2UI
Il sistema Agent-to-UI (A2UI) permette agli agenti di renderizzare contenuti visivi interattivi sui dispositivi connessi. Gli agenti possono presentare pagine web, inviare aggiornamenti UI strutturati, eseguire JavaScript nel contesto del canvas e fare snapshot di ciò che viene visualizzato. Vedi [Strumenti e Capacità](tools-capabilities.md).

### Supporto Flessibile dei Modelli
Usa qualsiasi provider LLM principale, Anthropic (Claude), OpenAI (GPT), Google (Gemini), Together AI, Moonshot, OpenRouter e altri. Configura catene di fallback per i modelli, alias e override del modello per agente. Esegui modelli locali tramite Ollama o vLLM. Vedi [Modelli e Provider](models-providers.md).

### Ecosistema di Plugin e Skill
Estendi Neotask con plugin che aggiungono nuovi canali, strumenti, metodi RPC e capacità. Sfoglia le skill disponibili nel [catalogo delle skill](/skills). Crea le tue skill per insegnare nuovi flussi di lavoro agli agenti. Vedi [Plugin e Skill](plugins-skills.md).

### Pianificazione e Automazione
Pianifica i risvegli degli agenti con espressioni cron, promemoria one-shot o trigger basati su intervalli. Gli agenti possono eseguire compiti automatizzati, consegnare risultati ai canali o pubblicare su webhook. Vedi [Automazione](automation.md).

### Interazione Vocale
Usa parole di attivazione per attivare il tuo agente con la voce. La modalità talk abilita conversazioni vocali continue con speech-to-text e text-to-speech in tempo reale (ElevenLabs, OpenAI). Il daemon Swabble su macOS fornisce rilevamento vocale sempre attivo, on-device. Vedi [Voce](voice.md).

### Intelligenza delle Sessioni
Le sessioni si resettano automaticamente ogni giorno, si compattano quando si avvicinano ai limiti del contesto e persistono tra i riavvii. La ricerca nella memoria permette agli agenti di richiamare informazioni da conversazioni precedenti usando la somiglianza vettoriale. Vedi [Sessioni e Memoria](sessions-memory.md).

### Self-Hosted e Privato
Tutto gira sulla tua infrastruttura. I tuoi messaggi, le chiavi API e i dati degli agenti non lasciano mai le tue macchine a meno che tu non configuri esplicitamente un servizio esterno. Il Gateway si lega a localhost per default, nessuna esposizione alla rete esterna.

### Esecuzione Sandboxed
Esegui i comandi degli agenti in container Docker isolati con limiti di risorse configurabili, policy di rete e confinamento del filesystem. I profili sandbox per agente ti permettono di controllare esattamente cosa può accedere ogni agente. Vedi [Sicurezza](security.md).

## Come Si Incastra Tutto

1. **Tu** interagisci con i tuoi agenti tramite l'app desktop di Neotask, un'app companion mobile, o direttamente tramite piattaforme di messaggistica come WhatsApp o Telegram.
2. **Il Gateway** riceve il tuo messaggio, lo instrada all'agente giusto e avvia un turno AI.
3. **L'agente** elabora la tua richiesta usando il LLM configurato (Claude, GPT, ecc.), chiama gli strumenti necessari (browser, canvas, operazioni sui file, comandi shell) e genera una risposta.
4. **La risposta** ti viene consegnata attraverso lo stesso canale, oppure annunciata su un canale diverso se configurato.
5. **Lo stato** (trascrizioni delle sessioni, configurazione degli agenti, job pianificati) viene persistito localmente in modo che tutto sopravviva ai riavvii.