Si desea alojar el paquete de componentes personalizados de Oracle Digital Assistant como un servicio de componentes incrustado, primero debe empaquetar los componentes personalizados en un archivo TGZ. A continuación, cargue este archivo al crear el servicio de componentes incrustado.

Este archivo TGZ, que se empaqueta mediante bots-node-sdk pack, debe contener los activos y la estructura descritos en Implantación de componentes personalizados. También debe contener todos los módulos de nodo de los que depende (bots-node-sdk pack lo hace por usted).

Para preparar un paquete para cargarlo en el servicio de contenedor incrustado:

1. Asegúrese de tener la última versión de las herramientas de línea de comandos de Node.js de bots.

   El contenedor incrustado requiere que el archivo TGZ incluya todos los elementos dependencies. Las versiones anteriores no incluían los elementos dependencies en el archivo. Ahora, el comando que utilizará para crear el archivo TGZ garantiza que el archivo package.json contiene un nodo bundledDependencies que muestra todos los módulos dependientes que se deben incluir en el archivo TGZ.

2. En el directorio que contiene el archivo main.js, ejecute el siguiente comando para cada uno de los módulos de los que depende el paquete. No es necesario que lo haga para elementos devDependencies, como el SDK del nodo de bots.

   Este comando agrega el módulo a la carpeta node_modules y lo agrega como dependencia en package.json.

   npm install <module>

   Si package.json ya nombra todas las dependencias, puede ejecutar npm install en su lugar.

3. Asegúrese de que la carpeta de nivel superior contiene un archivo .npmignore que tiene una entrada *.tgz. Por ejemplo:

   *.tgz
   spec
   service-*

   De lo contrario, al empaquetar los archivos en un archivo TGZ, se incluirá el archivo TGZ que ya existe en la carpeta de nivel superior, y el archivo TGZ doblará su tamaño. Después de empaquetar los archivos unas cuantas veces, el archivo TGZ será demasiado grande para cargarlo en el contenedor.

4. Ejecute este comando:

   bots-node-sdk pack

   Este comando valida el paquete de componentes, lo actualiza para incluir devDependencies si es necesario y, a continuación, crea un archivo TGZ, el cual deberá cargar al crear un servicio de componentes incrustado desde el separador Componentes de la aptitud. Tenga en cuenta que los archivos que ha enumerado como dependencies se incluyen como bundledDependencies, a excepción del SDK del nodo de bots y Express , que son devDependencies.

El paquete debe ser compatible con el nodo 14.17.0.

Para obtener más información sobre el comando pack, consulte https://github.com/oracle/bots-node-sdk/blob/master/bin/CLI.md.

Después de empaquetar un paquete de componentes personalizado en un archivo TGZ, puede cargarlo para crear un servicio de componentes incrustado desde el separador Componentes de la aptitud.

Para obtener más información sobre cómo crear el archivo TGZ, consulte Preparación del paquete para un servicio de contenedor incrustado.

Para crear el servicio de componentes incrustado:

1. En la aptitud, haga clic en Componentes .

2. Haga clic en .

3. Seleccione Contenedor incrustado.

4. Haga clic en Cargar un archivo de paquete de componentes y apunte al archivo TGZ que desea cargar o arrástrelo hasta el cuadro Archivo de paquete.

5. (Opcional) Si desea enviar sentencias context.logger() del componente personalizado al log del servicio, cambie Activar registro del componente a Activado. Este conmutador solo está disponible en las instancias de Oracle Digital Assistant aprovisionadas en Oracle Cloud Infrastructure (a veces denominada infraestructura en la nube de 2ª generación).

   Puede ver el log desde el separador Componentes haciendo clic en Diagnóstico > Ver logs.

   Nota
   
   La aptitud mantiene una entrada de log durante dos días. Al suprimir un servicio de componente personalizado embebido, se suprimen las entradas de log de la aptitud para ese servicio.

6. Haga clic en Crear.

   Digital Assistant carga el archivo TGZ y crea el servicio de componentes incrustado. Durante la carga, Digital Assistant verifica que el paquete es válido y puede rechazar el paquete por los motivos que se describen más adelante en esta sección.

   Después de cargar el archivo TGZ, se crea el servicio de componentes personalizados y se despliegan sus componentes. Si la página Componentes muestra un mensaje de espera de despliegue después de cargar el archivo TGZ, significa que el servicio se ha creado, pero aún no está disponible. Cuando el servicio esté disponible, se mostrarán los metadatos del despliegue, en lugar del mensaje de espera de despliegue.

7. Asegúrese de que Servicio activado se haya activado.

Durante la carga, Digital Assistant podría rechazar el paquete. A continuación se indican los motivos de rechazo y las formas de resolver los problemas.

• JavaScript contiene errores de sintaxis: si JavaScript de un componente tiene errores de sintaxis, dicho componente no se agrega al contenedor, lo que da como resultado al siguiente mensaje de error:

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

  Visualice los archivos del componente en un editor que detecte errores de sintaxis. Además, intente alojar el paquete en un servidor local que envíe mensajes de error al log de una consola.

  Otra causa de este mensaje podría ser que el paquete no contenga todas las dependencias del módulo de nodos. Consulte el siguiente elemento de esta lista.

• Faltan módulos de nodo: si el paquete no contiene todas las dependencias del módulo de nodos, obtendrá el mismo mensaje de error que en el caso anterior:

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

  Para saber cómo incluir las dependencias del módulo de nodos, consulte Preparación del paquete para un servidor de contenedor incorporado.

• El nombre del componente es demasiado largo: si un nombre de componente tiene más de 100 caracteres, comienza por System. o contiene caracteres alfanuméricos y subrayados, se producirá un fallo durante la creación del servicio.

  Cambie el nombre en el JavaScript del componente, y vuelva a empaquetarlo y a cargarlo.

• Se ha excedido el límite de servicios de componentes: si la instancia ya tiene el número máximo de servicios de componentes personalizados incrustados, se producirá un fallo durante la creación del servicio. Consulte al administrador del servicio el límite embedded-custom-component-service-count, como se describe en Visualización de los límites de servicio en la consola de Infrastructure.

  Si necesita incrementar el límite, puede solicitar un aumento. Consulte Solicitud de aumento del límite de servicio.

• El archivo TGZ es demasiado grande: normalmente ocurre cuando el archivo .npmignore no contiene una entrada *.tgz y, por lo tanto, cada vez que empaqueta los archivos, se agrega una copia anidada del TGZ existente.

  Cuando la carpeta de nivel superior contiene un archivo .npmignore con *.tgz, la versión anterior del archivo TGZ no se incluye al actualizar el paquete.

Si desea enviar sentencias context.logger() de componente personalizado al log del servicio, cambie Activar registro del componente a Activado. Este conmutador solo está disponible en las instancias de Oracle Digital Assistant aprovisionadas en Oracle Cloud Infrastructure (a veces denominada infraestructura en la nube de 2ª generación).

Cuando se cambia Activar registro del componente a Activado, puede hacer clic en el botón Diagnóstico del servicio para acceder a los logs de vista y los informes de fallos para diagnosticar el problema.

• Seleccione Ver logs para ver los mensajes que el componente personalizado envía a context.logger(). Esta función solo está disponible en instancias de Oracle Digital Assistant aprovisionadas en Oracle Cloud Infrastructure (a veces denominada infraestructura en la nube de 2ª generación). El conmutador Activar registro del componente debe estar activado para que el log contenga estos mensajes.
• Seleccione Ver informe de bloqueo para ver detalles sobre lo que puede haber causado el bloqueo del contenedor.

Después de crear el servicio, puede llamar a los componentes personalizados desde el flujo de diálogo como se describe en Componentes personalizados.