Come funziona: il progetto a grafo
Un progetto TeraBrain NX è un insieme di nodi collegati in due modi. Solo gli agenti ragionano: tutti gli altri nodi portano conversazioni agli agenti o danno loro strumenti.
Agenti, canali, dati, codice e integrazioni sono descritti insieme, in un progetto versionato.
Editor visuale, Builder in linguaggio naturale o assistente esterno: il risultato è lo stesso progetto.
Due tipi di collegamento
- Strumenti. Un nodo offre strumenti e un altro li usa. Un database offre
query, un agente la usa. - Conversazioni. Un nodo avvia conversazioni e un altro risponde. Un bot Telegram le avvia, un agente risponde.
- Web app
- Telegram
- Mailbox
- Voce
- Scheduler
- Server MCP
- Istruzioni
- Modello
- Database
- File storage
- Skill library
- Connector
- Sandbox
- MCP remoto
- Altri agenti
Due regole da ricordare: una conversazione finisce sempre su un agente, e una telefonata raggiunge un agente solo attraverso un nodo Voice.
Nodi e porte
Ogni nodo ha un tipo e quattro famiglie di porte, con le etichette che si vedono in console.
| Famiglia | Etichetta in console | Significato | Esempi |
|---|---|---|---|
| exposes | Provides tools | Il nodo offre strumenti | rw, ro, admin, functions, developer |
| consumes | Uses tools | Il nodo riceve strumenti | tools |
| sources | Starts conversations | Il nodo avvia conversazioni | delegate, handoff, agent, inbound |
| sinks | Answers | Il nodo riceve conversazioni | sink ("Conversations"), calls |
Versioni e ripristino
- Ogni modifica, da editor, Builder o assistente esterno, produce una nuova versione registrata a nome di chi l'ha fatta.
- Una modifica basata su una versione superata viene rifiutata, per non sovrascrivere il lavoro di un altro.
- Il rollback riporta il progetto a una versione precedente. Oltre il punto in cui è stato aggiunto un nodo con dati serve una conferma esplicita.
- Save ricostruisce solo i nodi cambiati; il resto continua a girare.
La mappa della console
| Area | Sezioni | A cosa servono |
|---|---|---|
| Build | Build, Graphs, Code, Skills, Files, Databases, Docs | Progettare e sviluppare: Builder, elenco progetti, workspace di codice, librerie, file, database |
| Run | Agents, Apps, Calls, Scheduled tasks, Logs | Usare e osservare: chat con gli agenti, app pubblicate, chiamate, task pianificati, registri |
| Organization | Settings, Members, Secrets, Variables, Connections, Identity, Sites | Amministrare: modelli, persone, credenziali, accesso aziendale, macchine |
Pagine collegate
Come si crea un nuovo agente
Passo per passo: progetto, nodo agente, istruzioni, modello, strumenti, canale, prova e pubblicazione.
Canali: come le persone raggiungono gli agenti
Web app, Telegram, mailbox, telefono, scheduler e server MCP: come si collegano e come si controlla chi può usarli.
Sicurezza
Ruoli, gruppi, credenziali, accesso aziendale e minimo privilegio: come si protegge un sistema di agenti.
Hai un agente da portare in produzione?Parliamone.
Ti mostriamo TeraBrain NX sul tuo caso: sistemi da collegare, accessi e controlli.