Documentazione
Come si crea un nuovo agente
L'agente è l'unico nodo che ragiona: legge la conversazione, sceglie gli strumenti e risponde. Senza strumenti può solo conversare. Ecco come se ne crea uno e cosa si configura.
Istruzioni con storico
Ogni modifica alle istruzioni è conservata e si può ripristinare una versione precedente.
Modello a scelta
Ogni agente può usare un modello diverso, oppure quello predefinito dell'organizzazione.
Prova prima di pubblicare
Checks segnala i problemi e Try it apre una chat di prova con gli strumenti visibili.
Quattro modi per partire
| Modo | Dove | Adatto a |
|---|---|---|
| Conversando con il Builder | Sezione Build | Chi preferisce descrivere ciò che vuole in linguaggio naturale; il grafo si disegna in tempo reale |
| Dall'editor visuale | Graphs → Create node | Chi vuole scegliere e collegare i nodi a mano |
| Da una recipe | Graphs → New graph | Chi vuole un pattern già cablato (assistente Telegram, receptionist, team di agenti…). Vedi Recipes |
| Da un assistente esterno | Profile → Connect an assistant | Chi sviluppa con Claude, Codex o altri strumenti. Vedi Costruire con assistenti esterni |
Passo per passo
- Crea il progettoIn Graphs scegli New graph, vuoto o da recipe. Un progetto appartiene a una sola organizzazione.
- Aggiungi l'agenteCreate node apre una procedura in tre passi (Choose a node → Kind → Set up). Scegli la categoria Agents.
- Scrivi le istruzioniSono ciò che il modello legge: chi è l'agente, cosa sa della tua attività, come si comporta, quando deve chiedere. Scrivile in Markdown, con un titolo per argomento.
- Scegli il modelloLascia il campo vuoto per usare il modello predefinito dell'organizzazione. Vedi Modelli LLM.
- Dagli gli strumentiCollega alla porta Tools i nodi che offrono strumenti: database, file storage, libreria di skill, connector, server MCP. Si collega trascinando da una porta o con il suo +.
- Collega il canaleUn canale (web app, Telegram, mailbox, voce…) porta le conversazioni alla porta Conversations dell'agente. Vedi Canali.
- Controlla con ChecksElenca i problemi che impediscono al progetto di girare e i suggerimenti "Worth knowing", con le azioni per correggerli.
- Provalo con Try itApre una chat di prova con l'agente, con le chiamate agli strumenti visibili.
- SalvaSave applica la nuova versione e ricostruisce solo i nodi cambiati; il resto del progetto continua a girare.
- OsservaDal primo utilizzo, Logs mostra conversazioni, chiamate agli strumenti e modifiche. Vedi Governance e audit.
Scrivere buone istruzioni
# Ruolo
Sei l'assistente del servizio ordini di un'azienda di componenti meccanici.
## Come parli
Rispondi in italiano, in modo breve e preciso.
## Regole
- Controlla sempre lo stato dell'ordine con lo strumento prima di rispondere.
- Se il cliente chiede una modifica che non puoi fare, passa la conversazione a un collega.
## Strumenti
- `query` per leggere gli ordini dal database.- Le istruzioni non devono promettere ciò che nessuno strumento permette di fare.
- Il compito va scritto nelle istruzioni: la descrizione di una riga ("What it does") è per le persone e il modello non la legge.
- Le procedure lunghe e riutilizzabili stanno meglio in una libreria di skill che nelle istruzioni, perché vengono lette solo quando servono. Vedi Dati e conoscenza.
- Ogni modifica è conservata: la sezione Instructions mostra lo storico e riporta a una versione precedente.
I campi dell'agente
| Campo | Chi lo legge | A cosa serve |
|---|---|---|
| Name | Le persone | Nome mostrato in console |
| What it does, in one line | Le persone e gli assistenti esterni che raggiungono l'agente tramite server MCP | Descrizione breve; mai letta dal modello dell'agente |
| instructions | Il modello | Il lavoro dell'agente, in Markdown |
| Model | Il sistema | Un model profile dell'organizzazione; vuoto = predefinito |
| Who may talk to it | La console | Chi può aprire una chat dalla console: membri dell'organizzazione (predefinito), un gruppo o tutti. Ogni canale ha il proprio controllo d'accesso |
Opzioni avanzate
| Opzione | Predefinito | Effetto |
|---|---|---|
| Look at images | Disattivata | L'agente guarda le immagini su richiesta; richiede un modello che vede le immagini |
| Listen to audio | Disattivata | Trascrive l'audio; la trascrizione si sceglie tra ElevenLabs, un server Wyoming o un servizio compatibile OpenAI |
| Transcribe incoming audio | Attiva | Trascrive l'audio dei messaggi prima che il modello li legga (fino a 25 MB) |
| Let it split work into subtasks | Attiva | Può affidare un pezzo di lavoro a una copia vuota di sé stesso |
| Allow public file links | Disattivata | Può creare un link pubblico a un file della conversazione |
| Tool rounds per turn | 64 (massimo 200) | Quanti giri di strumenti per turno prima di fermarsi |
| Tool timeout | 600 secondi | Oltre questo tempo, il modello è informato che lo strumento non ha risposto |
| Model timeout | 600 secondi | Durata massima, o silenzio massimo in streaming, di una chiamata al modello |
Pagine collegate
Portare un agente in azienda
Il percorso dal prototipo di un agente a un servizio usato dai colleghi, con accessi, collegamenti ai sistemi e controllo.
Più agenti che collaborano
Delegare un compito, passare la conversazione, dividere il lavoro in sotto-attività.
Dati e conoscenza
Database MySQL, file storage e libreria di skill: lo stato persistente di agenti e codice.
Recipes: pattern già pronti
Sei progetti di partenza già cablati: assistente Telegram, web app, mailbox, receptionist, agente con codice, team di agenti.
Hai un agente da portare in produzione?Parliamone.
Ti mostriamo TeraBrain NX sul tuo caso: sistemi da collegare, accessi e controlli.