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:
Variabili di contesto: permettono all'Agente di gestire dinamicamente gli argomenti della conversazione;
Invio email: permette all'Agente di inviare comunicazioni email agli utenti registrati;
Converti OpenAPI in funzioni: genera automaticamente funzioni a partire da specifiche OpenAPI;
Creazione di funzione da file: permetti all'agente di accedere a quel file durante le conversazioni;
Ricerca Perplexity: consente all'Agente di effettuare ricerche web intelligenti con sintesi AI delle informazioni trovate;
Ricerca web avanzata: consente all'Agente di accedere e analizzare contenuti web in tempo reale;
Wikipedia: offre accesso diretto alle informazioni dell'enciclopedia online.
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:
Nella sezione Funzioni di AIsuru, trova il riquadro "Invio Email";
Attiva la funzione utilizzando l'interruttore;
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.
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.
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:
Accedi alla sezione Funzioni del tuo Agente;
Seleziona la scheda Funzioni AIsuru;
Clicca su Converti OpenAPI in funzioni;
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
oswagger.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
Usa file OpenAPI 3.0: assicurati che il file sia nella versione corretta
Verifica l'URL base: deve corrispondere esattamente all'endpoint dell'API
Controlla le funzioni generate: rivedi le funzioni create per assicurarti che 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
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.
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:
Accedi alla sezione Funzioni del tuo Agente
Seleziona la scheda Funzioni avanzate
Clicca sul pulsante Crea funzione da file
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:
Nella sezione Funzioni di AIsuru, trova "Ricerca Perplexity";
Attiva l'interruttore per abilitare la funzione;
Inserisci la tua API Key di Perplexity nel campo richiesto;
Salva le impostazioni.
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:
Accedi al pannello di gestione del tuo Agente
Vai alla sezione "Funzioni" dalla barra laterale
Trova la funzione "Emotions" nella scheda "Funzioni di AIsuru"
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
Attiva la funzione Emotions dal pannello Funzioni
Non modificare le istruzioni se non hai bisogno di personalizzazioni avanzate
Per avatar Ready Player Me, il sistema utilizzerà automaticamente le 5 emozioni predefinite
Per modelli GLB personalizzati, assicurati che abbiano almeno un'animazione di tipo IDLE e uno scheletro compatibile
Per sequenze complesse, utilizza le istruzioni avanzate con i tag di animazione
Limita le sequenze a 3-5 animazioni per le migliori prestazioni
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.
Last updated