Come configurare una funzione personalizzata

Accesso alla sezione delle funzioni

Per creare una nuova funzione personalizzata in AIsuru, segui questi passaggi:

1. Accedi al pannello di gestione del tuo Agente;

2. Seleziona "Funzioni" nella barra laterale;

3. Clicca sul tab "Funzioni avanzate" nella parte superiore della pagina;

4. Premi su "Nuova funzione" per iniziare la configurazione.

Configurazione di una nuova funzione

Nella schermata di creazione di una nuova funzione, dovrai compilare i seguenti campi:

Informazioni di base

• Nome: inserisci un nome univoco e descrittivo per la tua funzione. Questo nome sarà usato internamente dal sistema per identificare la funzione.

  • Limite: il nome può contenere massimo 64 caratteri

  • Formato: usa solo lettere, numeri e underscore (_), senza spazi o caratteri speciali

  • Esempi validi: ottieni_meteo, cerca_prodotti, invia_email_cliente

• Descrizione: fornisci una descrizione completa della funzione, dovresti sempre specificare:

  • A cosa serve la funzione

  • Quando utilizzare la funzione

  • Che output deve restituire e come formattarlo

Questa descrizione è fondamentale poiché aiuta l'IA generativa a comprendere quando e come utilizzare la funzione nel contesto di una conversazione.

Nota: Se usi i modelli di OpenAI (come GPT-4o e GPT-4o mini) la descrizione non può superare i 1024 caratteri. Se ti serve avere una descrizione particolarmente lunga ti consigliamo di utilizzare altri modelli per le domande e le risposte o di spostare parte della descrizione all'interno delle istruzioni.

Esempi di descrizione di una funzione

Esempio di una funzione utile ad inviare email

Utilizza questa funzione per inviare notifiche email. La funzione deve essere chiamata SOLO quando:
- L'utente richiede esplicitamente di essere contattato;
- L'utente vuole ricevere materiale informativo specifico;
- L'utente chiede una demo.

Parametri richiesti:
- email: l'indirizzo email del destinatario (CHIEDI SEMPRE all'utente)
- tipo: il tipo di informazioni richieste (NON chiedere all'utente, deducilo dalla conversazione)
- messaggio: il contenuto specifico da inviare (componi un testo appropriato basandoti sulla richiesta)

Prima di chiamare la funzione, assicurati di avere compreso esattamente quale tipo di informazione l'utente desidera ricevere.

Esempio di una funzione per ricercare prodotti all'interno di un catalogo

Utilizza questa funzione per ottenere informazioni dal catalogo prodotti in base alla categoria richiesta dall'utente. La funzione dovrebbe essere chiamata quando l'utente chiede informazioni su specifiche categorie di prodotti.

Le categorie disponibili sono:
- computers: per informazioni su laptop e desktop;
- phones: per informazioni su smartphone e telefoni;
- tablets: per informazioni su tablet e e-reader.

Utilizza il parametro {category} impostandolo nel webhook sulla categoria appropriata in base alla richiesta. Ad esempio, se l'utente chiede informazioni sui computer portatili, usa "computers" come valore del parametro.

Non mostrare mai il valore del parametro all'utente, usa solo le informazioni restituite dalla funzione per formulare la risposta.

Configurazione del webhook

• Webhook: inserisci l'indirizzo web completo che verrà utilizzato quando la funzione è attivata. Ad esempio, se usi Zapier, dovrai inserire l'indirizzo fornito da Zapier (viene chiamato, appunto, webhook).

• Metodo HTTP: seleziona il metodo HTTP appropriato per la tua richiesta al webhook. La scelta dipende dall'azione che la funzione deve eseguire:

  • GET (opzione di default) -> per ottenere informazioni, come leggere un articolo online

  • POST -> per inviare nuove informazioni, come compilare un modulo online

  • PATCH -> per modificare parzialmente informazioni esistenti, come aggiornare solo alcuni campi di un profilo online;

  • DELETE -> per eliminare informazioni, come cancellare un account

✅ Se non devi passare parametri o altre informazioni, puoi fermarti qui con la configurazione.

Dettagli della richiesta

Se devi inviare altre informazioni al tuo servizio (come un nome, una data o un indirizzo email), allora potresti dover specificare altri dettagli:

• Header HTTP: qui puoi aggiungere altre informazioni necessarie per la tua richiesta. Questi possono includere codici di accesso o altri dettagli richiesti dal servizio che stai utilizzando. Premi su "Aggiungi" per aggiungere informazioni all'header della richiesta.

• Template query string: definisci il formato delle informazioni da inviare nell'indirizzo web. Usa {parametro} per indicare dove inserire i valori che cambiano. Es. luogo={citta}&periodo={data}. Città e data sono variabili (o "parametri").

• Template body HTTP: specifica le informazioni da inviare nel corpo della richiesta. Come sopra, usa {parametro} per indicare dove inserire i valori che cambiano.

Informazioni contestuali

Invia header di estensione: seleziona le informazioni aggiuntive della conversazione che vuoi includere nella richiesta:

• ID della sessione;

• Tag dell'utente;

• Data e ora attuali;

• Luogo;

• Contesto;

• Mail del utente.

Definizione dei parametri

Nella sezione "Parametri", puoi definire i valori dinamici (le variabili) che la tua funzione accetterà.

Per aggiungere un parametro, fai clic sul tasto "Aggiungi", e specifica:

• Nome: il nome del parametro che verrà utilizzato (quello che trovi tra le parentesi graffe, ad esempio "citta" se nei dettagli della richiesta hai scritto "luogo={citta}");

• Descrizione: una descrizione dettagliata di cosa rappresenta il parametro; più dettagli assicurano una maggiore precisione da parte dell'IA;

• Tipo: specifica se il parametro è una stringa, un numero, un integer o un valore booleano;

• Valori possibili: premendo il pulsante "aggiungi potrai inserire dei valori possibili;

• Obbligatorio: questo campo ti permette di dire all'AI se questo campo è obbligatorio oppure no: se stai chiedendo il meteo, è probabile che la città sia necessaria, mentre la scala (Celsius o Fahreneit) potrebbe essere facoltativa.

Questi parametri rappresentano i valori che l'IA può chiedere all'utente o dedurre dalla conversazione.

Attenzione: i nomi dei parametri devono essere privi di lettere accentate e caratteri speciali.

Test della funzione

Prima di implementare la tua funzione, ti consigliamo di testarla:

1. Nella pagina di configurazione della tua funzione premi su "Test"

2. Inserisci dei valori di esempio per i parametri definiti

3. Clicca su "Esegui test" per verificare che la funzione performi come previsto

Questo passaggio ti permetterà di identificare e correggere eventuali problemi prima di mettere la funzione in produzione.