Estensione di assistenti e competenze digitali

Puoi estendere qualsiasi assistente digitale o abilità che hai estratto dallo Skill Store per personalizzarlo per casi specifici della tua attività. Quando viene visualizzata una nuova versione nell'area di memorizzazione delle competenze, è possibile trasferire le personalizzazioni alla nuova versione ripristinando.

Nota

L'estensione degli assistenti digitali non è supportata per le versioni precedenti alla 20.6.

Che cos'è l'estensione e a cosa serve?

Quando si installano bot (assistenti e competenze digitali) dallo Skill Store, è possibile che non soddisfino tutti i requisiti o che si desideri modificarli per allinearli ai processi aziendali. Non è possibile modificare direttamente un bot installato, ma è possibile crearne un'estensione e quindi modificarla.

Quando crei un'estensione, stai creando un nuovo bot che ha una stretta relazione con il bot originale (di base). Grazie a questa relazione, è possibile in seguito usufruire degli aggiornamenti del bot di base senza dover riapplicazione manuale delle personalizzazioni. A tale scopo, utilizzare la funzione Ribasa. Quando diventa disponibile una nuova versione del bot di base nell'area di memorizzazione delle competenze, è possibile installarla nella propria istanza e quindi ribasare il bot esteso in base alla versione di base aggiornata.

Nota

Quando si estende un bot, è possibile aggiungere o modificare le proprietà esistenti del bot. Non è tuttavia possibile eliminare le proprietà definite nel bot di base.

Clonazione vs. estensione

Sebbene la duplicazione e l'estensione siano simili a livello superficiale, hanno differenze e scopi chiave:

Quando si crea una clone di un bot:
- Si crea una copia del bot completamente indipendente.
- È possibile apportare un numero illimitato di modifiche al clone
- Poiché la copia perde tutte le associazioni con il bot originale (gli ID di registrazione per il bot clonato non corrispondono a quelli dell'originale), non è possibile basare di nuovo in seguito su una versione aggiornata del bot originale.
Utilizzare la duplicazione quando si desidera utilizzare un bot esistente come punto di partenza per lo sviluppo.
Quando si estende un bot (una competenza o un assistente digitale):
- È possibile apportare una vasta gamma di aggiunte e modifiche al bot esteso, ma non è possibile eliminare quanto definito nel bot di base.
- È possibile in seguito ribase, ovvero applicare nel bot esteso gli aggiornamenti dal bot di base.
  Per i bot estesi è possibile eseguire il rebasing perché gli ID di tracciamento interni generati per i bot estesi corrispondono a quelli dei bot di base.
Utilizzare l'estensione se si desidera personalizzare un bot e poter poi incorporare nella versione personalizzata eventuali miglioramenti o nuove funzioni dal bot di base. È possibile estendere solo le competenze e gli assistenti digitali rimossi dall'archivio competenze.

Nota

Un terzo approccio consiste nell'estendere un bot, apportare personalizzazioni e quindi creare una copia del bot esteso. In questo caso, la copia del bot esteso viene considerata anche come un'estensione del bot originale (gli ID di tracciamento interni generati per la copia dell'estensione corrispondono a quelli del bot originale).

Cosa succede quando si estende una competenza o un assistente digitale

Quando si estende un bot (una competenza o un assistente digitale), ognuna delle parti del bot (ad esempio intenti, entità e proprietà) presenta uno degli stati riportati di seguito.

Ereditati (): artifact definiti nel bot di base. Dopo aver creato un'estensione, tutti gli artifact nel bot hanno questo stato.
Locale: artifact creati nell'estensione, ad esempio nuovi intenti.
Personalizzato (): artifact ereditati dal bot di base i cui valori sono stati modificati nell'estensione.

Quando si estende uno skill, i filtri per questi stati vengono visualizzati nella scheda Intenti sopra l'elenco degli intenti e sopra l'elenco degli esempi.

Quando si estende un assistente digitale, i filtri per questi stati vengono visualizzati sopra l'elenco degli skill (nella scheda Skill) e sopra l'elenco degli esempi (nella scheda Intenti).

Nota

Non è possibile eliminare gli artifact (ad esempio gli skill negli assistenti digitali e gli intenti e le entità negli skill), ma è possibile disabilitarli.

Nota importante per gli sviluppatori di Base Bots

Se si è sviluppatori di una competenza o di un assistente digitale che è stato caricato nell'area di memorizzazione delle competenze ed è necessario aggiornare tale bot nell'area di memorizzazione delle competenze, è necessario creare la versione aggiornata tramite l'opzione Nuova versione in modo che gli utenti possano basare le proprie versioni estese sulla versione di base aggiornata. Se si duplica il bot esistente o si crea semplicemente un nuovo bot con lo stesso nome, gli ID di tracciamento interni generati per il nuovo bot saranno diversi da quelli del bot esistente, pertanto non vi sarà alcuna correlazione tra i bot.

Capacità

Ecco cosa devi sapere sull'estensione delle competenze che hai estratto dallo Skill Store.

Estendi una competenza

Fare clic su per aprire il menu laterale e selezionare Sviluppo > Competenze.
Nella casella relativa allo skill che si desidera estendere, fare clic sull'icona Opzioni () e selezionare Estendi.

Questa abilità deve essere una competenza estratta dallo Skill Store.

Cosa puoi aggiungere e personalizzare in una competenza estesa

Intenti. È possibile aggiungere espressioni, modificare espressioni esistenti e aggiungere nuovi intenti. Non è possibile eliminare espressioni o intenti, ma è possibile disabilitare gli intenti.
Entità. È possibile aggiungere valori di entità, aggiungere sinomie ai valori di entità e aggiungere nuove entità. È inoltre possibile modificare i campi riportati di seguito.
- Dimensioni dell'intervallo di enumerazione
- Messaggio di errore
- Valori multipli
- Corrispondenza non esatta
Non è tuttavia possibile eliminare entità, eliminare o modificare valori entità.
Flusso di finestre di dialogo. È possibile apportare modifiche durante tutto il flusso della finestra di dialogo. Non ci sono limitazioni specifiche. Tuttavia, nessun delta viene tracciato dal sistema. Quando si ricollega l'estensione skill, viene visualizzato uno strumento di confronto per confrontare il flusso della finestra di dialogo fianco a fianco con quello della nuova abilità di base. Spetta quindi a voi determinare cosa tenere lontano dalla vostra abilità e cosa portare avanti dalla nuova abilità di base.
Bundle delle risorse. È possibile effettuare le seguenti operazioni.
- Aggiungere nuove chiavi messaggio in una qualsiasi delle lingue supportate.
- Modificare uno qualsiasi dei messaggi esistenti.
Servizio componente personalizzato. È possibile effettuare le seguenti operazioni.
- Sostituire il file del pacchetto.
- Aggiungere componenti al servizio.
Non è possibile:
- Rimuovere i componenti.
È possibile modificare l'implementazione dei componenti personalizzati nella competenza estesa. Tuttavia, se il componente personalizzato viene aggiornato in un secondo momento nello skill di base, tali aggiornamenti non verranno uniti alle modifiche apportate al componente nello skill esteso quando si ricollega lo skill. In questo caso, è necessario unire manualmente le modifiche del componente personalizzato dalla competenza di base aggiornata alla competenza estesa.
Impostazioni. È possibile regolare la maggior parte delle impostazioni per lo skill, tra cui:
- Proprietà generali, come la descrizione delle abilità.
- Modello di formazione.
- Indica se gli approfondimenti e la registrazione delle conversazioni sono abilitati.
- Valori dei parametri di sistema, ad esempio soglia di affidabilità e prompt standard.
- Parametri personalizzati. È possibile creare nuovi parametri personalizzati e modificare i valori di quelli esistenti.
- Valori delle proprietà dell'assistente digitale, ad esempio Richiamo, Valori di esempio, Stato di inizio, Stato di benvenuto e Stato della Guida.

Modifiche che non vengono conservate durante la riassegnazione

Domande e risposte. È possibile modificare il contenuto di un modulo di domande e risposte in uno skill esteso, ma tali modifiche vengono eliminate se in seguito si ricollega lo skill.
Se è stato modificato un modulo Q&A nella competenza estesa, assicurarsi di esportare il file di origine Q&A prima di eseguire la sincronizzazione.

Nota

Questa limitazione non si applica agli intenti di risposta.

Disabilita intenti

Quando si estende uno skill, non è possibile rimuovere gli intenti, ma è possibile disabilitarli.

Quando si disabilita un intento, lo si esclude dal modello di addestramento. Qualsiasi input utente che altrimenti corrisponderebbe bene ai dati di addestramento di un intento disabilitato verrà invece risolto in un intento diverso (probabilmente unresolvedIntent).

Se in seguito si ricollega lo skill, gli intenti disabilitati rimarranno disabilitati. Se si riabilita un intento dopo il ribasso, verranno rilevate le modifiche apportate all'intento nello skill di base.

Per disabilitare un intento:

Nella barra di navigazione a sinistra dello skill esteso, fare clic su .
Selezionare l'intento da disabilitare.
Portare lo switch Enabled dell'intento alla posizione OFF.
Fare clic sul pulsante Train nell'angolo in alto a destra della pagina, quindi fare clic su Sottometti.

Nota

Se si desidera escludere la funzionalità di un intento da uno skill ma si desidera informare l'utente che la funzionalità dell'intento non è disponibile, mantenere l'intento abilitato, ma immettere una risposta statica nel campo Risposta dell'intento. Quando si esegue questa operazione, questo testo viene visualizzato quando l'input dell'utente viene risolto nell'intento. Per ulteriori informazioni sul funzionamento, vedere Rispondi intenti.

Assistenti digitali

Ecco cosa devi sapere sull'estensione degli assistenti digitali che hai estratto dallo Skill Store.

Estensione di un assistente digitale

Fare clic su per aprire il menu laterale e selezionare Sviluppo > Assistenti digitali.
Nella casella relativa all'assistente digitale che si desidera estendere, fare clic sull'icona Opzioni () e selezionare Estendi.

Questo assistente digitale deve essere uno che hai estratto dallo Skill Store.

Cosa è possibile aggiungere e personalizzare in un assistente digitale esteso

Capacità. È possibile aggiungere altre competenze. Non è possibile eliminare gli skill ereditati dall'assistente digitale di base, ma è possibile disabilitarli.
Intenti di sistema. Per gli intenti exit, help e unresolvedIntents è possibile aggiungere espressioni e modificare le espressioni esistenti.
Impostazioni. È possibile regolare la maggior parte delle impostazioni per l'assistente digitale, tra cui:
- Proprietà generali, come la descrizione dell'assistente digitale.
- Modello di formazione.
- Indica se gli insight sono abilitati.
- Parametri di instradamento, ad esempio le varie soglie di affidabilità e i prompt standard.
- Parametri personalizzati. È possibile creare nuovi parametri personalizzati e modificare i valori di quelli esistenti.

Disabilita skill

Quando si estende un assistente digitale, non è possibile rimuovere gli skill, ma è possibile disabilitarli.

Quando si disabilita uno skill, lo si esclude dal modello di addestramento. Qualsiasi input dell'utente che altrimenti corrisponderebbe bene ai dati di formazione della skill verrà invece risolto altrove (probabilmente unresolvedIntent dell'assistente digitale).

Se in seguito si ricollega l'assistente digitale, tutte le competenze disabilitate rimarranno disabilitate. Se si riabilita un'abilità dopo il ribasso, verranno rilevate le modifiche apportate a tale abilità nell'assistente digitale di base.

Per disabilitare uno skill:

Nella navigazione a sinistra dell'assistente digitale, fare clic su .
Selezionare lo skill da disabilitare.
Portare lo switch Abilitato dello skill alla posizione OFF.

Aggiornare una competenza in un assistente digitale esteso

Se si dispone di un assistente digitale esteso che contiene una competenza con una versione più recente installata nell'istanza, è possibile aggiornare l'assistente digitale in modo da utilizzare la versione più recente.

Fare clic su per aprire il menu laterale e selezionare Sviluppo > Assistenti digitali.
Fare clic sulla casella relativa all'assistente digitale per aprirla.
Nella scheda Skill dell'assistente digitale, selezionare lo skill che si desidera sostituire con una versione più recente.

Lo skill deve avere il badge .
Fare clic su Aggiorna skill.
Nell'elenco a discesa Nuova versione skill selezionare la versione dello skill che si desidera includere e fare clic su Aggiorna skill.
Impostare lo switch Sovrascrivi modello di interazione.

Se si desidera che le modifiche apportate alle proprietà Richiama e Utteranze di esempio definite nella scheda Assistente digitale della pagina Impostazioni dello skill vengano propagate all'assistente digitale, lasciare lo switch nella posizione ON.

Questi valori vengono utilizzati nella scheda della Guida per la competenza nell'assistente digitale.
Fare clic su Aggiorna skill.

Estendi una competenza in un assistente digitale esteso

Se hai esteso un assistente digitale che desidera sostituire una delle sue competenze di base con una versione estesa di tale abilità, devi seguire questi passaggi generali:

Estendere la competenza e apportare le personalizzazioni desiderate.
Aggiornare la competenza.
(Un'abilità deve essere addestrata prima di poter essere pubblicata.)
Nell'assistente digitale, aggiornare la versione dello skill utilizzato effettuando le operazioni riportate di seguito.
1. Fare clic su per aprire il menu laterale e selezionare Sviluppo > Assistenti digitali.
2. Fare clic sulla casella relativa all'assistente digitale per aprirla.
3. Nella scheda Skill dell'assistente digitale, selezionare lo skill esteso. Questa abilità dovrebbe avere il badge .
4. Fare clic su Aggiorna skill.
5. Nell'elenco a discesa Nuova versione skill, selezionare la versione estesa dello skill e fare clic su Aggiorna skill.
Dopo aver testato l'assistente digitale con la nuova versione della competenza e averne soddisfatto il funzionamento, pubblicare la competenza.

Crea, rivedi e ripristina personalizzazioni

È possibile aggiungere o personalizzare un bot esteso (skill o assistente digitale) utilizzando uno qualsiasi dei relativi controlli abilitati e campi modificabili.

È possibile rivedere le personalizzazioni apportate a un bot facendo clic sull'icona visualizzata accanto al campo personalizzato. Per le espressioni di esempio di un intento, è necessario posizionare il puntatore del mouse sull'icona accanto all'espressione per visualizzare l'icona .

Quando si fa clic su questa icona, viene visualizzata la finestra di dialogo Rivedi personalizzazione, che consente di confrontare il valore corrente del campo con il valore di base. Se si desidera ripristinare il valore nel bot di base, fare clic su Ripristina originale.

Controllo delle personalizzazioni

È possibile utilizzare la funzione Casi di test per assicurarsi che le modifiche apportate nelle estensioni non abbiano interrotto alcuna delle funzioni di base del bot.

È possibile creare i test registrando le conversazioni nel tester. Inoltre, alcune competenze e assistenti digitali nello Skill Store sono dotati di casi di test, che puoi eseguire sulle tue estensioni per assicurarti di non aver rotto nessuna delle funzionalità.

Per informazioni dettagliate sulla creazione e l'utilizzo dei casi di test, vedere Test di suite e casi di test.

Ribasso

Se è disponibile una nuova versione base di un bot estesa, è possibile rebase il bot esteso in modo che riprenda le modifiche apportate al bot di base e mantenga le personalizzazioni apportate nel bot esteso. Il rebasing è disponibile sia per le competenze che per gli assistenti digitali.

Puoi anche eseguire il rebase a qualsiasi versione del bot che discende dal bot originale, sia che si tratti di una versione del bot originale o di una versione estesa del bot. Non si applica alle copie o ai bot creati separatamente ma con lo stesso nome.

Funzionamento del riavvio

Quando si esegue il rebase, nel bot esteso si verificano le seguenti operazioni:

Viene creata una nuova versione dell'estensione.
Tutti i nuovi artifact, ad esempio i nuovi intenti, nella nuova versione del bot di base (ovvero quelli aggiunti dopo la creazione o l'ultima nuova creazione dell'estensione) vengono aggiunti all'estensione.
Tutti gli artifact locali (quelli creati nell'estensione) vengono conservati nell'estensione.
Vengono conservate tutte le personalizzazioni degli artifact, ad esempio le modifiche dei valori delle proprietà.
Nota

I valori delle proprietà personalizzati hanno sempre la precedenza sulle modifiche nel bot di base. Se si desidera utilizzare i valori della nuova base, è possibile annullare le modifiche una volta completato il processo di sincronizzazione.
Tutti gli artifact ereditati inclusi nella versione corrente del bot di base che non sono stati personalizzati e e che sono stati rimossi dalla nuova versione del bot di base vengono eliminati.
Gli artifact personalizzati che non esistono più nel nuovo bot di base vengono inclusi nell'estensione basata di nuovo. Nell'estensione vengono trattati come artifact locali, pertanto è possibile eliminarli se non sono più necessari.

Attenzione

Se sia la nuova versione del bot di base che l'estensione hanno un nuovo artifact con la stessa chiave (di solito il nome), il rebasing non sarà in grado di risolvere i due e quindi non riuscirà. In questo caso, è necessario eliminare la versione locale dell'artifact prima di poter eseguire correttamente il rebase.

Basa di nuovo un'estensione skill

Se non è già stato fatto, installare lo skill aggiornato:
1. Fare clic su per aprire il menu laterale e selezionare Sviluppo > Negozio.
2. Nella casella relativa allo skill di base aggiornato, fare clic su e selezionare Esegui.
Fare clic su per aprire il menu laterale, selezionare Sviluppo > Competenze e fare clic sulla casella relativa alla versione estesa dello skill per aprirla.
Nella navigazione a sinistra dello skill, fare clic su .
Fare clic sul pulsante Rebase.
Nell'elenco a discesa Competenza di base selezionare la versione dello skill a cui si desidera eseguire il ribasso e fare clic su Avanti.
Completare la procedura guidata.

Se l'unione di sincronizzazione riesce, la nuova versione basata dello skill viene creata e aperta in modalità Bozza.

Se l'unione di sincronizzazione non riesce, viene visualizzato un messaggio di errore che indica gli elementi che hanno bloccato l'unione di sincronizzazione riuscita e non viene creata una nuova versione della competenza estesa.

Basa nuovamente l'estensione Digital Assistant

Se non è già stato fatto, installare l'assistente digitale aggiornato:
1. Fare clic su per aprire il menu laterale e selezionare Sviluppo > Negozio.
2. Nella casella relativa all'assistente digitale di base aggiornato, fare clic su e selezionare Esegui pull.
Fare clic su per aprire il menu laterale, selezionare Sviluppo > Assistenti digitali e fare clic sulla casella relativa alla versione estesa dell'assistente digitale per aprirla.
Nella navigazione a sinistra dell'assistente digitale, fare clic su .
Fare clic sul pulsante Rebase.
Nell'elenco a discesa Assistente digitale di base selezionare la versione dello skill a cui si desidera eseguire il ribasso e fare clic su Avanti.
Completare la procedura guidata.

Se l'unione di sincronizzazione riesce, la nuova versione basata dell'assistente digitale viene creata e aperta in modalità Bozza.

Se l'unione di sincronizzazione non riesce, viene visualizzato un messaggio di errore che indica gli elementi che hanno bloccato l'unione di sincronizzazione riuscita e viene non creata una nuova versione dell'assistente digitale esteso.

Come rispondere a una sincronizzazione non riuscita

Se un'unione di competenze o un assistente digitale non riesce, ecco i passi per tentare di nuovo l'unione di sincronizzazione:

Creare una nuova versione dell'estensione bot.
Apportare modifiche all'estensione per correggere gli errori nel tentativo di sincronizzazione. Ciò potrebbe semplicemente significare il ripristino di eventuali personalizzazioni in conflitto con le modifiche nel bot di base.
Tentativo di sincronizzare di nuovo la versione dell'estensione.

Diramazione di un'estensione

È anche possibile creare un clone di un'estensione in modo da poter lavorare su rami diversi in parallelo. Ad esempio, è possibile eseguire questa operazione quando si dispone di un bot esteso in produzione, ma si desidera disporre di un'estensione denominata in modo diverso in cui si stanno lavorando a modifiche significative.

Quando si clona un'estensione, il bot esteso viene considerato anche come un'estensione del bot originale, ovvero:

In fase di progettazione, i vari artefatti sono contrassegnati come ereditati, locali e personalizzati, proprio come in altri bot estesi.
È possibile eseguire il rebase alle nuove versioni del bot originale.
Gli ID di tracciamento interni generati per la copia dell'estensione corrispondono a quelli del bot originale.

Nota

La clonazione funziona con l'estensione bot solo se prima si crea un bot esteso.

Ciclo di vita post-implementazione di una competenza estesa

Dopo aver distribuito una versione estesa di uno skill, è importante stabilire una routine per incorporare i miglioramenti e quindi ridistribuirli.

Ecco un esempio di come potrebbe essere una tale routine, in base alle seguenti ipotesi:

Si stanno utilizzando Insights su base continuativa per migliorare la risoluzione degli intenti nello skill.
È possibile aggiungere periodicamente nuove funzioni allo skill.
Sono disponibili due istanze di Digital Assistant (una per la produzione e una per il test e l'area intermedia).

Nell'istanza di produzione, creare una nuova versione dello skill distribuito.
È possibile creare una nuova versione dello skill nell'istanza di produzione in modo da poter acquisire i dati Insights dall'uso effettivo dei clienti e quindi utilizzare Retrainer per integrare il modello di addestramento con espressioni che lo skill non aveva compreso correttamente in precedenza.

Per facilitare la lettura di questa procedura, si supponga che la competenza pubblicata sia la versione v1 e che la nuova versione bozza sia la versione v1.1.
Valutare i report Insights sulla competenza e integrare i dati di formazione per gli intenti con espressioni aggiuntive per gestire frasi utente valide non prese in considerazione nei dati di formazione precedenti.
Nell'ambito di questo processo, è possibile utilizzare Insights Retrainer per aggiungere espressioni non risolte agli intenti appropriati.
Esportare lo skill (v1.1 nell'esempio precedente).
Nell'istanza di test o area intermedia, importare lo skill appena esportato dall'istanza di produzione (v1.1).
Nell'istanza di test o area intermedia, creare una nuova versione dello skill importato. Questa nuova versione verrà utilizzata per incorporare tutte le nuove funzionalità che si stanno aggiungendo alla competenza. (Facciamo riferimento a questa versione come v2.)
In v2 incorporare le aggiunte di funzioni o le modifiche che si desidera includere.
Se le modifiche sono state sviluppate altrove, unirle manualmente in v2.
Allenare e testare v2 fino a quando non si è soddisfatti dei risultati.
Esportare lo skill (v2) dall'istanza di test.
Nell'istanza di produzione, importare la competenza appena formata e testata (v2).
Allenare l'abilità.
Pubblicare lo skill.
Se si sta distribuendo lo skill come parte di un assistente digitale, creare una nuova versione dell'assistente digitale.
Aggiornare la nuova versione dell'assistente digitale per utilizzare la nuova versione dello skill (v2).
Aggiornare il canale per utilizzare la nuova versione dell'assistente digitale.
Pubblicare la nuova versione dell'assistente digitale.

Documentazione dell'infrastruttura Oracle Cloud