Funzioni di AIsuru
AIsuru offre una serie di funzioni integrate e pronte all'uso che permettono al tuo Agente di interagire con il mondo esterno. Queste funzioni sono già configurate e possono essere attivate facilmente, ma richiedono un'attenta configurazione nelle istruzioni dell'Agente per essere utilizzate in modo efficace.
Strumenti predefiniti
Variabili di contesto
Le variabili di contesto permettono al tuo Agente di gestire dinamicamente i contesti della conversazione.
Questa funzione è particolarmente utile per:
Applicare automaticamente contesti specifici in base alle risposte dell'utente
Rimuovere i contesti quando non sono più pertinenti
Guidare naturalmente la conversazione tra argomenti diversi
Come funziona
L'IA generativa può:
Impostare un nuovo contesto quando rileva un cambio di argomento
Rimuovere un contesto quando l'argomento non è più pertinente
Utilizzare più contesti contemporaneamente per rispondere in modo accurato
Panoramica degli altri strumenti disponibili
AIsuru offre anche diverse funzioni integrate principali:
Artifact: crea e scarica contenuti interattivi in vari formati (HTML, CSS, JavaScript, JSON, markdown, svg, ecc.) direttamente nella chat
Invia email: consente all'Agente di inviare comunicazioni email agli utenti registrati
Converti OpenAPI in funzioni: genera automaticamente funzioni dalle specifiche OpenAPI
Crea funzione da file: consente all'Agente di accedere a un file durante le conversazioni
Ricerca Perplexity: consente all'Agente di effettuare ricerche web intelligenti con risultati sintetizzati dall'IA
Emozioni: consente al tuo Agente di esprimere emozioni attraverso espressioni facciali e animazioni quando viene visualizzato con un avatar 3D
Puoi iniziare a usarle subito: ti basta attivare l'interruttore della funzione che desideri utilizzare all'interno del tuo Agente!
Tieni presente, però, che per semplificare l'interazione e migliorare l'esperienza utente, dovrai spiegare all'Agente come e quando utilizzarle nelle sue istruzioni.
1. Artifact
Cosa sono
Gli artifact sono contenuti che il tuo Agente può creare nella chat con l'utente. Questi contenuti possono essere utilizzati in modo interattivo, scaricati e condivisi.
L'Agente può creare qualsiasi tipo di file utilizzando gli artifact, ad esempio:
Pagine web interattive: un singolo file HTML contenente codice CSS e JS
File di testo: come txt e markdown
CSV, SVG e altri tipi di file
Come funzionano
Una volta abilitata la funzione Artifacts, il tuo Agente può iniziare immediatamente a creare questi contenuti. Per guidarlo in modo più preciso, ricorda di spiegare nelle istruzioni quando deve usare gli artifact e come.
Durante la conversazione, se l'Agente crea un artifact, l'utente lo vedrà in un pannello separato sul lato destro della pagina.
Interagire con gli artifact
Nella parte superiore di ogni artifact è presente una barra degli strumenti con diversi pulsanti per gestire il contenuto. Da sinistra a destra:
Icona codice: mostra il codice sorgente dell'artifact
Icona occhio: mostra il file formattato o renderizzato (disponibile solo per file Markdown e HTML; per gli altri tipi di file vedrai solo il codice)
Pulsante "Copia": copia il codice sorgente negli appunti
Menu delle opzioni aggiuntive (freccia verso il basso): facendo clic sulla freccia accanto al pulsante "Copia" si apre un menu con le seguenti opzioni:
Scarica come HTML o Markdown (solo file HTML e Markdown)
Scarica come PDF (solo file Markdown)
Apri in una nuova finestra
Stampa
Tutte queste funzionalità rendono semplice visualizzare, copiare, condividere o salvare qualsiasi artifact generato durante la conversazione.
Limitazioni
Gli artifact non possono essere visualizzati se l'utente interagisce tramite un layout di condivisione "Website Assistant" sharing layout.
2. Invia email
La funzione Invia email consente al tuo Agente di inviare comunicazioni email a tutti gli utenti registrati sulla piattaforma (su aisuru.com o all'interno della tua PaaS). Questa funzione utilizza il protocollo SMTP e può essere configurata con qualsiasi provider email che lo supporti.
Come funziona
L'Agente può inviare email automaticamente durante le conversazioni, utilizzando le credenziali SMTP che hai configurato. La funzione recupera automaticamente l'indirizzo email dell'utente dal suo account registrato, quindi l'utente non deve fornirlo durante la conversazione.
Nota importante: Questa integrazione funziona solo con gli utenti che si sono registrati e hanno effettuato l'accesso alla piattaforma. Non funziona con gli utenti anonimi.
Configurazione SMTP
Per configurare l'invio di email nel tuo Agente:
Vai alla sezione Funzioni del tuo Agente
Trova il riquadro "Invia email" e abilita la funzione facendo clic sul pulsante di estensione
Scegli la tua "modalità di configurazione SMTP":
Eredita dal tenant: l'Agente utilizza la configurazione SMTP del tenant (disabilitata se non configurata)
Configurazione SMTP personalizzata: inserisci le credenziali SMTP specifiche per questo agente. Se scegli questa opzione, compila i campi obbligatori
Campi di configurazione
Server SMTP
L'indirizzo del server del tuo provider email
smtp.gmail.com, smtp-mail.outlook.com
Porta
La porta SMTP del server
465 (SSL), 587 (STARTTLS), 25 (non crittografata)
Nome utente
Il tuo indirizzo email completo
name@company.com
Password
La password dell'account email o la password dell'app
•••••••••••••••••
Email del mittente
L'indirizzo che apparirà come mittente
name@company.com
Nome del mittente
Il nome che apparirà come mittente
Nome dell'azienda
Sicurezza del socket
Il tipo di crittografia utilizzata
SSL/TLS, STARTTLS
Premi il pulsante "Salva" per confermare le impostazioni
Configurazione specifica per Gmail / Google Workspace
Se utilizzi Gmail o Google Workspace, segui questa guida dettagliata per una configurazione sicura e conforme alle policy di Google:
Credenziali SMTP per Gmail
Server SMTP
smtp.gmail.com
Porta
465 (SSL) oppure 587 (TLS)
Metodo di sicurezza
SslOnConnect o StartTls (vedi porta)
Nome utente
indirizzo completo (ad es. name@company.com)
Password
Password dell'app generata da Google*
Limite di invio
2.000 email/giorno per account
Guida passo passo per Gmail
Abilita la verifica in due passaggi sul tuo account Google
Genera una password dell'app:
Inserisci un nome descrittivo per la password dell'app (ad es., "AIsuru Mail")
Fai clic su Crea e copia la password generata
Configura nel pannello AIsuru:
Server SMTP:
smtp.gmail.comPorta:
465(SSL)Nome utente: il tuo indirizzo email completo
Password: la password dell'app appena copiata
Sicurezza socket: lasciala vuota a meno che tu non sia un utente esperto. Le opzioni sono None, Auto, SslOnConnect, StartTls o StartTlsWhenAvailable. Il valore predefinito è Auto.
Salva e testa: dovresti ricevere un'email di prova entro pochi secondi.
Altri provider email
La funzione di invio email può essere configurata con qualsiasi provider che supporti SMTP. Consulta la documentazione del tuo provider per ottenere:
Server SMTP e porta
Tipo di crittografia supportata
Credenziali di autenticazione
Configurazione nelle istruzioni dell'Agente
È essenziale definire nelle Istruzioni dell'Agente come utilizzare questa funzione. Ecco un esempio: assicurati di adattarlo al tuo caso d'uso specifico:
Best practice
Definisci modelli chiari per diversi tipi di comunicazione
Stabilisci limiti sulla frequenza di invio (massimo 2 email per conversazione)
Implementa controlli di sicurezza nelle istruzioni
Gestisci correttamente i dati personali in conformità alle normative sulla privacy
Monitora l'utilizzo per evitare di sovraccaricare il server SMTP
Testa regolarmente la configurazione per assicurarti che funzioni
Sicurezza e conformità
Non condividere mai le credenziali SMTP in testo semplice
Utilizza sempre connessioni crittografate (SSL/TLS)
Rigenera periodicamente le password delle app
Monitora i log di invio per rilevare utilizzi impropri
Rispetta i limiti di invio del tuo provider per evitare blocchi
Con questa configurazione, il tuo Agente potrà inviare email in modo sicuro e professionale, migliorando l'esperienza utente e fornendo un canale di comunicazione diretto.
3. Converti OpenAPI in funzioni
La funzionalità Converti OpenAPI in funzioni ti consente di generare automaticamente funzioni AIsuru da una specifica OpenAPI esistente.
Come funziona
Questo strumento ti consente di:
Caricare un file JSON OpenAPI con la documentazione di un'API esistente e del relativo webhook
Generare automaticamente tutte le funzioni necessarie per interagire con l'API
Avere funzioni pronte all'uso con parametri, descrizioni e configurazioni già impostati
Configurazione della conversione OpenAPI
Per convertire una specifica OpenAPI in funzioni:
Vai alla sezione Funzioni del tuo Agente
Seleziona la scheda Funzioni AIsuru
Trova il riquadro Converti OpenAPI in funzioni:
Inserisci l'URL di base del webhook (ovvero l'API — ad esempio,
https://api.example.com)Fai clic su "Carica JSON OpenAPI" e seleziona il file da caricare
Best practice
Esamina le funzioni generate: controlla che le funzioni create siano corrette
Testa le funzioni: usa il pulsante "Test" per verificare che funzionino
Aggiorna le istruzioni: spiega all'Agente come e quando usare le nuove funzioni
4. Crea una funzione da file
La funzione di creazione da file consente all'Agente di accedere durante le conversazioni a file come Excel, PDF, HTML o TXT, permettendogli di utilizzare le informazioni contenute in tali documenti.
Come funziona
Questa funzione ti consente di:
Carica un file (Excel, PDF, HTML o TXT) con meno di 500.000 caratteri
Fornisci una descrizione che spieghi all'IA generativa come utilizzare questo file durante le conversazioni
Rendi il file accessibile all'Agente come fonte di informazioni
Configurazione della funzione da file
Per creare una nuova funzione da un file:
Vai alla sezione Functions del tuo Agente
Seleziona la scheda Advanced functions
Fai clic sul pulsante Crea funzione da file
Nella pagina che si apre, puoi:
Carica un file (Excel, PDF, HTML o TXT) di dimensioni inferiori a 500.000 caratteri
Inserisci una descrizione della funzione che spieghi all'IA generativa come utilizzare il contenuto del file
La descrizione della funzione è essenziale: deve indicare chiaramente all'IA quando utilizzare questa funzione e come interpretare i dati nel file.
Esempio
Se carichi un listino prezzi in formato Excel, potresti scrivere una descrizione come:
Best practice per creare funzioni da file
Utilizza file ben strutturati per facilitarne la lettura da parte dell'IA
Fornisci descrizioni dettagliate che guidino l'IA nell'utilizzo del file
Mantieni i file al di sotto di 500.000 caratteri per prestazioni ottimali
Aggiorna periodicamente i file per mantenere le informazioni accurate
5. Perplexity Search
Perplexity Search consente al tuo Agente di eseguire ricerche web intelligenti utilizzando l'IA di Perplexity, che combina la ricerca in tempo reale con la capacità di sintetizzare e analizzare i risultati.
Come funziona
A differenza di una semplice ricerca web, Perplexity:
Cerca informazioni aggiornate su Internet
Analizza e sintetizza i risultati
Fornisce risposte complete con citazioni delle fonti
Restituisce sia i risultati della ricerca sia una risposta sintetizzata dall'IA
Configurazione di Perplexity Search
Puoi configurare la chiave API in due modi:
Eredita dal tenant: la chiave API viene ereditata dalla configurazione (PaaS) del tenant. Qualsiasi amministratore del tenant può modificare questa chiave in qualsiasi momento nella pagina dedicata. Le modifiche si applicano automaticamente a tutti gli agenti che utilizzano la configurazione del tenant.
Chiave API personalizzata: puoi configurare una chiave API specifica per questo agente.
Passaggi di configurazione
Per abilitare questa funzione:
Nella sezione Funzioni di AIsuru, trova "Perplexity Search"
Abilita l'interruttore per attivare la funzione
Scegli la modalità della chiave API:
Seleziona "Eredita dal tenant" per utilizzare la configurazione centralizzata
Seleziona "Chiave API personalizzata" e inserisci la tua Perplexity API Key nel campo
Premi "Salva" per confermare le impostazioni
Istruzioni
Ricorda di aggiornare le istruzioni del tuo Agente per spiegare come deve comporre la query da passare a Perplexity (che gestirà la ricerca vera e propria).
6. Emozioni
La funzione Emotions di AIsuru consente al tuo Agente di esprimere emozioni attraverso espressioni facciali e animazioni quando viene visualizzato con un avatar 3D. Questo sistema migliora significativamente l'interazione, rendendo la comunicazione più naturale ed espressiva.
Come abilitare la funzione Emotions
Per abilitare questa funzione:
Vai al pannello di gestione del tuo Agente
Vai alla sezione "Funzioni" nella barra laterale
Trova la funzione "Emotions" nella scheda "Funzioni di AIsuru"
Attiva l'interruttore per abilitare questa funzionalità
Come funzionano le Emotions
Quando abiliti la funzione Emotions, il comportamento dipende dal tipo di avatar che stai utilizzando:
Con un avatar: avrai immediatamente accesso a 5 emozioni predefinite che l'avatar può mostrare (Felicità, Tristezza, Rabbia, Sorpresa, Paura)
Con modelli GLB personalizzati: il modello deve includere le animazioni e le espressioni desiderate
La funzione non richiede alcun prompt specifico per essere attivata. Una volta abilitata, il backend di AIsuru gestirà automaticamente le emozioni inserendo i tag necessari nelle risposte dell'Agente in base al contesto della conversazione.
Visualizzazione delle emozioni
Per vedere le emozioni in azione, devi visualizzare il tuo Agente in un ambiente che supporti gli avatar 3D, come:
In AIsuru Spazi virtuali
Utilizzando layout che supportano gli avatar 3D
Sistema di categorizzazione delle animazioni
Il sistema categorizza automaticamente le animazioni in base al loro nome:
IDLE: animazioni di base che si ripetono continuamente (il nome dell'animazione contiene "idle")
LOADING: animazioni che indicano uno stato di attesa (il nome contiene "loading" o "wait")
ACTION: tutte le altre animazioni che mostrano azioni o emozioni specifiche
Modelli GLB personalizzati e animazioni
Se utilizzi un modello GLB personalizzato:
Se il modello ha uno scheletro compatibile con RPM (Ready Player Me), le animazioni standard funzioneranno automaticamente
Il modello deve avere almeno un'animazione IDLE (il nome dell'animazione deve contenere la parola "idle") per funzionare correttamente
Le animazioni vengono attivate dal backend in base al contesto della conversazione
Per risultati ottimali, il modello dovrebbe includere animazioni per le emozioni di base (felicità, tristezza, rabbia, sorpresa, paura)
Personalizzazione avanzata tramite istruzioni
Per un controllo più dettagliato delle animazioni, puoi aggiungere istruzioni specifiche nelle Istruzioni del tuo Agente (Impostazioni > IA > Istruzioni).
Animazioni singole
Animazioni in loop
Dove i valori del loop sono:
[loop=0]: ripete l'animazione all'infinito
[loop=1]: riproduce l'animazione una volta (impostazione predefinita)
[loop=N]: ripete l'animazione N volte
Le animazioni IDLE sono impostate per impostazione predefinita su loop=0 (infinito).
Sequenze di animazioni
Puoi anche specificare un parametro loop per le sequenze:
Emozioni predefinite (per gli avatar RPM)
Guida alle istruzioni dell'Agente
Puoi guidare l'IA generativa aggiungendo istruzioni specifiche nelle Istruzioni del tuo Agente (Impostazioni > IA > Istruzioni).
Esempio di istruzioni per l'Agente:
Esempio di istruzioni per movimenti di danza
Se il tuo modello supporta movimenti specifici, puoi creare istruzioni personalizzate come:
Buone pratiche
Attiva la funzione Emotions dal pannello Funzioni
Non modificare le istruzioni a meno che tu non abbia bisogno di personalizzazioni avanzate
Per un avatar creato con l'avatar maker di AIsuru, il sistema utilizzerà automaticamente le 5 emozioni predefinite
Per i modelli GLB personalizzati, assicurati che abbiano almeno un'animazione IDLE e uno scheletro compatibile
Per le sequenze complesse, utilizza istruzioni avanzate con tag di animazione
Limita le sequenze a 3–5 animazioni per prestazioni ottimali
Testa le animazioni con diversi tipi di avatar per verificarne la compatibilità
Attivando la funzione Emotions, il tuo Agente sarà in grado di comunicare in modo più espressivo e coinvolgente, migliorando significativamente l'esperienza utente negli ambienti 3D.
Considerazioni sulla sicurezza
Per tutte queste funzioni, è fondamentale:
Configurare attentamente le istruzioni dell'Agente
Limitare l'accesso alle risorse sensibili
Monitora l'utilizzo delle funzioni
Implementa meccanismi di verifica
Rispetta le normative sulla privacy e la protezione dei dati
Ottimizzazione delle prestazioni
Per ottenere i migliori risultati:
Combina diverse funzioni in modo sinergico
Mantieni le istruzioni chiare e aggiornate
Monitora regolarmente l'utilizzo delle funzioni
Raccogli il feedback degli utenti
Perfeziona continuamente le configurazioni
Ultimo aggiornamento