204: Desplegar NeuralSeek con watsonx Assistant y Watson Discovery
En esta guía de aprendizaje, utilizará los servicios Watson Discovery, watsonx Assistant y NeuralSeek que están disponibles en el catálogo de IBM Cloud para crear un asistente virtual que pueda responder a las preguntas sobre Watson Discovery. El asistente generará respuestas utilizando la documentación del producto Watson Discovery existente como su base de conocimientos.
Cuando termine la guía de aprendizaje, comprenderá cómo:
- Crear un proyecto de recuperación de documentos en Descubrimiento.
- Cargue documentos PDF en su proyecto y aplique un modelo de comprensión de documentos inteligentes con formación de usuario a sus PDFs.
- Conecte el proyecto de descubrimiento a una instancia de servicio de NeuralSeek. NeuralSeek es un motor de generación de respuesta impulsado por IA.
- Cree un asistente en watsonx Assistant y aplique una integración de NeuralSeek al mismo.
- Añada una acción a su asistente de watsonx que se conecta a NeuralSeek para obtener respuestas.
- Utilice su asistente para responder preguntas sobre el descubrimiento.
Requisitos previos
Los pasos siguientes presuponen que ya tiene un ID de IBM. Si este no es el caso, cree primero un ID de IBM.
Continuación este enlace para reservar un Atención al cliente-GenAI Entorno de TechZone. Este entorno proporciona los servicios de watsonx Assistant, Watson Discovery y NeuralSeek que son necesarios para este laboratorio.
- Seleccione Reserva ahora y Práctica/Autoeducación.
- Introduzca
watsonx Assistant L4
en el Descripción del propósito. - Seleccione us-sur como su Geografía preferida.
- Marque el recuadro para aceptar los términos y condiciones y pulse Presentar.
Debe obtener un correo electrónico informándole de que su entorno se está suministrando. Poco después, debe recibir un segundo correo electrónico informándole de que su entorno está listo:

- Pulse en Ver mis reservas y luego haga clic en su ambiente reservado.
En la parte inferior de esta página, encontrará enlaces a la Página de instancia de servicio de Watson Discovery y el página de instancia de servicio de watsonx Assistant. Cuando estas páginas se mencionan en el laboratorio a continuación, usted puede navegar a ellos a través de estos enlaces (que serán diferentes para su entorno):

De forma alternativa, puede abrir el menú Navegación en IBM Cloud, pulse Lista de recursos , abra el AI/Machine Learning , haga clic en un servicio allí y haga clic en Ver todos los detalles. Esto también es cómo usted puede navegar a la Página de instancia de servicio NeuralSeek Lite ( ...neuralseek-lite
).
- Ir a Notificaciones en IBM Cloud (el icono de campana en la parte superior derecha) y acepte la invitación al entorno TechZone pulsando Únase ahora.
Paso 1: Obtener la documentación del producto
Para utilizar la documentación del producto de descubrimiento como nuestra base de conocimientos, descargaremos la documentación del producto como dos archivos PDF. La documentación se ha dividido en dos archivos para que se pueda enriquecer más rápidamente en el descubrimiento.
Ve aquí y pulse Descargar archivo sin formato para descargar discovery-data-1.pdf.
Ve aquí y pulse Descargar archivo sin formato para descargar discovery-data-2.pdf.
Paso 2: 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 de descubrimiento como origen de datos.
En Descubrimiento, creará un Recuperación de documentos tipo de proyecto. Los documentos que añada a un proyecto de este tipo se enriquecen automáticamente de las siguientes maneras:
- Las entidades, como los nombres propios, se identifican y etiquetan.
- Las partes del habla se identifican y se etiquetan.
Esta información etiquetada se utiliza más tarde cuando se envía una frase de lenguaje natural como una consulta de búsqueda para devolver una respuesta precisa.
- Abra una nueva pestaña de navegador web y vaya a IBM Cloud.
- De la Página de instancia de servicio de Watson Discovery en IBM Cloud, pulse Iniciar el descubrimiento de Watson.
- De la Mis proyectos página, pulse Nuevo proyecto.
- Nombre del proyecto
Discovery documentation
y, a continuación, haga clic en Recuperación de documentos azulejo.

- Pulse en Siguiente.
Configurará el origen de datos para el proyecto en el paso siguiente.
Paso 3: Cargar datos en el proyecto
Añada los PDF de documentación al proyecto de descubrimiento.

-
Nombre de la colección Descubrimiento docs parte 1.
-
Pulse en Arrastrar y soltar archivos aquí o subir , y a continuación, examine para añadir el primer archivo PDF que ha creado anteriormente.
-
Pulse en Acabado.
El archivo se procesa tal como se añade a la colección.
-
En el panel de navegación, pulse Gestionar colecciones y, a continuación, pulse Nueva colección.

- Repita los pasos anteriores para añadir el segundo archivo PDF como una colección denominada Descubrimiento docs parte 2.
Después de subir los datos, el descubrimiento procesa e indexa. Mientras se procesan los datos, vamos a crear nuestro asistente virtual.
Paso 4: Crear un asistente
Para esta guía de aprendizaje, creará un asistente con una única acción.
-
Abra una nueva pestaña de navegador web y vaya a IBM Cloud.
-
De la página de instancia de servicio de watsonx Assistant en IBM Cloud, pulse Iniciar asistente de watsonx.
Se visualiza la interfaz de usuario del producto watsonx Assistant donde puede crear su primer asistente.
-
Añadir
Discovery expert
como nombre de asistente y, a continuación, pulse Siguiente. -
Si se le pide que comparta información sobre usted y su asistente, complete los campos necesarios y, a continuación, pulse Siguiente.
Al crear un asistente, se crea automáticamente una aplicación de conversación web.
-
Pulse en Crear para crear el asistente y la aplicación de chat web correspondiente.
Después de un mensaje de felicitación, se muestra la página de inicio de su nuevo asistente.

Antes de añadir algo a nuestro nuevo asistente, vamos a comprobar el estado de nuestros datos.
Paso 5: Preparar los datos para la recuperación
Para mejorar la capacidad de recuperación de la información en sus archivos PDF, dividirá los archivos PDF en muchos documentos más pequeños. Para ello, primero enseñará a Discovery sobre la estructura de sus archivos PDF, por lo que comprende cómo se formatean las subsecciones y puede dividir el documento por subsección.
-
Vuelva a la pestaña del navegador web donde se visualiza el proyecto de descubrimiento.
El Mejorar y personalizar para el último archivo PDF que ha subido se visualiza.
-
De la Herramientas de mejora panel, expandir Definir estructura y, a continuación, pulse Nuevos campos.

-
Elija la opción Descubrimiento docs parte 1 recogida.
Se visualiza la pestaña Identificar campos, donde puede elegir el tipo de modelo de comprensión de documento inteligente que desea utilizar.
-
Pulse en Modelos formados por el usuario y, a continuación, pulse Presentar.

-
Pulse en Aplicar cambios y reprocesar.
Después de que se produzca algún proceso, se visualiza una representación del documento en la herramienta de comprensión de documentos inteligentes. La herramienta 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 están etiquetados como
text
porque todo el contenido del documento se considera texto estándar de forma predeterminada y se indexa en eltext
.Queremos etiquetar todas las cabeceras de primer y segundo nivel como subtítulos en lugar de texto.
-
En la vista miniaturas, pulse la miniatura de la primera página de texto completo del documento para abrir la primera página con contenido real.

- Para anotar el documento, haga clic en
subtitle
etiqueta de la Campo lista de etiquetas. A continuación, pulse cada bloque en la representación de la página PDF que representa una cabecera para cambiar su etiqueta detext
asubtitle
.

-
Después de que cada subtítulo de la página actual esté etiquetado, pulse Página Enviar.
Se visualiza la página siguiente del archivo PDF.

-
Repita este proceso hasta que la herramienta sea capaz de etiquetar las cabeceras correctamente para usted de forma coherente cuando las nuevas páginas se carguen en la herramienta. En ese punto, haga clic en Aplicar cambios y reprocesar.
¡Felicidades Ha capacitado con éxito un modelo de Smart Document Understanding (SDU) que puede reconocer subtítulos en sus documentos. Vamos a aplicar el mismo modelo al otro archivo PDF que ha añadido al proyecto.
-
En la barra de herramientas del editor de SDU, haga clic en Modelo de exportación icono (flecha abajo) y, a continuación, pulse Exportación.
-
Guardar el
.sdumodel
a su sistema en una ubicación en la que puede acceder a él de nuevo en breve. -
En el panel de navegación, pulse Gestionar colecciones y, a continuación, abrir el Descubrimiento docs parte 2 recogida.
-
Abra el Identificar campos.
-
Pulse en Modelos formados por el usuario y, a continuación, pulse Presentar.
-
Pulse en Aplicar cambios y reprocesar.
-
En la barra de herramientas del editor de SDU, haga clic en Modelo de importación icono (flecha arriba) y, a continuación, pulse Carga.
-
Seleccione la opción
.sdumodel
que ha descargado anteriormente y, a continuación, pulse Seleccionar modelo. -
Pulse en Aplicar cambios y reprocesar para aplicar el mismo modelo de SDU a la primera colección.
El descubrimiento vuelve a procesar los datos de su índice para identificar los subtítulos en los documentos. Mientras los datos están siendo reprocesados, vamos a crear nuestro generador de respuestas.
Paso 6: Crear una instancia de servicio NeuralSeek
Puede utilizar una extensión de búsqueda en watsonx Assistant para conectar su asistente directamente a Discovery y devolver pasajes directamente del 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 del Discovery y luego los convierte en respuestas que suenan más conversacionales.
-
Abra una nueva pestaña de navegador web y vaya a IBM Cloud.
-
De la Página de instancia de servicio NeuralSeek Lite en IBM Cloud, pulse Lanzar NeuralSeek.
-
Haga clic en Configurar y haga clic en Mostrar opciones avanzadas.
-
En Conexión Base de Conocimientos :
- Conjunto Lenguaje de conocimiento base al inglés.
- Especifique la URL del servicio de descubrimiento y Clave de API de descubrimiento (ambos encontrados en el Página de instancia de servicio de Watson Discovery ).
- Especifique la ID de proyecto de descubrimiento (en Watson Discovery, pulse Integrar y desplegar desde el panel de navegación, abra el Información de API y copiar el ID del proyecto ).
-
En Ajuste de la base de conocimientos :
- Conjunto Rango de puntuación de documento a 50%.
- Conjunto Tamaño de fragmento a 400 caracteres.
-
En Preferencias de empresa/organización , proporcione el nombre de su empresa.
-
En Governance & Guardrails , set Porcentaje mínimo de confianza a 30%.
-
Pulse en Guardar.
Paso 7: Dividir sus documentos PDF
Ahora que los subtítulos se indexan correctamente en Discovery, utilícelas como base para dividir los archivos PDF en muchos documentos más pequeños.
- Vuelva a la pestaña del navegador web donde se visualiza el proyecto de descubrimiento.
- Abra el Gestionar campos para la colección actual.
- En Mejorar los resultados de la consulta dividiendo los documentos , pulse Dividir el documento +.
- En el Dividir el documento en cada aparición de , seleccione subtítulo y, a continuación, pulse Aplicar cambios y reprocesar.

- En el panel de navegación, pulse Gestionar colecciones , y luego abrir la otra colección.
- Ir a la Gestionar campos y, a continuación, elegir subtítulo en el Dividir el documento en cada aparición de.
- Pulse en Aplicar cambios y reprocesar.
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 el índice se está reconstruyendo, vamos a tener a nuestro asistente listo.
Paso 8: Añadir una extensión a su asistente
Conecte el asistente a la instancia de servicio NeuralSeek.
- En la pestaña NeuralSeek, pulse el botón Integrar y siga las instrucciones para configurar la extensión personalizada NeuralSeek para su asistente. Cuando termine el paso 6 del procedimiento en NeuralSeek, continúe con el siguiente paso del procedimiento aquí.

- En el panel de navegación de watsonx Assistant, pulse Acciones y, a continuación, pulse Crear acción +.
- Elija Inicio rápido de plantillas y, a continuación, desplácese a buscar y haga clic en Kit de inicio de NeuralSeek.

-
Pulse en Seleccione este kit de inicio y, a continuación, pulse Añadir plantillas.
-
Pulse para abrir el Búsqueda de neuralSeek que usted acaba de añadir al asistente.
-
Añada las siguientes consultas de ejemplo de usuario:
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.
-
Pulse en Paso 3 para abrirlo para su edición.
En el Y luego , pulse Editar extensión.
Establezca las variables como se muestra a continuación (
query_text
está bajo Variables de sesión ):Pulse en Aplicar.
-
Pulse en Paso 6 para abrirlo para su edición.
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 IBM Cloud Docs.
Cambie la referencia de hipertexto en el elemento HTML de ancla para que contenga el URL siguiente:
<a href="https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-about" target="_blank">

- Guarde los cambios y, a continuación, pulse la X para cerrar el paso.
¡Felicidades Ha creado correctamente una acción que reconoce las preguntas sobre el descubrimiento y obtiene sus respuestas de la extensión NeuralSeek conectada.
Paso 9: Configurar el chat web para su asistente
Para obtener una vista previa de su asistente, utilizará el chat web incorporado como interfaz de usuario de conversación para interactuar con el asistente.
-
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 el chat web está conectado a la extensión NeuralSeek.

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

¡Estás listo para previsualizar a tu asistente!
Paso 10: Vista previa del asistente
Para obtener una vista previa de un asistente que se conecta a datos almacenados en Descubrimiento, debe obtener una vista previa del asistente de Entornos. Cuando se previsualiza el chat web de forma independiente, el asistente no puede recuperar datos del descubrimiento; necesita los recursos de entorno para poder conectarse al descubrimiento.
-
De la Entornos página, pulse Vista previa de este entorno.
Se visualiza una página web de ejemplo que incluye un icono de conversación.
-
Pulse el icono de conversación para abrir la ventana de conversación web.

-
Especifique 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.

-
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.

-
Opcionalmente, pregunte al asistente otras preguntas.
Si el asistente no conoce la respuesta, redenomine la pregunta para incluir "en Watson Discovery" para que sea más claro que usted está preguntando acerca de cómo algo funciona específicamente en el Discovery.
¡Felicidades Ha creado correctamente un asistente que puede responder a preguntas sobre el descubrimiento mediante la recuperación de información de la documentación del producto mediante el servicio NeuralSeek.
Resumen
En esta guía de aprendizaje, ha creado un proyecto de recuperación de documentos de Watson Discovery con archivos PDF cargados que contienen la documentación del producto de descubrimiento. Por separado, ha creado un asistente virtual de watsonx Assistant con una única acción que puede reconocer las preguntas de usuario sobre el descubrimiento. Ha añadido una extensión personalizada a su asistente que se conecta a un servicio de terceros llamado NeuralSeek que obtiene la respuesta correcta de Discovery y redice la respuesta. Por último, probó a su asistente virtual haciendo una pregunta y obteniendo una respuesta precisa y bien escrita.