Nello strumento di creazione integrazione , i parametri delle richieste ti consentono di estrarre i dati (parametri di conversazione) dalle conversazioni agenti AI e di trasmetterli agli endpoint esterni. In alcuni casi, potrebbe essere necessario trasformare o riformattare questi dati prima di inviarli in una richiesta API come query URL o nel corpo della richiesta. A tale scopo, puoi usare JSONata, un potente linguaggio di query e trasformazione.
Questo articolo include i seguenti argomenti:
- Riformattazione del valore di un parametro di richiesta
- Esempi di casi d’uso comuni per la riformattazione dei valori
Articoli correlati:
Riformattazione del valore di un parametro di richiesta
Puoi riformattare il valore di un parametro di richiesta usando JSONata.
Per riformattare il valore di un parametro di richiesta
- Nello spazio di lavoro Agenti AI , nell’angolo in alto a destra, usa il campo a discesa agenti AI per selezionare il tuo agenti AI.
- Nel menu principale a sinistra, fai clic su Integrazioni API .
- Seleziona o crea un’integrazione.
- Nella pagina Parametri richiesta , seleziona o crea il parametro di richiesta per il quale vuoi riformattare il valore.
- Nel campo Valore test , seleziona l’icona Riformatta valore (
).
- Nella finestra di dialogo Riformattazione valore , nel campo JSONata di riformattazione , usa JSONata per trasformare o riformattare il valore associato alla chiave del parametro di richiesta selezionata.
Nella query JSONata, usa "$" per rappresentare la chiave di cui stai formattando il valore.
Il campo Anteprima valore test consente di controllare i risultati della query in tempo reale.
- Fai clic su Fatto.
- (Facoltativo) Se stai aggiungendo il parametro request al corpo di una richiesta API:
- Sotto l’ intestazione Ambiente a sinistra, seleziona l’ambiente appropriato.
- Seleziona la scheda Corpo .
- Aggiungi il tuo oggetto JSON, usando il parametro request come valore tra parentesi graffe doppie.
Casi d’uso comuni per la riformattazione dei valori
In Creazione integrazioni, puoi definire i parametri della richiesta assegnandoli a chiavi specifiche. Sebbene questi valori possano funzionare così come sono, ci sono scenari in cui devono essere trasformati o riformattati per soddisfare i requisiti del sistema esterno.
Ad esempio, potresti voler:
- Riformatta date : Cambia il formato di una data da MM/GG/AAAA a AAAA-MM-GG o ISO 8601 in modo che corrisponda ai requisiti API.
- Esegui operazioni sulle stringhe : Manipola le stringhe, come l’aggiunta o la rimozione di caratteri, la combinazione di più campi o la trasformazione di stringhe in modo che contengano HTML.
- Applica logica condizionale : Applica condizioni, come la verifica se un campo è vuoto o l’assegnazione di un valore predefinito, se necessario.
Questa sezione contiene i seguenti esempi:
- Scenario: Riformattazione delle date
- Scenario: Riformattazione degli URL per rendere i link selezionabili
- Scenario: Riformattazione di una trascrizione di chat per renderla più leggibile
Scenario: Riformattazione delle date
In questo scenario, l’endpoint deve controllare una data formattata come AAAA-MM-GG o in un formato ISO 8601. Tuttavia, per la conversazione, le date devono essere visualizzate in un formato più intuitivo, GG/MM/AAAA.
Ecco la query JSONata che useresti in questo scenario:
$substring($, 6, 10) & "-" & $substring($, 3, 2) & "-" & $substring($, 0, 2)
Scenario: Riformattazione degli URL per rendere i link selezionabili
In questo scenario, vuoi convertire gli URL in link selezionabili cercando il testo (una sottostringa) che inizia con http:// o https:// seguito da un numero di caratteri diversi da spazi. Quindi, vuoi sostituire la sottostringa usando la funzione JSONata $replace, con una stringa che racchiude l’URL corrispondente in un codice HTML< a> per creare un link selezionabile.
Ecco la query JSONata che useresti in questo scenario:
(
$text := "Chat transcript unavailable. Here is a link:https://www.zendesk.com. Here is another link: https://www.w3schools.com.";
$replace($text, /(https?:\/\/[^\s]+)/, '<a href="$1">$1</a>'
)
Scenario: Riformattazione di una trascrizione di chat per renderla più leggibile
In questo scenario, vuoi aggiungere una trascrizione chat a un ticket. Tuttavia, nella sua forma predefinita, la trascrizione della chat non è molto leggibile:
- Trascrizione chat - 2024-10-12 (13:04:10) agenti AI: Benvenuto nell’agente agenti AI per la progettazione dei clienti. (13:04:10) agenti AI: Scegli l’integrazione da testare: (13:04:10) Visitatore: test c.id: d501304d-da09-4485-a4c7-1c708ec0005d Tutti gli orari in UTC
Vuoi trasformarlo in un formato più intuitivo suddividendo ogni messaggio in una nuova riga. Poiché ogni nuovo messaggio inizia con una parentesi aperta ( ( ), puoi usare JSONata per sostituire ogni occorrenza di ( con un'interruzione di riga seguita da (.
La conversazione riformattata avrà il seguente aspetto:
- Trascrizione chat - 2024-10-12
(13:04:10) agenti AI: Benvenuto nell’agente agenti AI di Integration Builder.
(13:04:10) agenti AI: Scegli l’integrazione da testare:
(13:04:10) Visitatore: test c.id: d501304d-da09-4485-a4c7-1c708ec0005d Tutti gli orari in UTC
Ecco la query JSONata che useresti in questo scenario:
$replace($, “(“, “\n(“)
Inoltre, devi aggiungere questo parametro alla sezione body del tuo ambiente in modo che venga inviato con la richiesta:
{
"chatTranscript": "{{chatTranscript}}"
}
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.