Lo strumento di creazione integrazione è un potente strumento senza codice che ti consente di connettere il tuo agenti AI a qualsiasi API o origine dati senza competenze tecniche o di programmazione estese. Questo articolo tratta le domande frequenti (FAQ) sullo strumento di creazione integrazione.
Questo articolo include i seguenti argomenti:
- Domande frequenti su parametri e dati
- Domande frequenti sugli ambienti
- Domande frequenti su schede e sequenze
- Domande frequenti sull’autenticazione
Articoli correlati:
Domande frequenti su parametri e dati
Come vengono raccolti i dati della sessione della conversazione?
La raccolta dei dati delle sessioni nelle conversazioni agenti AI inizia con l’acquisizione automatica dei metadati degli utenti all’inizio della sessione e continua attraverso l’interazione con l’ agenti AI, in cui è possibile acquisire input, risposte ed entità.
Quando viene avviata una sessione di chat, soprattutto se l’utente ha effettuato l’accesso, alcuni metadati vengono raccolti automaticamente. Questi metadati in genere includono dettagli specifici dell’utente che possono includere ID utente o informazioni sull’account, ID sessione, ubicazione, timestamp e altro ancora. Questi dati possono quindi essere salvati come azione di conversazione.
Durante la conversazione, puoi scegliere di acquisire determinate risposte (scritte come testo libero o inviate con pulsanti) dall’utente. Puoi farlo come segue:
- Un parametro che usa l’impostazione “Raccogli parametro” in un blocco condizionale
- Un’entità
Questi parametri possono quindi essere passati all'integrazione e possono essere usati come parametri di richiesta nell'endpoint URL o nel corpo della richiesta.
Che cos'è un parametro URL e come si usa?
Un parametro URL è un parametro dinamico nell’URL che cambia in base alle informazioni trasmesse all’integrazione nei parametri della richiesta provenienti dalla conversazione.
Ecco un esempio di ID utente usato come parametro:
https://{{zendesk_subdomain}}.zendesk.com/api/v2/users/{{user_id}}
Tra parentesi graffe doppie, il parametro user_id viene aggiunto all’URL.
Come posso accedere ai dati della conversazione da usare nell'API?
Per usare i dati della conversazione, i dati devono essere salvati nella sessione come parametro come descritto sopra, raccogliendo il parametro o salvando i metadati in un parametro nei dati della sessione. I dati devono essere salvati come parametro di richiesta nello strumento di creazione integrazione se provengono dalla conversazione o come dati/metadati di sessione da inviare all’API. Puoi anche inviare dinamicamente quel parametro nel corpo della richiesta.
Come posso accedere ai parametri o ai dati della risposta API da usare nella conversazione?
Per usare i parametri o i dati della risposta API, devono essere salvati come parametro di sessione nell'ambiente (nella maggior parte dei casi, lo scenario di esito positivo). Una volta salvato e quando l’API è entrata in un determinato scenario, puoi accedere e usare il parametro session per usarlo in un messaggio di un agenti AI o come parametro per un blocco condizionale:
- In un messaggio agenti AI , si accede come {{parameterName}}.
- In un blocco condizionale, vi si accede con il nome del parametro.
Come posso inviare i parametri della richiesta nel corpo?
Per inviare un parametro di richiesta nel corpo, devi includerlo tra parentesi graffe doppie come questa:
{{exampleParameter}}
Posso inviare un array nel corpo della richiesta?
Sì, puoi selezionare il tipo di dati come array quando definisci i parametri della richiesta. Durante il test, assicurati di riformattare il valore con la funzione JSONata $eval($). La funzione eval analizza e valuta una stringa contenente un’espressione JSON o un’espressione JSONata come se fosse JSON.
In questo caso, prendiamo una stringa inclusa in un array e usiamo $eval() per analizzarla come array. Il caso d’uso più comune è l’invio di un array di ordini.
Perché durante il test non ricevo parametri di richiesta o parametri errati?
A scopo di test, devi usare un valore di test che corrisponda ai dati reali nell’endpoint per il parametro di richiesta nello strumento di creazione integrazione. Tuttavia, in una conversazione attiva, il valore di questo parametro deriva dalla conversazione. Se non riesci a vedere il parametro e il valore nei dati della sessione durante il test, assicurati di acquisirlo e salvarlo come parametro corretto nella finestra di dialogo.
Tieni presente che i dati delle sessioni disinfettate non verranno mostrati nei registri delle conversazioni. In questo caso, potrebbe essere necessario registrarli temporaneamente in un messaggio agenti AI per eseguire il debug.
Perché vedo [Oggetto, oggetto]?
[Oggetto, oggetto] significa che stai tentando di generare un oggetto, ma il sistema non dispone di un modo strutturato per visualizzarlo. Per risolvere il problema, devi convertire l’oggetto in un formato stringa.
Registra le chiamate riuscite?
No, per motivi PII e RGPD , non registriamo le chiamate dati riuscite. Registriamo le chiamate non riuscite in modo da poter fornire maggiori informazioni su cosa è andato storto durante la risoluzione dei problemi, se necessario.
Domande frequenti sugli ambienti
Perché potrei aver bisogno di ambienti diversi?
Durante il test dell’integrazione, potresti non voler usare dati reali o in tempo reale. Se hai accesso a un ambiente sandbox, di staging o di sviluppo (ti suggeriamo di consultare il team tecnico o la documentazione API), puoi configurarlo nello strumento di creazione integrazione.
Gli ambienti condividono i parametri e gli output delle richieste. Tuttavia, differiscono per gli endpoint e i dettagli di autenticazione. Nello strumento di creazione dialoghi, puoi passare facilmente da un ambiente all’altro nel nodo API. Ciò significa che devi creare una sola finestra di dialogo durante il test, quindi puoi passare a un ambiente di produzione quando sei pronto per l’integrazione.
Domande frequenti su schede e sequenze
Devo impostare un numero massimo di carte?
Per l’integrazione Sunshine Conversations , sono disponibili un massimo di 10 schede.
Ti suggeriamo di limitare il numero di carte in una sequenza a 9 carte o a 8 carte con una carta di riserva. Una scheda di riserva offre all’utente una via d’uscita dalla sequenza (ad esempio, se non vede il proprio elemento).
Devo visualizzare le immagini sulle schede in una sequenza?
Sì, l’immagine è un campo dati obbligatorio. Puoi compilare il campo immagine con un link generico a un’immagine se non hai bisogno di immagini dinamiche (ad esempio, un’immagine per prodotto).
Domande frequenti sull’autenticazione
Quali metodi di autenticazione posso usare?
Puoi usare i seguenti metodi di autenticazione:
- Chiave API
- Token portatore
- Token di scadenza
- Autent. base
- OAuth 2.0
- Elenchi IP consentiti
Per iniziare con l’autenticazione per lo strumento di creazione integrazioni, consulta Requisiti tecnici di integrazione.
Posso creare un’integrazione con un endpoint consentito?
Sì. A tal fine, devi aggiungere i nostri indirizzi IP all’elenco consentito. Per un elenco di indirizzi IP, consulta Consentire agli IP di connettere agenti AI avanzata al CRM.
Che cos’è un’integrazione di sola autenticazione e quando è necessaria?
Per ulteriori informazioni sulle integrazioni di sola autenticazione, consulta Uso dell’autorizzazione personalizzata con lo strumento di creazione integrazioni.
Posso implementare la limitazione della frequenza e la limitazione?
Non imponiamo direttamente la limitazione della velocità e la limitazione della frequenza. La limitazione della frequenza viene in genere applicata dai sistemi o dalle API con cui integriamo, come il sistema di back-end. Questi limiti dipendono dalla configurazione del backend.
Cosa succede se la mia API impiega più di 9 secondi per rispondere?
Il componente aggiuntivo agenti AI - Avanzati applica un timeout di 9 secondi per le risposte API. Se l’API non fornisce una risposta entro questo tempo, la richiesta scadrà e restituirà l’errore ECONNABORTED. Inoltre, tempi di risposta più lunghi possono influire negativamente sull’esperienza utente, in quanto gli utenti potrebbero trovare frustrante attendere informazioni.
Per risolvere il problema, se prevedi che alcune risposte API richiederanno più di 9 secondi, ti consigliamo di effettuare le chiamate API necessarie all’inizio della conversazione, se possibile (ad esempio, all’inizio dell’eventoChat) e di memorizzare le informazioni pertinenti nel sessione. Ciò garantisce che i dati siano pronti quando necessario, evitando ritardi durante il flusso della conversazione.
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.