
Configurare un agente IA
Prima di iniziare a lavorare con gli agenti IA, devi abilitarli nella dashboard dell’app. Poi puoi iniziare a crearli usando la chat IA. Puoi abilitare gli agenti per tutte le nuove app per impostazione predefinita dalle impostazioni dell’account nel workspace.- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Scegli un template di agente suggerito o clicca Create from scratch per definirne uno tuo.

Personalizzare l’agente IA
Ogni agente ha il proprio pannello di configurazione con le seguenti sezioni:- Guidelines: definisce comportamento, persona, modello IA e file di contesto dell’agente.
- Tools: controlla quali dati e strumenti l’agente può usare.
- Connectors: permette agli utenti dell’app di connettere i propri account esterni all’agente tramite OAuth.
- Skills: aggiungi set di istruzioni riutilizzabili che danno all’agente comportamenti o competenze specifici.
- Memory: decide come l’agente ricorda le informazioni tra le conversazioni.
- WhatsApp: connette l’agente a WhatsApp così le persone possono chattare dal loro telefono.
- Telegram: connette l’agente a Telegram così le persone possono chattare da qualsiasi luogo.
- LINE: connette l’agente a LINE così le persone possono chattare dall’app LINE.
Configurare le linee guida
Usa la scheda Guidelines per impostare il comportamento del tuo agente e quale modello IA usa.
- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Clicca Edit Agent sull’agente rilevante.
- Clicca Guidelines.
- Aggiorna Description per definire ruolo e comportamento di alto livello dell’agente.
- Aggiorna Instructions con regole dettagliate che l’agente deve seguire.
- Sotto Context Files, clicca Upload files o Choose from library per aggiungere materiale di riferimento che l’agente può usare per rispondere alle domande. Ad esempio manuali di prodotto, documenti sui prezzi, policy o FAQ. Puoi aggiungere fino a 10 file.
- Sotto AI Model, seleziona il modello che alimenta l’agente. Mantieni Automatic selezionato per risposte rapide e convenienti, o scegli un modello tra Google Gemini, OpenAI GPT o Anthropic Claude per un ragionamento più avanzato.
- Clicca Save.
Scegliere un modello IA
| Modello | Ideale per | Crediti circa / messaggio |
|---|---|---|
| Automatic | Risposte rapide di uso generale | ~3 |
| Gemini 3 Flash | Ragionamento più forte a costo moderato | ~5 |
| GPT-5 | Analisi complesse e compiti critici per l’accuratezza | ~15 |
Consentire l’accesso anonimo
Per impostazione predefinita, le persone devono accedere alla tua app prima di usare un agente. Puoi permettere ai visitatori di chattare con un agente senza accedere attivando l’accesso anonimo per quell’agente, così chiunque può iniziare subito una conversazione. Puoi vedere le conversazioni anonime nella scheda Users nella dashboard Agents, proprio come le conversazioni degli utenti loggati. Vedi come visualizzare le conversazioni degli agenti. Quando l’accesso anonimo è attivo, i visitatori possono chattare con l’agente senza accedere, sul web e sui canali connessi (WhatsApp e Telegram). Gli utenti anonimi non possono accedere ai dati privati per utente, quindi mantieni disattivata questa opzione per gli agenti che gestiscono dati personali. Le conversazioni anonime attingono anche crediti integrazione dal pool del workspace, come gli utenti loggati, quindi attivalo solo per gli agenti che vuoi aperti a tutti. L’impostazione è disattivata per impostazione predefinita e la controlli per singolo agente. Per consentire l’accesso anonimo per un agente:- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Clicca Edit Agent sull’agente rilevante.
- Clicca Guidelines.
- Attiva il toggle Allow anonymous access.
- Clicca Save.

Gestire strumenti e accesso ai dati
Usa la scheda Tools per decidere cosa il tuo agente può fare e a quali dati può accedere.
- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Clicca Edit Agent sull’agente rilevante.
- Clicca Tools.
- Scegli quali strumenti l’agente può usare. Ad esempio:
- Strumenti entità per creare, leggere, aggiornare o eliminare record.
- Funzioni backend per inviare notifiche, attivare automazioni o chiamare API esterne.
- Regola eventuali permessi specifici dello strumento così l’agente accede solo ai dati necessari.
- Clicca Save.
Aggiungere connettori utente
Usa la scheda Connectors per permettere agli utenti della tua app di connettere i propri account esterni all’agente. Quando un connettore è abilitato, l’agente può creare link OAuth di connessione così ogni persona può autorizzare l’accesso al proprio account in quel servizio direttamente da una conversazione. Ad esempio, in un’app di consulenza di viaggio, ogni utente potrebbe connettere il proprio Google Calendar così l’agente può pianificare e programmare itinerari per loro conto. Scopri di più sulla configurazione dei connettori per gli utenti dell’app. Per aggiungere un connettore utente per il tuo agente:- Nella chat IA, chiedi all’agente di aggiungere un connettore utente, ad esempio:
I want my app users to connect their own LinkedIn account to this agent. - Quando appare il form, compila i dettagli richiesti. Variano per provider ma tipicamente includono un nome del connettore, Client ID, Client Secret e gli scope di cui l’app ha bisogno.
- Segui le istruzioni a schermo per autorizzare il connettore e scegliere i permessi che verranno richiesti agli utenti dell’app.
- Clicca Approve.

Aggiungere skill all’agente
Le skill sono set di istruzioni riutilizzabili che colleghi a un agente per dargli comportamenti, competenze o policy specifici. Puoi collegare fino a 10 skill per agente.
- App Skills: skill che crei per un’app specifica. Una volta create, possono essere riutilizzate su tutti gli agenti di quell’app.
- Workspace Skills: skill condivise nel workspace. Scopri di più sulla gestione delle skill del workspace.
- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Clicca Edit Agent sull’agente rilevante.
- Clicca Skills.
- Clicca Add Skill sotto App Skills.
- Scegli come creare la skill:
- Seleziona Start from scratch per scrivere le tue istruzioni.
- Seleziona un template come refund-policy, support-escalation, pricing-and-plans o brand-voice per partire da una struttura pronta.
- Inserisci un Skill name, una Description opzionale e le tue Instructions.
- Attiva il toggle Enable for current agent se vuoi che la skill sia attiva subito.
- Clicca Create Skill.
- Clicca Save.
Configurare la memoria
La memoria dell’agente permette al tuo agente di ricordare informazioni importanti tra le conversazioni, come preferenze, fatti chiave o conoscenze condivise. Controlli se le memorie sono condivise tra tutti o mantenute specifiche per ogni persona.
- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Clicca Edit Agent sull’agente rilevante.
- Clicca Memory.
- Clicca il toggle Enable Memory per attivare la memoria.
- Sotto Memory Scope, scegli come questo agente salva le memorie:
- Global & Per User: l’agente può creare memorie condivise per tutti e memorie personali per ciascuno.
- Global Only: l’agente crea memorie condivise tra tutti coloro che chattano con esso.
- Per User Only: l’agente crea memorie specifiche per ogni persona.
- In Memory Instructions, inserisci le linee guida che spiegano quando salvare le memorie e cosa includere.
- Dopo che il tuo agente ha avuto alcune conversazioni, controlla Saved Memories per vedere cosa ha memorizzato. Clicca Refresh per caricare nuove memorie.
- Clicca Save.
Connettersi ai canali di messaggistica
Connetti il tuo agente ad app di messaggistica esterne così le persone possono chattarci senza aprire la tua app. Ogni canale connesso ha le stesse capacità del tuo agente in-app e ciascuno si configura e connette separatamente.

Informazioni sull'uso di WhatsApp con il tuo agente
- Questa funzionalità è disponibile gratuitamente su tutti i piani.
- Un totale di 3 agenti in-app può essere connesso a WhatsApp tra tutte le tue app. Questo limite è separato dalle connessioni Superagent WhatsApp, che hanno il proprio pool. Se provi a connetterne più di 3, ti verrà chiesto di disconnetterne uno prima di continuare.
- Ogni agente riceve un proprio numero WhatsApp.
- Gli agenti WhatsApp usano solo crediti integrazione. Non vengono addebitati crediti messaggio. Ogni messaggio inviato o ricevuto usa 1 credito integrazione per il relay WhatsApp, più crediti integrazione aggiuntivi per le azioni dell’agente come chiamate LLM, generazione di immagini o invio di email.
- I visitatori dell’app non hanno bisogno di installare nulla per usare gli agenti WhatsApp. Basta toccare il pulsante WhatsApp nell’app per iniziare una chat. Le persone devono inviare il primo messaggio, per aiutare a prevenire spam e mantenerle al sicuro. Una volta iniziata la conversazione, l’agente può rispondere proprio come fa dentro l’app.
- La conversazione WhatsApp supporta sia immagini sia messaggi vocali.
- Se la tua app è pubblica, le persone devono accedere all’app prima di usare l’agente WhatsApp. Questo assicura che l’agente possa identificare con chi sta chattando e rispondere in base ai loro dati. Per permettere alle persone di chattare senza accedere, attiva Allow anonymous access nella scheda Guidelines dell’agente. Gli utenti anonimi non possono accedere ai dati privati per utente.
- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Clicca Edit Agent sull’agente rilevante.
- Clicca WhatsApp.
- Clicca Send to Chat sotto Add WhatsApp to Your App per aggiungere un pulsante WhatsApp all’app.
- Personalizza il messaggio di benvenuto WhatsApp.
- Clicca Save.

Telegram
Connetti il tuo agente a Telegram così le persone possono inviargli messaggi direttamente da Telegram, senza aprire l’app. Un agente connesso a Telegram ha le stesse capacità del tuo agente in-app. Può creare, leggere, aggiornare o eliminare record, attivare funzioni backend e gestire i dati dell’app.Informazioni sull'uso di Telegram con il tuo agente
- Tutte le funzionalità della chat web funzionano senza problemi in Telegram, inclusi strumenti e accesso ai dati.
- Gli utenti possono inviare note vocali e immagini per un’interazione naturale.
- Il tuo bot Telegram viene creato e connesso all’istante senza configurazione manuale.
- Per iniziare una conversazione, gli utenti aprono il tuo bot in Telegram e inviano
/start. - Puoi aggiungere un pulsante Telegram alla tua app così gli utenti possono aprire il bot direttamente dall’app.
- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Clicca Edit Agent sull’agente rilevante.
- Clicca Telegram.
- Clicca Connect Telegram Bot.
- Segui le istruzioni in Telegram per creare e connettere il bot.
- Clicca Send to Chat sotto Add Telegram to Your App per aggiungere un pulsante Telegram all’app.
- Personalizza il messaggio di benvenuto Telegram.
- Clicca Save.

LINE
Connetti il tuo agente a LINE così le persone possono inviargli messaggi direttamente dall’app LINE, senza aprire l’app. Un agente connesso a LINE ha le stesse capacità del tuo agente in-app. Può creare, leggere, aggiornare o eliminare record, attivare funzioni backend e gestire i dati dell’app.- LINE è disponibile solo in Giappone.
- Le risposte LINE sono solo testo semplice. Evita di usare markdown o HTML nel messaggio di benvenuto o nelle linee guida.
- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Clicca Edit Agent sull’agente rilevante.
- Clicca LINE.
- Scansiona il codice QR o copia il codice di attivazione, apri LINE sul telefono, aggiungi il bot Base44 e invia il codice di attivazione per connetterti.
- Clicca Send to Chat sotto Add LINE to Your App per aggiungere un pulsante LINE all’app.
- Personalizza il messaggio di benvenuto LINE.
- Clicca Save.

Vedere chi usa i tuoi agenti
La scheda Users nella dashboard Agents mostra ogni utente dell’app che ha chattato con uno dei tuoi agenti. Per ogni utente puoi vedere il ruolo, quanti agenti ha usato, le conversazioni totali e i crediti usati. Puoi ordinare l’elenco per agenti, conversazioni o crediti.
- Vai in Dashboard nell’editor dell’app.
- Clicca Agents.
- Clicca sulla scheda Users.
- Clicca sulla riga di un utente per vedere con quali agenti ha chattato e quante conversazioni e crediti ha usato ciascun agente.
- Clicca View accanto a un agente per vedere l’elenco completo delle conversazioni di quell’utente.
- Clicca su una conversazione per leggere la trascrizione completa, inclusi messaggi, chiamate di strumenti e crediti usati.
FAQ
Clicca una domanda qui sotto per saperne di più sugli agenti IA.Perché vedo un errore "Failed to send message" o 404 quando invio un messaggio a un agente?
Perché vedo un errore "Failed to send message" o 404 quando invio un messaggio a un agente?
- Apri le impostazioni dell’agente.
- Clicca sulla scheda Tools and Capabilities.
- Aggiorna o rimuovi l’entità vuota.
-
Clicca Save.

Posso usare gli agenti sul piano gratuito?
Posso usare gli agenti sul piano gratuito?
Posso abilitare gli agenti per tutte le app nel mio account?
Posso abilitare gli agenti per tutte le app nel mio account?
- Clicca sull’icona del tuo profilo in alto a destra nel workspace.
- Clicca Settings.
- Clicca Account settings.
- Attiva il toggle Enable agents for new apps by default nella sezione Default Agents.

Quali sono i vantaggi dell'uso degli agenti?
Quali sono i vantaggi dell'uso degli agenti?
- Automatizzare compiti ripetitivi.
- Ottenere risposte informate in tempo reale.
- Mantenere il flusso di lavoro dentro un’unica app.
- Scegliere automaticamente gli strumenti giusti.
Dove trovo la cronologia delle conversazioni con un agente?
Dove trovo la cronologia delle conversazioni con un agente?
Come il modello IA che scelgo influisce su crediti e comportamento?
Come il modello IA che scelgo influisce su crediti e comportamento?
- L’opzione predefinita Automatic (basata su Gemini 2.5 Flash) offre risposte rapide di uso generale a circa 3 crediti per messaggio.
- Modelli come Gemini 3 Flash forniscono un ragionamento più forte con un moderato aumento dei crediti.
- Modelli di fascia più alta come GPT-5 sono progettati per analisi complesse e decisioni critiche per l’accuratezza e generalmente usano più crediti per messaggio.
Quante skill posso aggiungere a un agente?
Quante skill posso aggiungere a un agente?
Come vedo quanti crediti ha usato il mio agente?
Come vedo quanti crediti ha usato il mio agente?

Qual è la differenza tra app skill e workspace skill?
Qual è la differenza tra app skill e workspace skill?
Posso attivare un'automazione quando qualcuno inizia una conversazione con il mio agente?
Posso attivare un'automazione quando qualcuno inizia una conversazione con il mio agente?




