Antes de empezar

Antes de empezar, debe:

• Configure una instancia de Discovery v2 en IBM Cloud o instalada en IBM Cloud Pak for Data.
• Tener al menos una instancia de servicio de plan Plus Discovery para IBM Cloud. Vaya a la Discovery página del catálogo IBM Cloud y cree una instancia de servicio del plan Plus.
• Utilizar puntos finales públicos. Los puntos finales privados no están soportados actualmente para watsonx Assistant o la experiencia clásica.

Crear la integración de búsqueda o el conocimiento de búsqueda

Para crear una integración de búsqueda:

1. Desde el asistente en el que desea añadir la búsqueda, pulse Integraciones.

   Puede añadir la búsqueda si es un usuario con un plan de pago.

2. En la sección Extensiones, localice Búsqueda, pulse Añadir y, a continuación, pulse Confirmar.

Si está utilizando la experiencia clásica, añada un conocimiento de búsqueda:

1. Desde el asistente en el que quiera añadir el conocimiento, pulse Añadir conocimiento de búsqueda.

2. Realice una de las acciones siguientes:

   • Para crear un nuevo conocimiento de búsqueda, permanezca en el separador Crear conocimiento.

   • Si ya ha creado un conocimiento de búsqueda, se visualiza el separador Añadir conocimiento existente y puede pulsarlo para añadir un conocimiento existente.

3. Especifique los detalles del nuevo conocimiento:

   • Nombre: Un nombre no puede contener más de 64 caracteres. Se necesita un nombre.
   • Descripción: Una descripción opcional no tiene más de 128 caracteres de longitud.

Conectar con una instancia de Discovery existente

1. Elija la instancia del servicio Discovery de la que desea extraer información.

   Si ve una advertencia de que algunas de sus instancias de servicio de Discovery no tienen credenciales establecidas, significa que puede acceder al menos a una instancia que nunca abrió desde el panel de control de IBM Cloud. Para que se creen credenciales para una instancia de servicio, debe acceder a ella, y dichas credenciales tienen que existir antes de que watsonx Assistant pueda establecer una conexión con la instancia del servicio Discovery en su nombre. Si cree que en la lista falta una instancia del servicio Discovery, abra la instancia directamente desde el panel de control de IBM Cloud® para generar credenciales para la misma.

2. Indique la recopilación de datos que se va a utilizar, realizando una de las siguientes acciones:

   • Elija un proyecto existente.

     Puede pulsar el icono Abrir Discovery para revisar la configuración de un proyecto antes de decidir cuál utilizar.

     Vaya a Configurar la búsqueda.

   • Si no tiene un proyecto o no desea utilizar ninguno de los proyectos listados, pulse Crear un proyecto nuevo para añadir uno. Siga los pasos recogidos en Crear un proyecto.

     No se muestra Crear un nuevo proyecto si ha alcanzado los límites basados en su plan de servicio de Discovery. Consulte Planes de precios deDiscovery para obtener detalles de límite de plan.

Crear un proyecto

1. En la página De acuerdo, ¿dónde están los datos?, seleccione el origen de datos y, a continuación, pulse Siguiente. Entre las opciones de ejemplo, se incluyen Salesforce, SharePoint, Box, IBM Cloud Object Storage, el rastreo web y los datos cargados.

2. En las páginas Vamos a crear una recopilación a partir de sus datos, especifique la información sobre cómo conectarse a los datos y cómo configurar la recopilación. La información que debe introducir varía en función de la fuente de datos. Por ejemplo, debe especificar sus credenciales de autenticación para servicios como Salesforce, Sharepoint y Box. Para el rastreo web, especifique el sitio web con su información existente.

3. Pulse Finalizar. Dé a Discovery unos minutos para empezar a crear documentos. Puede utilizar la página Gestionar recopilaciones del proyecto para ver el progreso.

4. Espere a que la ingesta de la recopilación se haya completado y, a continuación, pulse Volver a watsonx Assistant.

Configuración de la búsqueda

1. En la página de integración de búsqueda de watsonx Assistant, comprueba que la instancia de Discovery y el proyecto que deseas utilizar están seleccionados y, a continuación, haz clic en Siguiente.

2. En la sección Configurar el contenido del resultado, revise los campos y ejemplos de Discovery que se utilizan en los resultados de la búsqueda que se muestran a los clientes. Puede aceptar los valores predeterminados o personalizarlos como desee.

   Los campos de recolección adecuados de los que extraer datos varían en función del origen de los datos de la recopilación y de cómo se ha enriquecido el origen de datos. Después de elegir un tipo de recopilación de datos, los valores de campo de recopilación se rellenan previamente con campos de origen que se considere que es probable que tengan información útil, dado el tipo de origen de datos de la colección. En cualquier caso, usted conoce sus datos mejor que nadie. Puede cambiar los campos de origen a otros que contengan la mejor información para cubrir sus necesidades.

   Para obtener más información sobre la estructura de los documentos de la recopilación, incluidos los nombres de los campos que contienen información que quizás quiera extraer, abra la recopilación en Discovery y, a continuación, utilice los separadores Campos de identidad y Gestionar campos.

   Cada resultado de la búsqueda puede constar de las secciones siguientes:

   • Título: título del resultado de la búsqueda. Utilice el título, el nombre o un tipo de campo similar de la recopilación como título de resultado de la búsqueda.

     Debe seleccionar algo para el título o no se visualiza ninguna respuesta de resultados de búsqueda en las integraciones de Facebook y Slack.

   • Cuerpo: descripción del resultado de la búsqueda. Utilice un campo abstracto, de resumen o de resaltado de la recopilación como cuerpo del resultado de la búsqueda.

     Debe seleccionar algo para el cuerpo o no se visualiza ninguna respuesta de resultados de búsqueda en las integraciones de Facebook y Slack.

   • URL: este campo se puede llenar con cualquier contenido de pie de página que desee incluir al final del resultado de la búsqueda.

     Por ejemplo, es posible que desee incluir un enlace de hipertexto al objeto de datos original en su fuente de datos. La mayoría de los orígenes de datos en línea proporcionan URL públicos de referencia automática para objetos del almacén para dar soporte al acceso directo. Si añade un URL, debe ser válido y accesible. Si no es así, la integración de Slack no incluye el URL en su respuesta, y la integración de Facebook no devuelve ninguna respuesta.

     Las integraciones con Facebook y Slack pueden mostrar correctamente la respuesta del resultado de búsqueda cuando el campo URL está vacío.

   Debe utilizar un campo para, como mínimo, uno de los resultados de la búsqueda.

   Si no hay ninguna opción disponible en los campos desplegables, tendrá que dar más tiempo a Discovery para que termine de crear la recopilación. Si la colección no se crea, es posible que no contenga ningún documento o que tenga errores de ingestión que debas solucionar primero.

   

   A medida que se añaden correlaciones de campos, se muestra una vista previa del resultado de la búsqueda con información de los campos correspondientes de la recopilación de datos. Esta vista previa muestra lo que se incluye en la respuesta de resultados de la búsqueda que se devuelve a los usuarios.

   Para obtener ayuda sobre la configuración de la búsqueda, consulte Resolución de problemas.

3. Utilice los separadores Mensaje, No se han encontrado resultados y Problema de conectividad para personalizar distintos mensajes que compartir con los usuarios en función del resultado de la búsqueda.

   Mensajes del resultado de la búsqueda

   Ficha	Escenario	Mensaje de ejemplo
   Mensaje	Se devuelven resultados de la búsqueda	I found this information that might be helpful:
   No se han encontrado resultados	No se han encontrado resultados de la búsqueda	I searched my knowledge base for information that might address your query, but did not find anything useful to share.
   Problema de conectividad	Por algún motivo, no he podido completar la búsqueda.	I might have information that could help address your query, but am unable to search my knowledge base at the moment.

4. Elija si quiere habilitar Enfatizar la respuesta.

   Esta opción solo está disponible si la instancia de Discovery utiliza la API Discovery v2.

   Si se habilita esta característica, la sentencia que Discovery determina como respuesta exacta a la pregunta del cliente se resalta en el bloque de texto que se muestra al cliente como resultado de la búsqueda.

5. En la sección Ajustar la cantidad de resultados, especifique el número de resultados que se van a devolver.

   Los tres primeros resultados se devuelven automáticamente. Puede elegir mostrar menos o más resultados en la respuesta (hasta un máximo de 10).

   De forma predeterminada, los clientes pueden elegir si desean ver más resultados. Si no desea ofrecer a los clientes esta opción, desmarque el recuadro de selección Incluir enlace para que los clientes vean hasta 10 resultados.

6. En la sección Establecer selectividad de resultados, decida si quiere ser más selectivo con las respuestas que se devuelven. Si se incrementa la selectividad de resultados, la búsqueda devuelve menos resultados, pero más precisos. En la mayoría de los casos, la búsqueda es lo bastante precisa como para que el valor predeterminado (desactivado) sea suficiente.

7. Utilice Filtro de resultados personalizado para añadir un filtro para las series de texto personalizadas en la integración de búsqueda. El campo Filtro de resultados personalizado le ayuda a definir los resultados de búsqueda relevantes para un tema, producto o serie de texto. Por ejemplo, si define el campo Filtro de resultados personalizados cantando enriched_text.entities.text:"Boston, MA", las respuestas de búsqueda para cualquier consulta en el asistente se filtran para que sea relevante para "Boston, MA" en el archivo enriched_text.entities.text.

   

8. Pulse Vista previa. Escriba un mensaje de prueba para ver los resultados que se devuelven cuando se aplican las opciones de configuración a la búsqueda. Realice los ajustes necesarios.

9. Pulse Crear.

Editar la configuración de la integración de búsqueda

Si desea cambiar la configuración de la tarjeta de resultados de búsqueda más adelante, vuelva a abrir la integración de búsqueda y realice las ediciones. No es necesario guardar los cambios a medida que los realice; se aplican automáticamente. Cuando esté satisfecho con los resultados de la búsqueda, pulse Guardar para finalizar la configuración de la integración de búsqueda.

Si decide que desea conectarse a una instancia de servicio o proyecto de Discovery diferente, abra la integración de búsqueda y haga clic en Editar configuración de descubrimiento. Puede elegir un nuevo proyecto de la misma instancia o una nueva instancia y proyecto.

Configure su asistente para que utilice la búsqueda Discovery

Después de configurar la integración de búsqueda de Discovery, debe configurar el asistente para que utilice la búsqueda Discovery cuando la respuesta del cliente no coincida con ninguna acción. Para obtener más información sobre cómo actualizar Sin coincidencias para utilizar la búsqueda, consulte Utilizar la búsqueda cuando no coincida ninguna acción.

Resolución de problemas

Revise esta información para obtener ayuda con las tareas más comunes.

• Creación de una recopilación de datos de rastreo web: cosas que hay que saber al crear un origen de datos de rastreo web:

  • Para aumentar el número de documentos disponibles para la recopilación de datos, pulse Añadir un grupo de URL donde puede listar los URL para las páginas que desea rastrear, pero que no están enlazadas desde el URL de inicio.
  • Para reducir la cantidad de documentos disponibles para la recopilación de datos, especifique un subdominio del URL base. O bien, en la configuración de rastreo web, limite el número de saltos desde la página original. También puede especificar subdominios para excluir explícitamente del rastreo.
  • Si no se muestran documentos pasados unos minutos y tras actualizar la página, asegúrese de que el contenido que quiere procesar esté disponible en la página de origen del URL. Algunos contenidos de páginas web se generan dinámicamente y, por lo tanto, no se pueden rastrear.

• Configuración de resultados de búsqueda para documentos cargados: si utiliza una recopilación de documentos cargados y no puede obtener los resultados de búsqueda correctos o los resultados no son suficientemente concisos, pueden plantearse utilizar la característica Smart Document Understanding cuando cree la recopilación de datos.

  Puede anotar documentos basándose en el formato de texto. Por ejemplo, puede enseñar a Discovery que cualquier texto en negrita de 28 puntos es un título de documento. Si aplica esta información a la colección al incorporarla para su proceso, puede utilizar posteriormente el campo title como el origen de la sección de título del resultado de la búsqueda.

  También puede utilizar la Comprensión inteligente de documentos para dividir documentos de gran tamaño en segmentos para facilitar la búsqueda. Para obtener más información, consulte el tema Smart Document Understanding en la documentación de Discovery.

• Mi texto de respuesta está entre corchetes: si observa que el texto de respuesta está entre corchetes y comillas dobles (["My response text"]) cuando lo prueba desde la Vista previa, por ejemplo, es posible que tenga que cambiar el campo de origen que se utiliza en la configuración. Este formato inesperado indica que el valor está almacenado en el documento de origen como una matriz. Cualquier campo del que extraiga texto debe contener un valor con un tipo de datos de serie (String), no un tipo de datos de matriz (Array). Si la integración de la conversación muestra una respuesta extraída de un campo que guarda los datos como una matriz, realiza una conversión directa del valor de matriz en una serie, lo que genera una respuesta que incluye la sintaxis de matriz.

  Por ejemplo, supongamos que el campo del documento de origen contiene una matriz con un solo valor de texto como su único elemento de la matriz:

  "title": ["a single array element"]
  

  watsonx Assistant convierte el valor de matriz en este valor de serie:

  "title": "[\"a single array element\"]"
  

  Como resultado, la serie se devuelve en este formato en la conversación; se muestran los corchetes y las comillas dobles:

  ["a single array element"]
  

  Si detecta que sucede esto, tenga en cuenta la posibilidad de utilizar otro campo de recopilación del que extraer los resultados de la búsqueda.

  El campo highlight del documento de Discovery almacena los valores en una matriz.

Próximos pasos

Después de añadir la integración de búsqueda por primera vez, aparece como un recuadro en la página Borrador de entorno. Haga clic en el mosaico para ver o editar la configuración de búsqueda.

Cuando esté preparado, puede repetir los pasos para añadir la integración de búsqueda a su entorno en directo o a otros entornos, si está utilizando varios entornos.

Probar la integración de búsqueda

Después de configurar la búsqueda, puede enviar consultas de prueba para ver los resultados de búsqueda que se devuelven desde Discovery utilizando la página Vista previa.

Para probar la experiencia completa que tienen los clientes cuando hacen preguntas que se responden con la acción o que desencadenan una búsqueda, utilice la vista previa para su asistente.

Probar el conocimiento de búsqueda en la experiencia clásica

Si está utilizando un conocimiento de búsqueda en la experiencia clásica, puede enviar consultas de prueba para ver los resultados de búsqueda que se devuelven de Discovery utilizando el panel Vista previa del conocimiento de búsqueda.

Para probar la experiencia completa que tendrán los clientes cuando hagan preguntas que vaya a responder el diálogo o que desencadenen una búsqueda, utilice el botón Vista previa del asistente.

Desde el panel "Pruébelo", no puede probar la experiencia de usuario completa. El conocimiento de búsqueda se configura por separado y se conecta a un asistente. El conocimiento de diálogo no tiene forma de saber los detalles de la búsqueda y, por lo tanto, no puede mostrar los resultados de la búsqueda en el panel "Pruébelo".

Configure al menos un canal de integración para probar el conocimiento de búsqueda. En el canal, especifique las consultas que desencadenan la búsqueda. Si inicia cualquier tipo de búsqueda a partir del diálogo, pruebe el diálogo para asegurarse de que la búsqueda se desencadene según lo esperado. Si no utiliza tipos de respuesta de búsqueda, pruebe que se active una búsqueda solo cuando no haya nodos de diálogo existentes que puedan responder a la entrada del usuario. Cada vez que se active una búsqueda, asegúrese de que devuelva resultados con sentido.