Funzioni di AIsuru

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 otto 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. Converti OpenAPI in funzioni: genera automaticamente funzioni a partire da specifiche OpenAPI;

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

  5. Ricerca Perplexity: consente all'Agente di effettuare ricerche web intelligenti con sintesi AI delle informazioni trovate;

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

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

  8. 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 istruzioni.

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

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 tua PaaS).

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;

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

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. Converti OpenAPI in funzioni

La funzione Converti OpenAPI in funzioni ti permette di generare automaticamente funzioni AIsuru a partire da una specifica OpenAPI esistente.

Come funziona

Questa funzione ti permette di:

  • Caricare un file JSON OpenAPI 3.0 con la documentazione di un'API esistente e il relativo webhook;

  • Generare automaticamente tutte le funzioni necessarie per interagire con l'API;

  • Avere funzioni subito pronte con parametri, descrizioni e configurazioni già impostati.

Configurazione della conversione OpenAPI

Per convertire una specifica OpenAPI in funzioni:

  1. Accedi alla sezione Funzioni del tuo Agente;

  2. Seleziona la scheda Funzioni AIsuru;

  3. Clicca su Converti OpenAPI in funzioni;

  4. Nella pagina che si apre:

    • Inserisci l'URL base del webhook: l'indirizzo base dell'API (es. https://api.example.com);

    • Carica il file JSON OpenAPI: il file di specifica OpenAPI 3.0 in formato JSON.

Cosa sono le OpenAPI

Le OpenAPI (precedentemente note come Swagger) sono uno standard per documentare le API REST. Una specifica OpenAPI descrive:

  • Gli endpoint disponibili dell'API;

  • I parametri richiesti per ogni endpoint;

  • I metodi HTTP supportati (GET, POST, PUT, DELETE);

  • Il formato delle risposte;

  • I tipi di dati utilizzati.

Esempio pratico di un agente

Utilizzando l'API REST Countries (https://restcountries.com/v3.1) per ottenere informazioni sui paesi del mondo, dopo aver caricato la specifica OpenAPI, AIsuru ha generato automaticamente queste funzioni:

  • CERCA_PAESE_PER_CAPITALE: Trova un paese cercando per nome della capitale (es. 'Rome', 'Paris')

  • CERCA_PAESE_PER_NOME: Ottieni informazioni dettagliate su un paese cercando per nome (es. 'Italy', 'France')

  • CERCA_PAESI_PER_VALUTA: Trova tutti i paesi che usano una specifica valuta (es. 'EUR', 'USD')

  • OTTIENI_PAESI_PER_REGIONE: Ottieni tutti i paesi di una specifica regione geografica

Tutte le funzioni sono state configurate automaticamente con i parametri necessari (countryName, capitalName, currencyCode, regionName) e sono immediatamente pronte per essere utilizzate dall'Agente.

Come ottenere file OpenAPI

Puoi ottenere file OpenAPI in diversi modi:

1. Documentazione ufficiale dell'API

  • Molte API forniscono file openapi.json o swagger.json

  • Cerca sezioni come /docs, /swagger, /api-docs nel sito dell'API

2. Raccolte pubbliche

  • APIs.guru: raccolta di specifiche OpenAPI pubbliche

  • RapidAPI: migliaia di API con documentazione

  • Repository GitHub: molti progetti includono file OpenAPI

3. Strumenti di conversione

  • Postman Collections: esportabili in formato OpenAPI

  • Insomnia: supporta esportazione OpenAPI

Best practices per la conversione

  1. Usa file OpenAPI 3.0: assicurati che il file sia nella versione corretta

  2. Verifica l'URL base: deve corrispondere esattamente all'endpoint dell'API

  3. Controlla le funzioni generate: rivedi le funzioni create per assicurarti che siano corrette

  4. Testa le funzioni: usa il pulsante "Test" per verificare che funzionino

  5. Aggiorna le istruzioni: spiega all'Agente come e quando usare le nuove funzioni

Istruzioni per l'Agente

Dopo aver generato le funzioni, aggiungi alle istruzioni del tuo Agente informazioni su come utilizzarle. È importante assicurarsi che la descrizione della funzione e dei parametri siano ottimizzate, perché questo garantisce il corretto utilizzo della funzione da parte dell'IA generativa:

Hai accesso alle seguenti funzioni generate da API REST Countries:- CERCA_PAESE_PER_NOME: per cercare informazioni dettagliate su un paese- CERCA_PAESI_PER_VALUTA: per trovare paesi che usano una valuta specificaUsa queste funzioni quando l'utente chiede informazioni sui paesi del mondo.

Rivedi sempre le descrizioni generate automaticamente e, se necessario, modificale per renderle più chiare e specifiche per il tuo caso d'uso.

4. 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

5. Ricerca Perplexity

La Ricerca Perplexity permette al tuo Agente di effettuare ricerche web intelligenti utilizzando l'AI di Perplexity, che combina la ricerca in tempo reale con la capacità di sintetizzare e analizzare le informazioni trovate.

Come funziona

A differenza di una semplice ricerca web, Perplexity:

  • Cerca informazioni aggiornate su internet;

  • Analizza e sintetizza i risultati trovati;

  • Fornisce risposte complete con citazioni delle fonti;

  • Restituisce sia i risultati di ricerca che una risposta elaborata dall'IA.

Configurazione di Ricerca Perplexity

Per attivare questa funzione:

  1. Nella sezione Funzioni di AIsuru, trova "Ricerca Perplexity";

  2. Attiva l'interruttore per abilitare la funzione;

  3. Inserisci la tua API Key di Perplexity nel campo richiesto;

  4. Salva le impostazioni.

Come ottenere l'API Key: Registrati su perplexity.ai, accedi al tuo account e genera una chiave API dalla sezione sviluppatori.

Configurazione nelle istruzioni

È fortemente consigliato spiegare all'Agente nelle istruzioni quando e come utilizzare la ricerca Perplexity:

Usa la funzione Ricerca Perplexity quando l'utente chiede:
- Informazioni attuali su eventi recenti
- Dati aggiornati su aziende, mercati o tecnologie
- Notizie dell'ultimo periodo
- Informazioni che potrebbero essere cambiate dopo il tuo ultimo aggiornamento

NON usare Perplexity per
- Informazioni già presenti nelle tue istruzioni
- Domande personali dell'utente
- Calcoli matematici semplici

Esempio pratico

Utente: "Quali sono le ultime novità su Memori AI?"

Agente (utilizza Ricerca Perplexity):

  • Effettua la ricerca su "Memori AI ultime novità";

  • Riceve risultati da fonti aggiornate (sito ufficiale, GitHub, articoli recenti);

  • Ottiene una sintesi elaborata dall'IA di Perplexity;

  • Risponde all'utente con informazioni aggiornate e citate.

Risposta dell'Agente: "Secondo le informazioni più recenti, Memori AI è una startup italiana specializzata nello sviluppo di intelligenze artificiali conversazionali. La piattaforma si focalizza sulla creazione di AI che crescono attraverso l'interazione con gli utenti, utilizzando un approccio no-code. [Fonte: memori.ai]"

Best practices

  • Limita l'uso: usa Perplexity solo per informazioni che richiedono aggiornamenti in tempo reale;

  • Cita le fonti: incoraggia l'Agente a citare sempre le fonti fornite da Perplexity;

  • Complementa i contenuti: usa Perplexity per integrare, non sostituire, la tua base di conoscenza;

  • Verifica la qualità: monitora le risposte per assicurarti che siano pertinenti e accurate.

6. 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.

Formati supportati e limitazioni

La funzione di navigazione web può leggere diversi tipi di contenuto:

Formati supportati:

  • HTML standard: pagine web tradizionali (limite: 200.000 caratteri)

  • JSON: file di dati strutturati

  • XML: documenti con markup strutturato

  • CSV: file di dati tabulari

  • Testo semplice: file .txt e contenuti testuali

Requisiti tecnici:

  • I contenuti devono essere validi e ben formattati

  • Le pagine HTML devono includere intestazioni e tag appropriati

  • I documenti devono essere completi e accessibili pubblicamente

Funzionalità avanzate:

  • Navigazione automatica: la funzione può seguire automaticamente i link presenti nelle pagine per approfondire la ricerca

  • Analisi contestuale: estrae informazioni pertinenti basandosi sul contesto della conversazione

Limitazioni importanti:

  • Le pagine HTML sono limitate a 200.000 caratteri

  • La funzione funziona solo con contenuti pubblicamente accessibili

  • Per formati non standard o esigenze specifiche, è consigliabile utilizzare una funzione personalizzata

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;

  • Per contenuti molto lunghi o complessi, considerare l'uso di funzioni personalizzate che pre-elaborino i dati.

7. 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.

8. 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.

PreviousCosa sono le funzioniNextFunzioni avanzate

Last updated