Si vous souhaitez héberger l'ensemble de composants personnalisés depuis Oracle Digital Assistant en tant que service de composants intégré, vous devez d'abord assembler les composants personnalisés dans un fichier TGZ. Ensuite, lorsque vous créez le service de composants intégré, vous chargez ce fichier.

Ce fichier TGZ, que vous assemblez à l'aide de bots-node-sdk pack, doit contenir les ressources et la structure décrites dans Mettre en oeuvre des composants personnalisés. Il doit également contenir tous les modules de noeud dont il dépend (bots-node-sdk pack le fait pour vous).

Pour préparer un ensemble à charger dans le service de conteneur intégré :

1. Assurez-vous de disposer de la dernière version des outils de ligne de commande Node.js de développement de robots.

   Le conteneur intégré requiert que le fichier TGZ comprenne tous les éléments dependencies. Les versions antérieures ne regroupaient pas les éléments dependencies dans le fichier. Maintenant, la commande que vous allez utiliser pour créer le fichier TGZ garantit que votre fichier package.json contient un noeud bundledDependencies qui répertorie tous les modules dépendants qui doivent être inclus dans le fichier TGZ.

2. Dans le répertoire qui contient le fichier main.js, exécutez la commande suivante pour chacun des modules dont dépend l'ensemble. Vous n'avez pas besoin d'effectuer cette action pour les éléments devDependencies, comme la trousse SDK Node.js de développement de robots.

   Cette commande ajoute le module au dossier node_modules et l'ajoute comme dépendance dans package.json.

   npm install <module>

   Si package.json nomme déjà toutes les dépendances, alors vous pouvez exécuter npm install à la place.

3. Assurez-vous que le dossier de niveau supérieur contient un fichier .npmignore qui a une entrée *.tgz. Par exemple :

   *.tgz
   spec
   service-*

   Sinon, lorsque vous assemblez les fichiers dans un fichier TGZ, vous incluez le fichier TGZ qui existe déjà dans le dossier de niveau supérieur, et votre fichier TGZ continuera de doubler de volume. Après plusieurs assemblages des fichiers, le fichier TGZ sera trop volumineux pour être chargé dans le conteneur.

4. Exécuter cette commande :

   bots-node-sdk pack

   Cette commande valide l'ensemble de composants, le met à jour pour inclure devDependencies si nécessaire, puis crée un fichier TGZ, que vous chargerez lorsque vous créerez un service de composants intégré à partir de l'onglet Components (Composants) de la compétence. Notez que les fichiers que vous avez listés en tant que dependencies sont inclus en tant que bundledDependencies, à l'exception de la trousse SDK Bots Node et Express, qui sont des devDependencies.

Votre package doit être compatible avec le noeud 14.17.0.

Pour plus d'informations sur la commande pack, voir https://github.com/oracle/bots-node-sdk/blob/master/bin/CLI.md.

Après avoir regroupé un ensemble de composants personnalisés dans un fichier TGZ, vous pouvez le charger pour créer un service de composants intégré à partir de l'onglet Components (Composants) de la compétence.

Pour savoir comment créer le fichier TGZ, voir Préparer l'ensemble pour un service de conteneur intégré.

Pour créer le service de composants intégré :

1. Depuis la compétence, cliquez sur Components (Composants) .

2. Cliquer .

3. Sélectionnez Embedded Container.

4. Cliquez sur Upload a component package file (Charger un fichier d'ensemble de composants) et pointez vers le fichier TGZ à charger, ou faites glisser le fichier vers la zone Package File (Fichier d'ensemble).

5. (Facultatif) Si vous voulez envoyer des énoncés context.logger() de composant personnalisé au journal du service, réglez Enable Component Logging (Activer la journalisation de composant) à On (Activé). Ce commutateur est disponible uniquement avec des instances d'Oracle Digital Assistant provisionnées dans Oracle Cloud Infrastructure (parfois appelée infrastructure en nuage de 2e génération).

   Vous pouvez voir le journal à partir de l'onglet Composants en cliquant sur Diagnostics > Consulter les journaux.

   Note
   
   La compétence conserve une entrée de journal pendant deux jours. Lorsque vous supprimez un service de composants personnalisés intégré, les entrées de journal de la compétence pour ce service sont supprimées.

6. Cliquez sur Create (Créer).

   Digital Assistant charge le fichier TGZ et crée le service de composants intégré. Pendant le chargement, Digital Assistant vérifie que l'ensemble est valide et peut le rejeter pour les raisons décrites plus loin dans cette section.

   Une fois le fichier TGZ chargé, le service de composants personnalisés est créé et ses composants sont déployés. Si la page Components (Composants) affiche un message de déploiement en attente après le chargement du fichier TGZ, cela signifie que le service a été créé, mais n'est pas encore disponible. Lorsque le service est disponible, les métadonnées de déploiement s'affichent à la place du message de déploiement en attente.

7. Assurez-vous que le commutateur Service Enabled (Service activé) est réglé à On (Activé).

Pendant le chargement, Digital Assistant pourrait rejeter l'ensemble. Voici les motifs du rejet et les moyens de résoudre les problèmes.

• JavaScript comporte des erreurs de syntaxe : Si un composant JavaScript contient des erreurs de syntaxe, il n'est pas ajouté au conteneur, ce qui génère le message d'erreur suivant :

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

  Consultez les fichiers du composant dans un éditeur qui détecte les erreurs de syntaxe. Essayez également d'héberger l'ensemble sur un serveur local qui envoie des messages d'erreur à un journal de console.

  Ce message peut aussi s'afficher parce que l'ensemble ne contient pas toutes les dépendances du module de noeud. Voyez le point suivant de cette liste.

• Modules de noeud manquants : Si l'ensemble ne contient pas toutes les dépendances de module de noeud, vous obtenez le même message d'erreur que ci-dessus :

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

  Pour savoir comment inclure des dépendances de module de noeud, voir Préparer l'ensemble pour un service de conteneur intégré.

• Le nom du composant est trop long : Si un nom de composant contient plus de 100 caractères, commence par System. ou comporte des caractères autres que des caractères alphanumériques et des traits de soulignement, la création du service échoue.

  Modifiez le nom dans le JavaScript du composant, refaites l'assemblage et chargez.

• Limite de services de composants dépassée :Si votre instance contient déjà le nombre maximal de services de composants, la création du service échoue. Demandez à l'administrateur de service la limite embedded-custom-component-service-count comme décrit dans Voir les limites de service dans la console d'infrastructure.

  Si la limite est insuffisante, vous pouvez demander une augmentation. Voir Demande d'une augmentation de limite de service.

• Le fichier TGZ est trop volumineux : Cela se produit généralement lorsque le fichier .npmignore ne contient pas d'entrée *.tgz. Chaque fois que vous assemblez les fichiers, une copie imbriquée du TGZ existant est ajoutée.

  Lorsque le dossier de niveau supérieur contient un fichier .npmignore avec *.tgz, la version précédente du fichier TGZ n'est pas incluse lorsque vous mettez à jour l'ensemble.

Si vous voulez envoyer des énoncés context.logger() de composant personnalisé au journal du service, réglez Enable Component Logging (Activer la journalisation de composant) à On (Activé). Ce commutateur est disponible uniquement avec des instances d'Oracle Digital Assistant provisionnées dans Oracle Cloud Infrastructure (parfois appelée infrastructure en nuage de 2e génération).

Lorsque le commutateur 'Enable Component Logging est activé, vous pouvez cliquer sur le bouton Diagnostics du service pour accéder aux journaux et aux rapports de défaillance afin de diagnostiquer le problème.

• Sélectionnez Consulter les journaux pour afficher les messages que le composant personnalisé envoie à context.logger(). Cette fonction est disponible uniquement avec des instances d'Oracle Digital Assistant provisionnées dans Oracle Cloud Infrastructure (parfois appelée infrastructure en nuage de 2e génération). Le commutateur Enable Component Logging doit être activé pour que le journal contienne ces messages.
• Sélectionnez View Crash Report (Voir le rapport de défaillance) pour afficher les détails sur la cause possible de la panne du conteneur.

Après avoir créé le service, vous pouvez appeler les composants personnalisés à partir de votre flux de dialogue comme décrit sous Composants personnalisés.