AIsuru Docs
AIsuru
AIsuru
  • 0. Introduzione ad AIsuru
    • Cos'è AIsuru
    • Per chi è AIsuru?
    • Panoramica delle funzionalità principali
    • Che differenza c'è con ChatGPT?
    • Requisiti di sistema
  • 1. Primi passi
    • Creazione di un account
    • Navigazione dell'interfaccia utente
    • Creazione del primo Agente
      • Come creare un Agente
      • Importazione rapida di un documento
      • Condivisione
    • Video riassuntivo
    • Gestione account
  • 2. Istruzione dell'Agente e gestione dei contenuti
    • Come istruire un Agente: panoramica dei metodi
    • Istruiscimi: insegna nuove informazioni all'Agente chiacchierando
    • Contenuti
      • Cosa sono i contenuti e perché sono importanti
      • Creazione manuale dei contenuti
      • Validazione e correzione dei contenuti
      • Modifica e aggiornamento dei contenuti
    • Importazione di documenti
      • Come funziona l'importazione di documenti
      • Importare documenti testuali
      • Gestione delle immagini nei documenti
    • Dizionario
    • Istruzione: sezione avanzata
      • Personalizzazione dei contenuti
        • Come attribuire contenuti a persone o ruoli specifici
        • Personalizzare le risposte in base a data e luogo dell'utente
        • Gestione dei suggerimenti
        • Contesto: argomenti ed etichette
        • Gestione dei testi preformattati (snippet di codice)
        • Utilizzo del timeout
      • Importazione avanzata di documenti
        • Creare una gerarchia dei documenti
        • Importare un documento non supportato
      • Messaggio di benvenuto
      • Risposte predefinite
      • Formattazione dei messaggi: HTML e formule matematiche
      • Metodi avanzati di istruzione
  • 3. Modelli linguistici e IA generativa
    • Attiva l'IA generativa e cambia il modello
    • Istruzioni IA
      • Istruzioni IA: cosa sono e come modificarle
      • Come scrivere istruzioni efficaci
      • Esempi di istruzioni efficaci
    • Provider e modelli di IA generativa
    • IA generativa: sezione avanzata
      • Altre impostazioni dell'IA generativa
      • Crea e gestisci le configurazioni dei modelli
      • Cosa fare in caso di problemi
  • 4. Condivisione e pubblicazione
    • Crea e gestisci i layout di condivisione
    • Codice di embed
    • Condividi i tuoi Agenti
      • Condividi un link al tuo Agente
      • Incorpora l'Agente sul tuo sito web
      • Scarica una pagina HTML con il tuo Agente
      • Integra l'Agente con il tuo blog WordPress
      • Inserisci l'Agente all'interno di totem e dispositivi fisici
      • Aggiungi l'Agente al tuo spazio virtuale (VR e AR)
      • Integrazione con WhatsApp Business
    • Visibilità in homepage
    • Condivisione: sezione avanzata
      • Domanda iniziale
      • Personalizzazione avanzata dell'interfaccia utente
      • Analisi del codice di embed
      • Modificare il nome dell'Agente
  • 5. Funzionalità avanzate
    • Backup dell'Agente
    • Trasferimento e cancellazione dell'Agente
    • Integrazioni
      • Funzioni
        • Cosa sono le funzioni
        • Funzioni di AIsuru
        • Funzioni avanzate
          • Come configurare una funzione personalizzata
          • Funzioni avanzate: best practice e casi d'uso
            • Caso d'uso - Aggiornamento automatico: il tuo Agente sempre connesso al web
            • Caso d'uso - Prendere dati live da un servizio esterno
          • Problemi comuni con le funzioni avanzate
          • Cache delle funzioni
      • Intenti dinamici
        • Cosa sono e come configurare gli intenti dinamici
        • Come usare gli slot
        • Tunneling: esempio di una live chat su AIsuru
      • Intenti dinamici o funzioni, cosa usare?
      • Copia gli intenti dinamici, gli slot e le funzioni da un altro Agente
    • Gestione degli utenti
      • Differenza tra autori e persone
      • Invito e gestione degli autori
      • Creazione e gestione delle persone
    • Fine-tuning
      • Cos'è il fine-tuning e a cosa serve
      • Come fare fine-tuning in maniera semplice con AIsuru
      • Come sfruttare modelli fine-tuned su AIsuru
    • Interfacce web: come creare esperienze interattive
  • 6. Consumi e Analytics
    • Consumi
      • Come funzionano i consumi?
      • Monitora i tuoi consumi
      • Come ricaricare i crediti
    • Analisi e ottimizzazione dell'Agente
      • Statistiche
      • Storico delle conversazioni
      • Velocità di risposta
      • Preferenze notifiche
  • 7. Estensioni
    • Gruppo di esperti
      • Cosa sono i gruppi di esperti
      • Creare un gruppo di esperti
      • Come aggiungere Agenti al gruppo e descriverli
      • Come sfruttare i contenuti nel gruppo di esperti
      • Gruppo di esperti: best practice e casi d'uso
    • Pensiero Profondo
      • Cosa è Pensiero Profondo
      • Attivazione e configurazione
      • Gestione delle memorie
      • Best practices e casi d'uso
      • Analytics
        • Ricerca interessi degli utenti
        • Ricerca di segmenti di pubblico in linguaggio naturale
    • Spazi Virtuali (VR e MR)
      • Cosa è uno spazio virtuale
      • Creazione di uno spazio virtuale
      • Aggiungere Agenti agli spazi virtuali
      • Aggiungere oggetti agli spazi virtuali
      • Entrare in uno spazio virtuale
      • Casi d'uso
    • Open Badge
  • 8. Platform as a Service (PaaS)
    • Vantaggi della PaaS
    • Come attivare e configurare la PaaS
    • Come collegare la PaaS al tuo dominio
    • Gestione degli utenti nella PaaS
    • Come controllare i consumi della piattaforma
    • Personalizzazione dell'ambiente PaaS
    • Sicurezza e privacy
    • Supporto e manutenzione
  • 9. Documentazione Frontend
    • ⚛️ Componente React
    • 🌐 Web Component
    • 🎨 Stile e Personalizzazione
    • 🔌 Client API
  • 10. Risorse aggiuntive
    • Glossario dei termini
    • Link utili e supporto
    • API Engine
      • ChatLogs
      • ContextVars
      • CorrelationPairs
      • CustomDictionary
      • Dialog
      • EventLogs
      • ExpertReferences
      • Functions
      • Intents
      • LocalizationKeys
      • Media
      • Memories
      • NLP
      • People
      • Search
      • Session
      • Stats
      • Topics
      • UnansweredQuestions
      • User
      • WebHooks
      • Models
Powered by GitBook
On this page
  • Panoramica delle funzioni disponibili
  • 1. Variabili di contesto
  • 2. Invio email
  • 3. Creazione di funzione da file
  • 4. Ricerca web avanzata
  • 5. Wikipedia
  • 6. Emotions
  • Considerazioni sulla sicurezza
  • Ottimizzazione delle prestazioni
  1. 5. Funzionalità avanzate
  2. Integrazioni
  3. Funzioni

Funzioni di AIsuru

PreviousCosa sono le funzioniNextFunzioni avanzate

Last updated 21 days ago

AIsuru offre una serie di funzioni integrate 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.

Panoramica delle funzioni disponibili

AIsuru offre sei funzioni integrate principali:

  1. Variabili di contesto: permettono all'Agente di gestire dinamicamente gli argomenti della conversazione;

  2. Invio email: permette all'Agente di inviare comunicazioni email agli utenti registrati;

  3. Creazione di funzione da file: permetti all'agente di accedere a quel file durante le conversazioni;

  4. Ricerca web avanzata: consente all'Agente di accedere e analizzare contenuti web in tempo reale;

  5. Wikipedia: offre accesso diretto alle informazioni dell'enciclopedia online.

  6. Emotions: permette al tuo Agente di esprimere emozioni attraverso espressioni facciali e animazioni quando viene visualizzato con un avatar 3D.

Puoi cominciare ad utilizzarle da subito: ti basterà attivare l'interruttore della funzione che vuoi utilizzare all'interno del tuo Agente!

Ricorda, però, che per semplificare l'interazione con l'Agente e migliorare l'esperienza utente, è necessario spiegare all'Agente come e quando utilizzarle all'interno delle .

Vediamole nel dettaglio 👇

1. Variabili di contesto

Le variabili di contesto permettono al tuo Agente di gestire dinamicamente i contesti durante la conversazione.

Questa funzione è particolarmente utile per:

  • Applicare automaticamente contesti specifici in base alle risposte dell'utente;

  • Rimuovere contesti quando non sono più rilevanti;

  • Guidare la conversazione in modo naturale tra diversi argomenti.

Come funziona

L'IA generativa può:

  • Impostare un nuovo contesto quando riconosce un cambio di argomento;

  • Rimuovere un contesto quando l'argomento non è più pertinente;

  • Utilizzare più contesti contemporaneamente per rispondere in modo preciso.

Configurazione nelle istruzioni

È importante guidare l'Agente nell'utilizzo delle variabili di contesto attraverso le istruzioni, specificando:

  • Quali contesti può applicare (specifica precisamente il contesto da applicare);

  • Quando applicare i diversi contesti;

  • Come gestire il passaggio tra contesti diversi: quali contesti sono compatibili tra loro e quando rimuovere i contesti non più rilevanti.

Ad esempio:

Quando si parla di un prodotto specifico, imposta 
PRODOTTO:[nome prodotto]. Se l'utente cambia argomento, 
rimuovi il contesto con PRODOTTO:-. 
Esempio: se l'utente chiede del prodotto X, imposta PRODOTTO:X

2. Invio email

Configurazione dell'invio email

Per configurare l'invio email nel tuo Agente:

  1. Nella sezione Funzioni di AIsuru, trova il riquadro "Invio Email";

  2. Attiva la funzione utilizzando l'interruttore;

  3. Si apriranno i campi di configurazione SMTP necessari:

    • Server SMTP: l'indirizzo del server email (es. smtp.gmail.com per Gmail);

    • Nome utente: il tuo indirizzo email completo;

    • Password: la password dell'account email (o password applicazione per Gmail);

    • Porta: la porta SMTP;

    • Email del mittente: l'indirizzo che apparirà come mittente;

    • Nome del mittente: il nome che apparirà come mittente.

  4. Premi il tasto "Salva" per confermare le impostazioni;

Gestione attraverso le istruzioni

È cruciale definire nelle istruzioni:

  • In quali situazioni l'Agente può inviare email;

  • Quali informazioni può includere;

  • Il tono e lo stile della comunicazione.

Ad esempio:

Invia email solo quando l'utente richiede esplicitamente 
di ricevere documentazione. Se te lo chiede, ricordagli 
che riceverà la mail nella casella di posta.

Formato email:
- Oggetto: "Documentazione richiesta - [prodotto]"
- Corpo: breve introduzione, link alla documentazione, contatti 
per supporto (telefono e indirizzo email)

Ricorda di NON INVIARE MAI PIÙ DI DUE EMAIL all'interno della stessa conversazione.

L'utente che interagisce con il tuo Agente non avrà bisogno di fornire il suo indirizzo email: viene preso automaticamente dall'Agente. Questa integrazione non funziona con gli utenti che interagiscono senza essersi registrati ed aver effettuato il login.

Best practices per l'invio email

  • Definire template chiari per diversi tipi di comunicazione;

  • Stabilire limiti per la frequenza di invio all'interno della conversazione;

  • Implementare verifiche di sicurezza;

  • Gestire correttamente i dati personali;

3. Creazione di funzione da file

La funzione di creazione da file permette all'Agente di accedere a file come Excel, PDF, HTML o TXT durante le conversazioni, consentendogli di utilizzare informazioni contenute in questi documenti.

Come funziona

Questa funzione ti permette di:

  • Caricare un file (Excel, PDF, HTML o TXT) di dimensione inferiore a 500.000 caratteri

  • Fornire una descrizione che spieghi all'IA generativa come utilizzare questo file durante le conversazioni

  • Rendere il file accessibile all'Agente come fonte di informazioni

Configurazione della funzione da file

Per creare una nuova funzione a partire da un file:

  1. Accedi alla sezione Funzioni del tuo Agente

  2. Seleziona la scheda Funzioni avanzate

  3. Clicca sul pulsante Crea funzione da file

  4. Nella pagina che si apre, potrai:

    • Caricare un file (Excel, PDF, HTML o TXT) di dimensione inferiore a 500.000 caratteri

    • Inserire una descrizione della funzione che spieghi all'IA generativa come utilizzare il contenuto del file

La descrizione della funzione è fondamentale: deve indicare chiaramente all'IA quando utilizzare questa funzione e come interpretare i dati del file.

Esempio di utilizzo

Se carichi un listino prezzi in formato Excel, potresti scrivere una descrizione come:

Utilizza questa funzione quando l'utente chiede informazioni sui prezzi dei nostri prodotti.

Il file contiene il listino prezzi aggiornato con le seguenti colonne:
- Codice prodotto
- Nome prodotto
- Categoria
- Prezzo di listino
- Prezzo scontato
- Disponibilità

Quando l'utente chiede il prezzo di un prodotto specifico, cerca nel listino e fornisci tutte le informazioni disponibili per quel prodotto.

Best practices per la creazione di funzioni da file

  • Utilizza file ben strutturati per facilitare la lettura da parte dell'IA

  • Fornisci descrizioni dettagliate che guidino l'IA nell'utilizzo del file

  • Mantieni i file sotto il limite di 500.000 caratteri per prestazioni ottimali

  • Aggiorna periodicamente i file per mantenere le informazioni sempre corrette

4. Ricerca web avanzata

La ricerca web avanzata permette all'Agente di accedere e analizzare contenuti da pagine web in tempo reale. Questo strumento potenzia significativamente le capacità informative dell'Agente.

Funzionalità principali

  • Accesso a pagine web specifiche menzionate nelle istruzioni o dall'utente nella conversazione;

  • Analisi di contenuti web in tempo reale;

  • Estrazione di informazioni pertinenti.

Gestione dell'accesso

Nelle istruzioni dell'Agente, è fondamentale definire:

  • Quali domini web sono accessibili -> deve limitarsi a visitare specifici link contenuti nelle istruzioni o può accettare anche link da parte degli utenti fruitori dell'Agente?

  • Come gestire i link forniti dagli utenti -> quali informazioni deve estrarre e come deve utilizzarle?

Ad esempio:

Usa la ricerca web solo per le pagine del nostro sito web 
(www.azienda.com) quando l'utente chiede informazioni sui 
prodotti. NON VISITARE MAI SITI ESTERNI A QUELLO DELLA NOSTRA AZIENDA.
Se l'utente ti fornisce un sito web, NON VISITARLO MAI e
RISPONDI CHE NON SEI IN GRADO DI VISITARE SITI ESTERNI.
Estrai solo: nome prodotto, prezzo, disponibilità.

Best practice

  • Limitare l'accesso a domini specifici e affidabili;

  • Definire chiaramente come utilizzare le informazioni estratte;

  • Stabilire regole per la citazione delle fonti;

  • Impostare linee guida per la verifica delle informazioni.

  • Prevedere meccanismi di conferma prima dell'invio.

5. Wikipedia

L'integrazione con Wikipedia permette all'Agente di accedere direttamente alla più grande enciclopedia online, arricchendo le sue risposte con informazioni verificate e aggiornate.

Caratteristiche principali

  • Ricerca diretta di articoli Wikipedia;

  • Estrazione di informazioni pertinenti;

  • Citazione automatica delle fonti.

Configurazione ottimale

Nelle istruzioni, specifica:

  • Quando utilizzare Wikipedia come fonte;

  • Come integrare le informazioni nelle risposte;

  • Come gestire informazioni contrastanti;

  • Come citare correttamente le fonti.

Ad esempio:

Usa Wikipedia solo quando l'utente chiede esplicitamente 
informazioni storiche o definizioni. Cita sempre la fonte 
dicendo "Secondo Wikipedia..." e fornisci solo le informazioni essenziali.

6. Emotions

La funzione Emotions di AIsuru permette 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 attivare la funzione Emotions

Per attivare questa funzione:

  1. Accedi al pannello di gestione del tuo Agente

  2. Vai alla sezione "Funzioni" dalla barra laterale

  3. Trova la funzione "Emotions" nella scheda "Funzioni di AIsuru"

  4. Attiva l'interruttore per abilitare questa funzionalità

Come funzionano le Emotions

Quando attivi la funzione Emotions, il comportamento dipende dal tipo di avatar che stai utilizzando:

  • Con avatar Ready Player Me (RPM): Avrai immediatamente accesso a 5 emozioni predefinite che possono essere mostrate dall'avatar (Felicità, Tristezza, Rabbia, Sorpresa, Paura)

  • Con modelli GLB personalizzati: È necessario che il modello includa 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:

  • Negli Spazi Virtuali di AIsuru

  • Utilizzando layout che supportano 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 di tipo 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 un funzionamento ottimale, il modello dovrebbe includere animazioni per le emozioni di base (felicità, tristezza, rabbia, sorpresa, paura)

Personalizzazioni avanzate tramite istruzioni

Per un controllo più dettagliato delle animazioni, puoi aggiungere istruzioni specifiche nelle Istruzioni del tuo Agente (Impostazioni > IA > Istruzioni).

Animazioni singole

<output class="animation">NomeAnimazione</output>

Animazioni con loop

<output class="animation">NomeAnimazione[loop=N]</output>

Dove i valori per il loop sono:

  • [loop=0]: Ripete l'animazione all'infinito

  • [loop=1]: Riproduce l'animazione una sola volta (impostazione predefinita)

  • [loop=N]: Ripete l'animazione N volte

Le animazioni di tipo IDLE hanno un valore predefinito di loop=0 (infinito).

Sequenze di animazioni

<output class="animation-sequence">Animazione1->Animazione2->Animazione3</output>

È possibile specificare un parametro loop anche per le sequenze:

<output class="animation-sequence">Animazione1->Animazione2->Animazione3[loop=2]</output>

Emozioni predefinite (per avatar RPM)

<output class="memori-emotion">Happiness</output>  <!-- o Sadness, Anger, Surprise, Fear -->

Guida per le istruzioni all'Agente

Puoi guidare l'IA generativa aggiungendo specifiche istruzioni nelle Istruzioni del tuo Agente (Impostazioni > IA > Istruzioni).

Esempio di istruzioni per l'Agente:

GUIDA PER LE ESPRESSIONI EMOTIVE:Quando comunichi con l'utente, esprimi le tue emozioni scrivendo precisamente i seguenti pattern:1. Per una SEQUENZA DI EMOZIONI: <output class="animation-sequence">Surprise->Happiness</output> Esempio: "All'inizio ero sorpreso, ma ora sono felice della notizia! <output class="animation-sequence">Surprise->Happiness</output>"2. Per ANIMAZIONI RIPETUTE (usa per enfatizzare): <output class="animation">Wave[loop=3]</output>Esempio: "Ti saluto con entusiasmo! <output class="animation">Wave[loop=3]</output>"

Esempio di istruzioni per movimenti di danza

Se il tuo modello supporta movimenti specifici, puoi creare istruzioni personalizzate come:

MOVIMENTI DI DANZA:- AIDA1: Giro lento con le braccia distese verso l'alto- AIDA2: Movimento ondulatorio dei fianchi e delle braccia- AIDA3: Passo laterale con incrocio delle gambe e rotazione del bustoSTATI EMOTIVI:- Gioia (Gioia1, Gioia2, Gioia3)- Tristezza (Tristezza1, Tristezza2, Tristezza3)Per creare una sequenza di danza, usa questa sintassi:<output class="animation-sequence">AIDA1->AIDA2->Gioia1->AIDA3</output>Regole per le sequenze:1. Usa -> per collegare le animazioni2. Massimo 5 animazioni per sequenza3. Non usare spazi4. Puoi combinare liberamente movimenti di danza ed emozioni nella stessa sequenza

Best Practices

  1. Attiva la funzione Emotions dal pannello Funzioni

  2. Non modificare le istruzioni se non hai bisogno di personalizzazioni avanzate

  3. Per avatar Ready Player Me, il sistema utilizzerà automaticamente le 5 emozioni predefinite

  4. Per modelli GLB personalizzati, assicurati che abbiano almeno un'animazione di tipo IDLE e uno scheletro compatibile

  5. Per sequenze complesse, utilizza le istruzioni avanzate con i tag di animazione

  6. Limita le sequenze a 3-5 animazioni per le migliori prestazioni

  7. 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 nelle interazioni in ambienti 3D.

Considerazioni sulla sicurezza

Per tutte queste funzioni, è fondamentale:

  • Configurare attentamente le istruzioni dell'Agente;

  • Limitare l'accesso a risorse sensibili;

  • Monitorare l'utilizzo delle funzioni;

  • Implementare meccanismi di verifica;

  • Rispettare 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 feedback dagli utenti;

  • Affina continuamente le configurazioni.

La funzione di invio email permette all'Agente di inviare comunicazioni email a tutti gli utenti registrati in piattaforma (su aisuru.com o all'interno della ).

Non sai come recuperare queste informazioni? Consulta le apposite guide per e . Se utilizzi un altro provider email, puoi cercare "SMTP [nome provider]" con il tuo motore di ricerca preferito.

istruzioni
tua PaaS
Gmail
Outlook