Objetivos de aprendizaje

Cuando termine la guía de aprendizaje, habrá aprendido a:

• Cree un proyecto de recuperación de documentos en Discovery.
• Cargue documentos PDF en el proyecto y aplique un modelo de Smart Document Understanding entrenado por el usuario a los PDF.
• Conecte el proyecto Discovery a una instancia de servicio NeuralSeek. NeuralSeek es un motor de generación de respuestas basado en IA.
• Cree un asistente en watsonx Assistant y aplique una integración de NeuralSeek.
• Añada una acción a watsonx Assistant que se conecte a NeuralSeek para obtener respuestas.
• Utilice su asistente para responder a preguntas sobre Discovery.

NeuralSeek es un producto de terceros suministrado por un proveedor ajeno a IBM y está sujeto a un acuerdo independiente entre usted y el tercero, si acepta sus condiciones. IBM no es responsable del producto y no asume ningún compromiso en materia de privacidad, seguridad, rendimiento, asistencia o de otro tipo en relación con el producto.

Obtener la documentación del producto

Para utilizar la documentación del producto Discovery como nuestra base de conocimiento, descargaremos la documentación del producto como un archivo PDF.

1. Desde un navegador web, vaya al sitio de documentación del producto.

   https://cloud.ibm.com/docs/discovery-data
   

2. En el panel de tabla de contenido, pulse el icono de menú de desbordamiento en la sección Guía del producto y, a continuación, seleccione Ver como PDF.

3. Guarde el archivo PDF en el sistema pulsando el icono Guardar en la cabecera de página.

4. Utilice un editor de archivos PDF para dividir el documento PDF en dos archivos PDF separados de tamaño similar.

   La división del PDF crea dos archivos más pequeños que se pueden enriquecer más rápidamente en Discovery.

Crear un proyecto de recuperación de documentos

Ahora que tiene la copia más reciente de la documentación del producto, añádala a un proyecto Discovery como origen de datos.

En Discovery, creará un tipo de proyecto Recuperación de documentos. Los documentos que añada a un proyecto de este tipo se enriquecen automáticamente de las formas siguientes:

• Las entidades, como los nombres adecuados, se identifican y etiquetan.
• Las categorías léxicas se identifican y etiquetan.

Esta información etiquetada se utiliza más adelante cuando se envía una frase de lenguaje natural como una consulta de búsqueda para devolver una respuesta precisa.

1. Abra una nueva página de navegador web.

2. En la página de servicio del plan Discovery Plus en IBM Cloud, pulse Iniciar Discovery.

3. En la página Mis proyectos, haga clic en Nuevo proyecto.

4. Asigne el nombre Discovery documentation al proyecto y, a continuación, pulse el mosaico Recuperación de documentos.

   

5. Pulse Siguiente.

Configurará el origen de datos para el proyecto en el paso siguiente.

Cargar datos en el proyecto

Añada los PDF de documentación al proyecto Discovery.

1. En la página Seleccionar origen de datos, pulse el mosaico Cargar datos y, a continuación, pulse Siguiente.

   

   cargados*

2. Asigne a la colección el nombre Documentos de descubrimiento parte 1y, a continuación, pulse Siguiente.

3. Pulse Arrastrar y soltar archivos aquí o cargar y, a continuación, examine para añadir el primer archivo PDF que ha creado anteriormente.

4. Pulse Finalizar.

   El archivo se procesa a medida que se añade a la colección.

5. En el panel de navegación, pulse Gestionar colecciones y, a continuación, pulse Nueva colección.

   

6. Repita los pasos anteriores para añadir el segundo archivo PDF como una colección denominada Discovery docs part 2.

Después de cargar los datos, Discoverylos procesa e indexa. Mientras se procesan los datos, vamos a crear nuestro asistente virtual.

Crear un asistente

Para esta guía de aprendizaje, creará un asistente con una sola acción. En primer lugar, debe crear una instancia de servicio de watsonx Assistant.

Tanto el plan Lite como el plan de prueba watsonx Assistant están disponibles sin coste alguno. Creará un plan de prueba.

1. Desde un nuevo separador del navegador web, vuelva al catálogo IBM Cloud.

   Mantenga abierta la página Discovery en un separador aparte, para que pueda conmutar entre las dos aplicaciones.

2. En la página de recursos watsonx Assistant del catálogo IBM Cloud, cree una instancia de servicio de plan de prueba watsonx Assistant en la ubicación de Dallas.

3. En la página de servicio del plan watsonx Assistant en IBM Cloud, pulse Iniciar watsonx Assistant.

   Se muestra la interfaz de usuario del producto watsonx Assistant donde puede crear su primer asistente.

4. Añada Discovery expert como nombre de asistente y, a continuación, pulse Siguiente.

5. Si se le solicita que comparta información sobre usted y su asistente, complete los campos necesarios y, a continuación, pulse Siguiente.

   Cuando crea un asistente, se crea automáticamente una aplicación de conversación web.

6. Pulse Crear para crear el asistente y la aplicación de conversación web correspondiente.

Después de un mensaje de felicitación, se muestra la página de inicio de su nuevo asistente.

{: caption="

Antes de añadir algo a nuestro nuevo asistente, vamos a comprobar el estado de nuestros datos.

Preparar los datos para la recuperación

Para mejorar la recuperabilidad de la información en los archivos PDF, dividirá los archivos PDF en muchos documentos más pequeños. Para ello, primero enseñará a Discovery sobre la estructura de los archivos PDF, para que comprenda cómo se formatean las subsecciones y pueda dividir el documento por subsección.

1. Vuelva al separador del navegador web donde se muestra el proyecto Discovery.

   Se muestra la página Mejorar y personalizar para el último archivo PDF que ha cargado.

2. En el panel Herramientas de mejora, expanda Definir estructuray, a continuación, pulse Nuevos campos.

   

3. Elija la colección Discovery docs part 1.

   Se visualiza la pestaña Identificar campos, donde puede elegir el tipo de modelo de Smart Document Understanding que desea utilizar.

4. Pulse Modelos entrenados por el usuario y, a continuación, pulse Enviar.

   

   entrenado por el usuario*

5. Pulse Aplicar cambios y volver a procesar.

   Después de que se produzca algún proceso, se visualiza una representación del documento en la herramienta Smart Document Understanding. La herramienta le muestra una vista del documento original junto con una representación del documento, donde el texto se sustituye por bloques. Los bloques representan tipos de campo.

   Inicialmente, los bloques se etiquetan como text porque todo el contenido del documento se considera texto estándar de forma predeterminada y se indexa en el campo text.

   Queremos etiquetar todas las cabeceras de primer y segundo nivel como subtítulos en lugar de texto.

6. En la vista de miniaturas, haga clic en la miniatura de la primera página de texto completo del documento para abrir la primera página con contenido real.

   

7. Para anotar el documento, pulse la etiqueta subtitle de la lista Etiquetas de campo. A continuación, pulse cada bloque en la representación de la página PDF que representa una cabecera para cambiar su etiqueta de text a subtitle.

   {: caption="SDUAplicación de la " caption-side="bottom"} de subtítulos

8. Después de etiquetar cada subtítulo de la página actual, pulse Enviar página.

   Se visualiza la página siguiente del archivo PDF.

   

9. Repita este proceso hasta que la herramienta pueda etiquetar las cabeceras correctamente de forma coherente cuando se carguen nuevas páginas en la herramienta. En ese momento, pulse Aplicar cambios y volver a procesar.

   Enhorabuena. Ha entrenado correctamente un modelo de Smart Document Understanding (SDU) que puede reconocer subtítulos en los documentos. Vamos a aplicar el mismo modelo al otro archivo PDF que ha añadido al proyecto.

10. En la barra de herramientas del editor de SDU, pulse el icono de menú de desbordamiento en la cabecera de página y elija Exportar modelo.

11. Guarde el archivo .sdumodel en el sistema en una ubicación en la que pueda volver a acceder a él en breve.

12. En el panel de navegación, pulse Gestionar colecciones y, a continuación, abra la colección Documentos de descubrimiento parte 2.

13. Abra la pestaña Identificar campos.

14. Pulse Modelos entrenados por el usuario y, a continuación, pulse Enviar.

15. Pulse Aplicar cambios y volver a procesar.

16. En la barra de herramientas del editor de SDU, pulse el icono de menú de desbordamiento y elija Importar modelo y, a continuación, pulse Seleccionar modelo.

17. Examine para encontrar el archivo .sdumodel que ha descargado anteriormente y, a continuación, pulse Abrir.

18. Pulse Aplicar cambios y volver a procesar para aplicar el mismo modelo SDU a la primera colección.

Discovery vuelve a procesar los datos en su índice para identificar subtítulos en los documentos. Mientras los datos se están reprocesando, vamos a crear nuestro generador de respuestas.

Crear una instancia del servicio NeuralSeek

Puede utilizar una extensión de búsqueda en watsonx Assistant para conectar su asistente directamente a Discovery y devolver pasajes directamente desde el origen de datos. Sin embargo, añadiremos el servicio NeuralSeek entre watsonx Assistant y Discovery en esta guía de aprendizaje. NeuralSeek recupera los pasajes de Discovery y, a continuación, los convierte en respuestas que suenan más conversacionales.

1. Desde un nuevo separador del navegador web, vuelva al catálogo IBM Cloud.

   Mantenga las páginas de los demás servicios abiertas en separadores separados, para que pueda conmutar entre las distintas instancias de servicio.

2. En la página de recursos NeuralSeek del catálogo IBM Cloud, cree una instancia de servicio de plan Lite.

3. En la página Configurar, añada detalles sobre la instancia de servicio de Discovery y personalice la conexión.

   • Puede obtener el servicio URL y la clave API en la página de detalles de la instancia de servicio Discovery en IBM Cloud.
   • El ID de proyecto está disponible en la interfaz de usuario de IBM Cloud. Para obtenerlo, pulse Integrar y desplegar en el panel de navegación. Abra la página Información de API y, a continuación, copie el ID de proyecto.
   • Establezca el rango de puntuación de documento en 50%.
   • Cambie el tamaño de carácter de fragmento de código a 400.
   • Especifique su empresa como nombre de visualización de la empresa.
   • Cambie el porcentaje de confianza mínimo a 50.

   Pulse Guardar.

Dividir los documentos PDF

Ahora que los subtítulos se indexan correctamente en Discovery, utilícelos como base para dividir los archivos PDF en muchos documentos más pequeños.

1. Vuelva al separador del navegador web donde se muestra el proyecto Discovery.

2. Abra la pestaña Gestionar campos para la colección actual.

3. En el campo Dividir documento en cada aparición de, elija subtítulo y, a continuación, pulse Aplicar cambios y volver a procesar.

   

4. En el panel de navegación, pulse Gestionar colecciones y, a continuación, abra la otra colección.

5. Vaya a la página Gestionar campos y, a continuación, elija subtítulo en el campo Dividir documento en cada aparición de.

6. Pulse Aplicar cambios y volver a procesar.

Las colecciones empiezan a reprocesarse. Una vez finalizada la reindexación, en lugar de contener un documento cada uno, las colecciones contendrán varios cientos de documentos cada uno.

Mientras se está reconstruyendo el índice, pongamos a punto nuestro asistente.

Añade una extensión a tu asistente

Conecte el asistente a la instancia de servicio de NeuralSeek.

1. Vuelva a abrir el servicio NeuralSeek desde IBM Cloud. Puede encontrar la instancia en la sección AI y Machine Learning de la lista de recursos.

2. Pulse el separador Integrar y siga las instrucciones para configurar la extensión personalizada NeuralSeek para el asistente. Vuelva a este procedimiento cuando esté preparado para crear la acción.

   

   de la NeuralSeek instancia*

3. En el panel de navegación watsonx Assistant, pulse Acciones y, a continuación, pulse Nueva acción.

4. Elija Inicio rápido desde plantillas y, a continuación, desplácese para buscar y pulsar el Kit de inicio deNeuralSeek.

   

5. Pulse Seleccionar este kit de inicio y, a continuación, pulse Añadir plantillas.

6. Pulse para abrir la acción de búsqueda NeuralSeek que acaba de añadir al asistente.

7. Añada las siguientes consultas de ejemplo de usuario al primer paso de la acción:

   What Watson Discovery project types are available and what do they do?
   

   What external data sources are supported by Watson Discovery?
   

   Can I add a custom dictionary to Watson Discovery?
   

   How do I use the Content Mining application?
   

   When should I add query expansions to my project?
   

   Which file types support Smart Document Understanding models?
   

   Can I enable optical character recognition for all file types?
   

   Does my data have to be written in English?
   

   watsonx Assistant utiliza las preguntas de ejemplo para reconocer los tipos de preguntas de usuario que debe direccionar a esta acción.

8. Pulse para abrir el paso 3 para editarlo.

   En la sección Y, a continuación,, pulse Editar extensión.

   Elija NeuralSeek y haga clic en Aplicar.

   

9. Pulse para abrir el paso 6 para editarlo.

   Este paso muestra un enlace que los usuarios pueden pulsar para obtener más información. Queremos que este enlace vaya directamente a la documentación del producto en el sitio de documentos de IBM Cloud.

   Cambia la referencia de hipertexto en el elemento HTML anchor para que contenga la siguiente URL:

   <a href="https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-about" target="_blank">
   

   : caption="Cambiar la URL del enlace Más información " caption-side="bottom"}

10. Guarde los cambios y, a continuación, pulse la X para cerrar el paso.

Enhorabuena. Ha creado correctamente una acción que reconoce preguntas sobre Discoveryy obtiene sus respuestas de la extensión NeuralSeek conectada.

Configurar la conversación web para su asistente

Para obtener una vista previa de su asistente, utilizará el chat web incorporado como interfaz de usuario de chat para interactuar con el asistente.

1. En el panel de navegación de watsonx Assistant, pulse Entornos.

   Se visualiza el entorno de borrador. Muestra que un chat web está conectado a su asistente. También puede ver que la conversación web está conectada a la extensión NeuralSeek.

   

2. Pulse el mosaico Conversación web para editar la conversación web.

   No queremos añadir múltiples preguntas de inicio, así que vamos a desactivar la pantalla de inicio para el chat web. Haz clic en la pestaña Pantalla de inicio. Establezca el conmutador en Desactivado y, a continuación, pulse Guardar y salir.

   

¡Está listo para previsualizar su asistente!

Vista previa del asistente

Para obtener una vista previa de un asistente que se conecta a los datos almacenados en Discovery, debe obtener una vista previa del asistente desde la página Entornos. Cuando obtiene una vista previa de la conversación web de forma independiente, el asistente no puede recuperar datos de Discovery; necesita los recursos del entorno para poder conectarse a Discovery.

1. En la página Entornos, pulse Vista previa de este entorno.

   Se muestra una página web de ejemplo que incluye un icono de conversación .

2. Haz clic en el icono de chat para abrir la ventana de chat web.

   

   de bienvenida del chat web*

3. Escriba la siguiente pregunta de texto:

   What project types are available?
   

   Se devuelve la respuesta correcta e incluye un enlace a la documentación del producto.

   {: caption="a la pregunta de la pruebaEl chat web devuelve la " caption-side="bottom"} de la búsqueda

4. Envíe una pregunta que no se haya utilizado como ejemplo de consulta al crear la acción.

   How do you define synonyms in Watson Discovery?
   

   Se devuelve una respuesta detallada.

   {: caption="a la pregunta del testEl chat web devuelve una " caption-side="bottom"} detallada

5. Opcionalmente, haga otras preguntas al asistente.

   Si el asistente no conoce la respuesta, vuelva a formular la pregunta para incluir "en Watson Discovery" para que quede más claro que está preguntando cómo funciona algo en Discovery específicamente.

Enhorabuena. Ha creado correctamente un asistente que puede responder a preguntas sobre Discovery recuperando información de la documentación del producto mediante el servicio NeuralSeek.