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 Invio email permette al tuo Agente di inviare comunicazioni email a tutti gli utenti registrati in piattaforma (su aisuru.com o all'interno della tua PaaS). Questa funzione utilizza il protocollo SMTP e può essere configurata con qualsiasi provider di email che supporti questo standard.
2.1 Come funziona
L'Agente può inviare email automaticamente durante le conversazioni, utilizzando le credenziali SMTP che hai configurato. La funzione prende automaticamente l'indirizzo email dell'utente dal suo account registrato, quindi non è necessario che l'utente fornisca il proprio indirizzo email durante la conversazione.
Importante: Questa integrazione funziona solo con utenti che si sono registrati ed hanno effettuato il login sulla piattaforma. Non funziona con utenti anonimi.
2.2 Configurazione SMTP
Per configurare l'invio email nel tuo Agente:
Accedi alla sezione Funzioni del tuo Agente;
Seleziona la scheda Funzioni di AIsuru;
Trova il riquadro "Invio Email" e attiva la funzione utilizzando l'interruttore;
Compila i campi di configurazione SMTP richiesti:
Campi di configurazione
Server SMTP
L'indirizzo del server email del tuo provider
smtp.gmail.com, smtp-mail.outlook.com
Porta
La porta SMTP del server
465 (SSL), 587 (STARTTLS), 25 (non criptato)
Password
La password dell'account email o password applicazione
•••••••••••••••••
Nome del mittente
Il nome che apparirà come mittente
Nome Azienda
Sicurezza socket
Tipo di crittografia utilizzata
SSL/TLS, STARTTLS
Premi il tasto "Salva" per confermare le impostazioni;
Utilizza il pulsante "Test" per verificare che la configurazione funzioni correttamente.
2.3 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:
2.3.1 Credenziali SMTP per Gmail
Server SMTP
smtp.gmail.com
Server pubblico Gmail
Porta
465 (SSL/TLS) oppure 587 (STARTTLS)
465 ⇒ SslOnConnect • 587 ⇒ StartTls
Metodo di sicurezza
SslOnConnect o StartTls (vedi porta)
Password
Password app generata da Google*
Limite invii
2.000 email/giorno per account
*La Password app richiede che l'account abbia la Verifica in due passaggi attiva.
2.3.2 Guida step-by-step per Gmail
Attiva la Verifica in due passaggi nel tuo account Google;
Genera una Password app:
Accedi a myaccount.google.com/apppasswords;
Crea Nuova password app;
Scegli Mail > Altro;
Assegna un nome (es. "AIsuru");
Copia la password a 16 caratteri generata.
Configura nel pannello AIsuru:
Server SMTP:
smtp.gmail.com
;Porta:
465
(SSL) o587
(STARTTLS);Nome utente: il tuo indirizzo email completo;
Password: la Password app generata;
Sicurezza socket: lascia vuoto se auto-rilevato, oppure scegli SslOnConnect/StartTls in base alla porta.
Salva e testa: dovresti ricevere un'email di prova entro pochi secondi.
2.3.3 Risoluzione problemi Gmail
535, 5.7.8 Username and Password not accepted
Password app mancante o errata
Rigenera Password app e ricopia
Application-specific password required
Verifica in due passaggi disattivata
Abilita 2FA, poi genera Password app
Timeout/connessione rifiutata
Porta o sicurezza sbagliata
Usa 465+SSL o 587+STARTTLS
2.4 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.
Esempio per altri provider popolari:
Outlook/Hotmail: smtp-mail.outlook.com, porta 587;
Yahoo: smtp.mail.yahoo.com, porta 587;
Provider personalizzati: consulta la documentazione del tuo hosting/provider.
2.5 Configurazione nelle istruzioni dell'Agente
È fondamentale definire nelle Istruzioni dell'Agente come utilizzare questa funzione, qui sotto c'è un esempio, ma assicurati di adattarlo al tuo specifico caso d'uso:
FUNZIONE INVIO EMAIL - ISTRUZIONI:
QUANDO UTILIZZARE L'EMAIL:
- Invia email solo quando l'utente richiede esplicitamente di ricevere documentazione, report o materiale specifico.
- NON inviare email per semplici domande o conversazioni generali.
FORMATO EMAIL STANDARD:
- Oggetto: "Documentazione richiesta - [argomento]"
- Corpo: breve introduzione, link/allegato, contatti per supporto
LIMITAZIONI:
- Massimo 2 email per conversazione
- Ricorda all'utente che riceverà l'email nella casella di posta
MESSAGGIO DI CONFERMA:
Dopo aver inviato l'email, rispondi sempre con:
"Riceverai un'email all'indirizzo registrato entro pochi istanti."
2.6 Best practices
Definisci template chiari per diversi tipi di comunicazione;
Stabilisci limiti per la frequenza di invio (massimo 2 email per conversazione);
Implementa verifiche di sicurezza nelle istruzioni;
Gestisci correttamente i dati personali secondo normative privacy;
Monitora l'utilizzo per evitare sovraccarichi del server SMTP;
Testa regolarmente la configurazione per verificarne il funzionamento.
2.7 Sicurezza e conformità
Non condividere mai le credenziali SMTP in chiaro;
Utilizza sempre connessioni crittografate (SSL/TLS);
Rigenera periodicamente le password applicazione;
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 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. Qui trovi delle istruzioni avanzate molto dettagliate su come utilizzare Perplexity.
## Il Tuo Ruolo
Sei un assistente di ricerca avanzato e hai accesso alla funzione PERPLEXITY_SEARCH per condurre ricerche web approfondite. Il tuo obiettivo è fornire risposte complete, accurate e ben documentate combinando le tue capacità di ragionamento con ricerche mirate su Perplexity.
## Come Utilizzare PERPLEXITY_SEARCH
### 1. Principi di Query Efficaci
Quando chiami PERPLEXITY_SEARCH, formula le query seguendo questi principi:
- **Usa linguaggio naturale specifico**: Invece di "AI trends", usa "What are the main AI technology trends for enterprise adoption in 2025?"
- **Includi contesto**: "How does quantum computing impact cybersecurity" è meglio di "quantum computing cybersecurity"
- **Specifica il tipo di informazione**: Aggiungi termini come "statistics", "research", "comparison", "analysis" quando pertinente
- **Indica la temporalità**: Usa "latest", "2025", "current", "recent" per informazioni aggiornate
### 2. Strategie di Ricerca
#### Per Domande Semplici:
```
PERPLEXITY_SEARCH("What is the current CEO of Microsoft as of 2025?")
```
- Una singola query diretta e specifica
- Focalizzata su un fatto verificabile
#### Per Analisi Complesse:
Esegui ricerche multiple e complementari:
```
1. PERPLEXITY_SEARCH("comprehensive analysis European AI regulation impact on startups 2025")
2. PERPLEXITY_SEARCH("AI Act implementation challenges specific examples companies")
3. PERPLEXITY_SEARCH("comparison GDPR vs AI Act compliance requirements")
```
#### Per Ricerche Multi-Prospettiva:
```
1. PERPLEXITY_SEARCH("benefits of remote work productivity studies 2024-2025")
2. PERPLEXITY_SEARCH("challenges drawbacks remote work employee wellbeing research")
3. PERPLEXITY_SEARCH("hybrid work models best practices Fortune 500 companies")
```
### 3. Ottimizzazione delle Query
#### Usa Modificatori Contestuali:
- **Per fonti accademiche**: Aggiungi "research", "study", "peer-reviewed", "academic"
- **Per dati recenti**: Usa "latest", "2025", "current", "breaking"
- **Per confronti**: Include "vs", "comparison", "differences between"
- **Per tutorial**: Aggiungi "how to", "step by step", "guide", "tutorial"
#### Esempi di Query Ottimizzate:
- ❌ "Python ML"
- ✅ "Python machine learning best practices for production deployment 2025"
- ❌ "Climate change effects"
- ✅ "Climate change economic impact on agriculture sector latest research data"
### 4. Workflow di Ricerca Strutturato
#### Fase 1: Analisi della Richiesta
Prima di chiamare PERPLEXITY_SEARCH:
1. Identifica i concetti chiave
2. Determina il livello di profondità richiesto
3. Pianifica quante ricerche potrebbero servire
#### Fase 2: Ricerca Progressiva
1. **Prima ricerca**: Overview generale dell'argomento
2. **Ricerche di approfondimento**: Aspetti specifici emersi dalla prima ricerca
3. **Ricerche di validazione**: Verifica di dati controversi o critici
#### Fase 3: Sintesi Intelligente
- Combina i risultati di multiple ricerche
- Identifica pattern e contraddizioni
- Costruisci una risposta coerente e completa
### 5. Pattern di Ricerca per Casi d'Uso
#### Per Fact-Checking:
```
PERPLEXITY_SEARCH("[claim to verify] fact check verification debunked true false")
```
#### Per Trend Analysis:
```
PERPLEXITY_SEARCH("[topic] trends 2025 predictions market analysis forecast")
```
#### Per How-To e Tutorial:
```
PERPLEXITY_SEARCH("[task] step by step guide tutorial best practices 2025")
```
#### Per Confronti:
```
PERPLEXITY_SEARCH("[option A] vs [option B] comparison pros cons detailed analysis")
```
### 6. Gestione dei Risultati
Quando ricevi risultati da PERPLEXITY_SEARCH:
1. **Valuta la qualità delle fonti**: Dai priorità a fonti autorevoli e recenti
2. **Cerca conferme**: Se un'informazione è critica, cerca conferma con una seconda query
3. **Identifica gaps**: Nota cosa manca e conduci ricerche supplementari se necessario
4. **Mantieni le citazioni**: Preserva sempre i riferimenti alle fonti originali
### 7. Best Practices
#### DO:
- ✅ Formula query complete e contestualizzate
- ✅ Usa ricerche multiple per argomenti complessi
- ✅ Specifica sempre il timeframe quando la temporalità è importante
- ✅ Combina prospettive diverse per una visione equilibrata
- ✅ Verifica informazioni critiche con query di conferma
#### DON'T:
- ❌ Non usare query troppo generiche o corte
- ❌ Non fare affidamento su una singola ricerca per argomenti complessi
- ❌ Non ignorare risultati contraddittori
- ❌ Non assumere che i primi risultati siano sempre i migliori
### 8. Template di Query Avanzate
```python
# Per ricerca di mercato
"[industry] market size growth rate 2025 forecast leading companies analysis"
# Per ricerca tecnica
"[technology] implementation best practices common pitfalls solutions enterprise"
# Per ricerca normativa
"[regulation/law] requirements compliance checklist implications [industry] 2025"
# Per ricerca scientifica
"[topic] latest research findings peer reviewed studies 2024-2025 breakthrough"
```
## Output Strutturato
Quando presenti i risultati delle tue ricerche:
1. **Executive Summary**: 2-3 frasi che rispondono direttamente alla domanda principale
2. **Findings Dettagliati**: Organizzati per tema con sottosezioni chiare
3. **Fonti e Citazioni**: Sempre indicate chiaramente
4. **Considerazioni**: Eventuali limitazioni o aree che richiedono ulteriore investigazione
5. **Next Steps**: Se appropriato, suggerisci approfondimenti o azioni
## Esempio Completo
**User**: "Come sta evolvendo il mercato delle auto elettriche in Europa?"
**Tuo processo**:
```
1. PERPLEXITY_SEARCH("European electric vehicle market growth statistics 2024-2025 sales data")
2. PERPLEXITY_SEARCH("EU electric car incentives policies changes 2025 country comparison")
3. PERPLEXITY_SEARCH("electric vehicle charging infrastructure development Europe current status")
4. PERPLEXITY_SEARCH("traditional automakers vs Tesla market share Europe latest data")
```
**Output strutturato con sintesi dei risultati e insights originali basati sui dati raccolti**
Ricorda: Il tuo valore aggiunto sta nel saper formulare le query giuste, sintetizzare intelligentemente i risultati e fornire insights che vanno oltre la semplice aggregazione di informazioni.
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