Vai al contenuto

Architettura dell'agente

Come funziona Kosmo

Kosmo lavora dentro un progetto Kosmico. Non risponde a un messaggio isolato: porta avanti un compito usando i file, il contesto della ricerca, gli strumenti e i permessi del progetto, in una modalità esplicita.

I dati sul prodotto qui sotto sono verificati sul codice sorgente di Kosmico a ogni versione. Distinguono cosa può fare l'agente, cosa richiede il tuo permesso, cosa cambia tra desktop e web e quali dati escono dal dispositivo.

L'autonomia ha limiti espliciti

Una richiesta lunga può richiedere molti passaggi in sequenza, ma gli strumenti disponibili, le approvazioni, il budget di turni e la modalità attiva ne fissano i limiti. Una funzione presente su desktop non è detto che esista uguale sul web.

Per questo la pagina elenca modalità, permessi e differenze tra desktop e web, invece di usare «autonomia» come un'etichetta.

Il contesto viene selezionato dallo stato del progetto

Il contesto può includere file, paper, note, Research Map, memoria del progetto e lavoro recente. Kosmo legge ciò che serve al compito; l'intero progetto non viene incollato in ogni richiesta al modello.

Cambiare modello cambia il modello, non il progetto. Un modello scelto da te resta selezionato; con Consigliato è Kosmico a scegliere, prima di ogni messaggio, il modello incluso nel tuo piano.

Archiviazione locale e inferenza locale sono scelte diverse

Un file locale, un progetto sincronizzato, una richiesta a un modello cloud e una a un modello locale seguono percorsi diversi. Qui sotto sono descritti uno per uno, perché «in locale» non venga letto come «tutto offline».

Fonte ufficiale

Dati aggiornati sul prodotto

Kosmico v0.7.6 · Verificato il

Disponibilità

Disponibilità
beta pubblica
Accesso
Iscrizione libera: crei un account gratuito nell'app web o nell'app desktop, senza codice di attivazione.

Limiti dell'autonomia

Kosmo può concatenare molti passaggi da solo, ma solo con gli strumenti della modalità attiva: uno strumento fuori dalla modalità viene rifiutato. Ogni esecuzione ha un budget fisso di turni con strumenti, da 10 a 50 a seconda di dove lavora Kosmo (20 nella chat desktop, 50 sul web), e, quando finisce, si chiude con una risposta scritta. I sotto-agenti di supporto possono solo leggere e hanno da 5 a 8 turni.

Modalità dell'agente

  • Agent: La modalità predefinita. Kosmo svolge il compito con gli strumenti che il modello supporta: legge e modifica i file e, su desktop, esegue comandi e celle dei notebook.
  • Plan: Si attiva con /plan. Kosmo legge il progetto e propone i passaggi; nel progetto non cambia nulla finché non accetti il piano, che poi viene eseguito in modalità Agent.
  • Chat: Entra in gioco quando il modello scelto non supporta gli strumenti. Kosmo ragiona con te sul lavoro e non modifica nulla.

Permessi e protezioni

  • Comandi del terminale, celle dei notebook, SSH e modifiche alla Research Map chiedono prima il permesso: Consenti una volta, Consenti sempre o Nega. Consenti sempre vale per un tipo di comando (per esempio git) fino alla fine di quella chat.
  • Comandi come rm -r, sudo o dd non offrono mai Consenti sempre.
  • Le modifiche ai file non interrompono il lavoro: ognuna compare come differenza che puoi accettare, rifiutare o annullare.
  • Un progetto può passare ad Accesso completo, che salta le richieste, anche quelle per i comandi rischiosi. Vale solo per il progetto aperto e si azzera quando lo chiudi o riavvii l'app.
  • Comandi e kernel dei notebook girano sul tuo computer o sul server che colleghi via SSH, mai sui server di Kosmico.
  • Gli strumenti IA esterni collegati tramite il server MCP di Kosmico chiedono la tua approvazione per ogni accesso alla tua memoria personale.

Modelli

I modelli cloud vengono da un catalogo gestito da Kosmico e sono inclusi nel piano, conteggiati in token. I piani gratuiti hanno i modelli gratuiti; quelli a pagamento sbloccano gli altri. Il catalogo si aggiorna dal pannello di amministrazione, quindi l'elenco può cambiare tra una versione e l'altra.

Consigliato
Consigliato è l'opzione predefinita: prima di ogni messaggio Kosmico sceglie il modello incluso nel tuo piano. Un modello scelto da te resta selezionato.
BYOK
Non supportato. Non c'è un campo per inserire una chiave API, e un abbonamento ChatGPT o Claude non può alimentare la chat. Funziona al contrario: Claude Code, Cursor e altri client MCP possono usare il tuo progetto tramite il server MCP di Kosmico su desktop.
Modelli per piano

Flussi dei dati

Progetto locale (desktop)

  • I file restano sul tuo disco.
  • Un progetto mai sincronizzato non esce dal computer e non conta nel limite di progetti del piano.

Progetto sincronizzato

  • La sincronizzazione cloud è un interruttore per ogni progetto. Un progetto nuovo parte con la sincronizzazione attiva finché il piano ha posti liberi.
  • Quando è attiva, il contenuto del progetto viene copiato nel cloud di Kosmico, così collaboratori e app web possono accedervi. Segreti come i file .env e le chiavi non vengono mai sincronizzati.
  • Puoi disattivarla sui progetti di tua proprietà: la copia cloud viene rimossa, i file restano sul dispositivo e chi lo condivideva con te perde l'accesso.

Modello cloud

  • Il tuo messaggio, e ciò che Kosmo legge per rispondere, passano da Kosmico al modello cloud che hai scelto.
  • Le conversazioni vengono salvate per sincronizzarle tra i tuoi dispositivi, e puoi eliminarle.
  • Kosmico non usa i tuoi documenti né i tuoi prompt per addestrare modelli IA.

Modello locale

  • Con un modello locale Ollama non esce nulla dal tuo computer.

Fonti di Deep Research

arXiv · sempre, su richiestaSemantic Scholar · sempre, su richiestaOpenAlex · sempre, su richiestaPubMed · su richiesta, quando serve, per disciplinaCrossRef · su richiesta, quando serveDBLP · quando serveEurope PMC · quando serve, per disciplina

Le fasi

  1. 01Rivedi la proposta: domanda, ambito e fonti
  2. 02Trasforma la domanda in obiettivi e query di ricerca, con una breve ricerca web per il contesto
  3. 03Cerca in parallelo nei database
  4. 04Unisce i duplicati per DOI, ID arXiv, ID PubMed o titolo quasi identico
  5. 05Valuta la pertinenza di ogni candidato
  6. 06Cerca ancora, segue le citazioni o individua le lacune, una decisione alla volta
  7. 07Estrae le evidenze dal testo completo dei paper più pertinenti
  8. 08Scrive la rassegna una sezione alla volta e costruisce il Knowledge Graph

Quando si ferma

  • Si chiude come completa solo quando ha il numero minimo di paper, il punteggio di copertura raggiunge l'obiettivo e ogni obiettivo richiesto ha paper a supporto. Il punteggio è calcolato, non giudicato da un modello: argomenti, metodi, arco temporale, varietà delle fonti, densità di citazioni e obiettivi.
  • Se Kosmo prova a chiudere prima, viene rimandato a cercare per gli obiettivi ancora aperti.
  • Altrimenti si ferma quando finiscono le ricerche o i passaggi previsti dalla profondità scelta, e il risultato viene segnato come completato con lacune, non come completo.

Verifica dei riferimenti

Ogni citazione viene da un record recuperato da uno dei database, e puoi aprirlo. La rassegna può citare solo paper trovati nella ricerca: una sezione con un riferimento sconosciuto, o un paragrafo sostanziale senza citazione, viene scartata e riscritta. Un controllo facoltativo risolve anche ogni riferimento per DOI, ID arXiv, ID PubMed o titolo e segnala quelli che non riesce a confermare.

Riscontro tra affermazione e fonte

Un'affermazione estratta dal testo completo di un paper resta solo se il passaggio citato compare davvero nella pagina indicata; quelle senza riscontro vengono scartate. Ogni sezione è scritta dalle evidenze dei paper che cita, ma nessun modello verifica che ogni frase della rassegna sia sostenuta: controlla le fonti di ciò che stai per pubblicare.

Domande e risposte

Kosmo può portare a termine una lunga sequenza senza supervisione?

Sì, entro dei limiti. In modalità Agent concatena i passaggi con gli strumenti che il modello supporta, dentro un budget fisso di turni. Comandi del terminale, celle dei notebook, SSH e modifiche alla Research Map chiedono prima il permesso, a meno che tu non dia al progetto l'Accesso completo, e ogni modifica a un file compare come differenza che puoi annullare.

Ogni modello riceve l'intero progetto?

No. Kosmo legge ciò che serve al compito, ed è questo che arriva al modello cloud che hai scelto. Con un modello locale Ollama su desktop non esce nulla dal tuo computer.

Posso usare una mia chiave API (BYOK)?

No. I modelli cloud sono forniti da Kosmico e inclusi nel piano, e non c'è un campo per inserire una chiave API. I modelli locali Ollama su desktop sono gratuiti.