Se si desidera ospitare il pacchetto di componenti personalizzati da Oracle Digital Assistant come servizio di componenti incorporati, è innanzitutto necessario imballare i componenti personalizzati in un file TGZ. Quindi, quando si crea il servizio componente incorporato, si carica questo file.

Questo file TGZ, incluso nel package mediante bots-node-sdk pack, deve contenere gli asset e la struttura descritti nella sezione Implementa componenti personalizzati. Deve inoltre contenere tutti i moduli nodo da cui dipende (l'bots-node-sdk pack lo fa per te).

Per preparare un package per il caricamento nel servizio container incorporato, effettuare le operazioni riportate di seguito.

1. Assicurarsi di disporre della versione più recente degli strumenti della riga di comando Node.js dei bot.

   Il contenitore incorporato richiede che il file TGZ includa tutti i file dependencies. Le versioni precedenti non hanno raggruppato dependencies nel file. Ora, il comando che si utilizzerà per creare il file TGZ assicura che il file package.json contenga un nodo bundledDependencies che elenca tutti i moduli dipendenti che devono essere inclusi nel file TGZ.

2. Nella directory che contiene il file main.js, eseguire il comando seguente per ciascuno dei moduli da cui dipende il pacchetto. Non è necessario eseguire questa operazione per devDependencies, ad esempio l'SDK del nodo bot.

   Questo comando aggiunge il modulo alla cartella node_modules e lo aggiunge come dipendenza in package.json.

   npm install <module>

   Se package.json assegna già un nome a tutte le dipendenze, è possibile eseguire npm install.

3. Assicurarsi che la cartella di livello superiore contenga un file .npmignore con una voce *.tgz. Ad esempio:

   *.tgz
   spec
   service-*

   In caso contrario, quando si impacchettano i file in un file TGZ, si include il file TGZ già esistente nella cartella di livello superiore e le dimensioni del file TGZ raddoppieranno. Dopo aver imballato i file un paio di volte, il file TGZ sarà di grandi dimensioni da caricare nel contenitore.

4. Eseguire questo comando:

   bots-node-sdk pack

   Questo comando convalida il package di componenti, lo aggiorna in modo da includere devDependencies, se necessario, e quindi crea un file TGZ, che verrà caricato quando si crea un servizio di componenti incorporato dalla scheda Componenti della competenza. Tenere presente che i file elencati come dependencies sono inclusi come bundledDependencies, ad eccezione dell'SDK del nodo bot e di Express, che sono devDependencies.

Il pacchetto deve essere compatibile con il nodo 14.17.0.

Per maggiori informazioni sul comando pack, vedere https://github.com/oracle/bots-node-sdk/blob/master/bin/CLI.md.

Dopo aver compresso un package di componenti personalizzati in un file TGZ, è possibile caricarlo per creare un servizio di componenti incorporato dalla scheda Componenti dello skill.

Per informazioni su come creare il file TGZ, vedere Preparare il package per un servizio Container incorporato.

Per creare il servizio componente incorporato, effettuare le operazioni riportate di seguito.

1. Dalla competenza, fare clic su Componenti .

2. Fare clic su .

3. Selezionare Embedded Container.

4. Fare clic su Carica un file pacchetto componente e puntare al file TGZ da caricare oppure trascinare il file nella casella File pacchetto.

5. (Facoltativo) Se si desidera inviare le istruzioni context.logger() del componente personalizzato al log del servizio, passare a Abilita log componente. Questo switch è disponibile solo nelle istanze di Oracle Digital Assistant di cui è stato eseguito il provisioning su Oracle Cloud Infrastructure (a volte indicata come infrastruttura cloud di generazione 2).

   È possibile visualizzare il log dalla scheda Componenti facendo clic su Diagnostica > Visualizza log.

   Nota
   
   La competenza conserva una voce di log per due giorni. Quando si elimina un servizio componente personalizzato incorporato, le voci di log dello skill per tale servizio vengono eliminate.

6. Fare clic su Crea.

   Digital Assistant carica il file TGZ e crea il servizio componente incorporato. Durante il caricamento, Digital Assistant verifica che il package sia valido e può rifiutarlo per i motivi descritti più avanti in questa sezione.

   Dopo aver caricato il file TGZ, il servizio componente personalizzato viene creato e i relativi componenti vengono distribuiti. Se nella pagina Componenti viene visualizzato un messaggio di distribuzione in attesa dopo aver caricato il file TGZ, significa che il servizio è stato creato, ma non è ancora disponibile. Quando il servizio diventa disponibile, i metadati di distribuzione vengono visualizzati al posto del messaggio di distribuzione in attesa.

7. Assicurarsi che l'opzione Servizio abilitato sia attivata.

Durante il caricamento, Digital Assistant potrebbe rifiutare il pacchetto. Ecco i motivi del rifiuto e i modi per risolvere i problemi.

• JavaScript contiene errori di sintassi: se il valore JavaScript di un componente contiene errori di sintassi, tale componente non viene aggiunto al contenitore e pertanto viene visualizzato il seguente messaggio di errore:

  Error Message: failed to start service built: Invalid component
        path:

  Visualizzare i file dei componenti in un editor che rileva gli errori di sintassi. Provare inoltre a ospitare il pacchetto su un server locale che invia messaggi di errore a un log della console.

  Un altro motivo per questo messaggio potrebbe essere che il pacchetto non contiene tutte le dipendenze del modulo nodo. Vedere l'elemento successivo in questo elenco.

• Moduli nodo mancanti: se il pacchetto non contiene tutte le dipendenze del modulo nodo, verrà visualizzato lo stesso messaggio di errore riportato sopra.

  Error Message: failed to start service built: Invalid component
        path:

  Per informazioni su come includere le dipendenze dei moduli nodo, vedere Preparare il package per un servizio contenitore incorporato.

• Nome componente troppo lungo: se il nome di un componente contiene più di 100 caratteri, inizia con System. o contiene caratteri diversi da caratteri alfanumerici e caratteri di sottolineatura, la creazione del servizio non riesce.

  Modificare il nome nel componente JavaScript, reimpacchettare e caricare di nuovo.

• Limite di servizio dei componenti superato: se l'istanza dispone già del numero massimo di servizi dei componenti personalizzati incorporati, la creazione del servizio non riesce. Chiedere all'amministratore del servizio il limite di embedded-custom-component-service-count come descritto in Visualizza limiti del servizio nella console dell'infrastruttura.

  Se è necessario aumentare il limite, è possibile richiedere un aumento. Vedere Come richiedere un aumento del limite del servizio.

• File TGZ troppo grande: questo si verifica in genere quando il file .npmignore non contiene una voce *.tgz e, pertanto, ogni volta che vengono inseriti i file, viene aggiunta una copia nidificata dell'area TGZ esistente.

  Quando la cartella di livello superiore contiene un file .npmignore con *.tgz, la versione precedente del file TGZ non viene inclusa quando si aggiorna il pacchetto.

Se si desidera inviare le istruzioni context.logger() del componente personalizzato al log del servizio, passare a Abilita log componente. Questo switch è disponibile solo nelle istanze di Oracle Digital Assistant di cui è stato eseguito il provisioning su Oracle Cloud Infrastructure (a volte indicata come infrastruttura cloud di generazione 2).

Quando l'opzione Abilita registrazione componenti è attivata, è possibile fare clic sul pulsante Diagnostica del servizio per accedere ai log delle viste e ai report degli arresti anomali per diagnosticare il problema.

• Selezionare Visualizza log per visualizzare i messaggi inviati dal componente personalizzato a context.logger(). Questa funzione è disponibile solo nelle istanze di Oracle Digital Assistant di cui è stato eseguito il provisioning su Oracle Cloud Infrastructure (a volte indicata come infrastruttura cloud di generazione 2). Lo switch Abilita log componente deve essere Attivo affinché il log contenga questi messaggi.
• Selezionare View Crash Report per visualizzare i dettagli su che cosa ha causato il crash del contenitore.

Dopo aver creato il servizio, è possibile richiamare i componenti personalizzati dal flusso della finestra di dialogo come descritto in Componenti personalizzati.