Una falsa integrazione consente di aggiungere funzionalità personalizzate ai dialoghi usando i dati già presenti nella conversazione, senza effettuare chiamate API o recuperare dati esterni. Ciò ti consente di implementare la logica usando JSONata per la manipolazione dei dati, i confronti o altre attività all’interno del flusso di dialogo.
Questo tipo di integrazione è utile per gestire attività che non richiedono dati esterni in tempo reale, fungendo da integrazione “helper” per estendere le funzionalità di un agente AI oltre le funzionalità standard.
Questo articolo include i seguenti argomenti:
- Informazioni sulle integrazioni false
- Creazione di un’integrazione falsa
- Aggiunta di un’integrazione falsa all’interno di un dialogo
Informazioni sulle integrazioni false
Un’integrazione falsa è utile quando vuoi elaborare o manipolare dati già disponibili all’interno della conversazione. Ad esempio, puoi eseguire le seguenti attività usando un’integrazione falsa:
- Trasforma i dati in un formato più appropriato.
- Formatta e filtra i dati CRM o API complessi.
- Confronta le date per trovare quella più recente.
- Recupera il giorno e l’ora correnti.
- Controlla se una data rientra in un determinato periodo di tempo.
- Controlla se un URL contiene parole specifiche.
- Cerca e sostituisci eventuali valori Null.
- Sostituisci lettere o simboli nei dati.
- Usa un filtro senza distinzione tra maiuscole e minuscole per esaminare i dati e restituire il primo valore corrispondente oppure fornisci una risposta di fallback se non ci sono corrispondenze
Se puoi definire la logica usando JSONata , puoi migliorare le conversazioni con queste utili integrazioni.
Creazione di un’integrazione falsa
Per creare un’integrazione falsa, devi creare un’integrazione API come al solito. Tuttavia, non viene mai effettuata alcuna richiesta di dati.
Per creare un’integrazione falsa
- Nello spazio di lavoro Agenti AI , fai clic su Azioni nella barra laterale, quindi seleziona Integrazioni API .
- In alto a destra, fai clic su Aggiungi integrazione .
- Nella finestra Aggiungi integrazione :
- Nel campo Nome integrazione , assegna un nome descrittivo all’integrazione.
- (Facoltativo) Nel campo Descrizione , inserisci una descrizione dell’integrazione che ti aiuti a ricordare a cosa serve.
- Fai clic su Salva.
- Nella barra laterale sinistra, in Ambienti, seleziona un ambiente (come Produzione).
- Imposta Tipo di metodo su GET .
- Nel campo URL , inserisci un URL fittizio (ad esempio, https://dummyjson.com/http/200) .
Poiché le integrazioni false sono ospitate nel framework di integrazione, devono puntare a un URL valido. L’esempio qui sopra usa https://dummyjson.com/http/200, ma la sua disponibilità non può essere garantita. Puoi usare qualsiasi URL fittizio per te. Sebbene venga effettuata una chiamata API all’URL specificato, nessun dato della risposta verrà elaborato nell’integrazione falsa. - Assicurati che Tipo di autorizzazione sia impostato su Nessuna autorizzazione .
- (Facoltativo) Nella barra laterale sinistra, in Scenari , posiziona il cursore del mouse su Errore , seleziona il menu delle opzioni (
), quindi seleziona Elimina . Non è necessario uno scenario di errore per un’integrazione falsa. - Nella barra laterale sinistra, in Scenari , seleziona Operazione riuscita .
- A seconda dello scenario, esegui una delle seguenti operazioni:
- Se disponi di una query semplice, inseriscila nel campo Query scenario . Ad esempio, se hai bisogno solo di una risposta booleana, basta avere la query qui.
- Se devi definire la logica in base ai parametri della richiesta (provenienti dalla conversazione):
- Inserisci requestParameters nel campo Scenario Query .
- In Parametri di sessione , inserisci i parametri per l’integrazione falsa.
Ad esempio, puoi usare quanto segue per restituire il giorno della settimana:- Legenda : dayOfWeek
-
Query : $fromMillis($millis(), '[FNn]')
Per ulteriori funzioni di data e ora, consulta Funzioni di data/ora nella documentazione di JSONata.
- Fai clic su Salva.
Aggiunta di un’integrazione falsa all’interno di un dialogo
Nello strumento di creazione dialoghi , puoi aggiungere un blocco di integrazione o flusso di azioni e selezionare l’integrazione falsa.
Per aggiungere un’integrazione falsa all’interno di un dialogo
- Nell’angolo in alto a destra, usa il campo a discesa agenti AI per selezionare l’ agenti AI per il quale vuoi aggiornare il dialogo.
- Nel menu principale a sinistra, seleziona Contenuto> Scopi .
- Seleziona lo scopo per cui vuoi aggiornare il dialogo.
- Seleziona la scheda Risposte .
- Seleziona la risposta per la quale vuoi aggiornare il dialogo, quindi fai clic su Modifica dialogo .
- Fai clic sull’icona più (+) nel punto appropriato della finestra di dialogo e aggiungi un’integrazione o un blocco del flusso di azioni .
- Seleziona l’integrazione falsa creata sopra.
Ora, quando il branch di integrazione falso viene colpito nella conversazione, viene chiamata la tua integrazione API falsa e i parametri di sessione definiti nello scenario di successo saranno disponibili per il dialogo. L’esempio seguente mostra un’integrazione falsa che alimenta un blocco condizionale usando parametri basati sui giorni della settimana restituiti dall’integrazione falsa.
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.