Smart Document Access
En esta sección
Smart Document Access es el módulo adicional de Algho donde cargar y gestionar la documentación que se proporciona a los asistentes para responder a los usuarios finales.
El módulo es accesible directamente desde Algho, seleccionando Módulos y luego SDA 2.0.
Gestión de documentos
La sección Gestión de documentos permite crear y gestionar Carpetas y Subcarpetas, además de cargar y gestionar la documentación.
La documentación es accesible seleccionando Gestión de documentos en el menú de la izquierda.
Crear una carpeta
Para crear una nueva carpeta, seleccione la opción Añadir y asigne un nombre a la carpeta.
Crear una subcarpeta
Para crear una nueva subcarpeta, seleccione la opción Añadir.
Asigne un nombre a la subcarpeta y seleccione el idioma de los documentos que se cargarán en ella.
Es posible especificar la duración de validez de los enlaces que se proporcionan a los usuarios finales durante la interacción con un asistente.
Las opciones Metadatos y Habilitar extracción de imágenes pueden activarse más tarde.
Gestión de la subcarpeta
Haciendo doble clic en la subcarpeta se accede a su contenido.
En cada subcarpeta es posible aplicar los siguientes filtros:
- Estado, es decir, si el documento está indexado, en indexación o en error;
- Ordenación, es decir, por fecha de creación, modificación, nombre, número de páginas, tamaño y estado;
- Dirección de ordenación, es decir, ascendente o descendente;
También es posible realizar búsquedas de texto por:
- nombre del archivo
- URL de origen (ver también Smart Document Crawler)
Cargar documentos
Para cargar uno o más documentos, seleccione la opción Subir archivo.
Es posible cargar documentos en formato .pdf, .doc, .docx, .xlsx
Seleccione Examinar para ver los archivos de su dispositivo. También es posible cargar más de un archivo a la vez.
Al cargar más de un archivo a la vez, las opciones adicionales no están disponibles durante la carga. En cualquier caso, son accesibles una vez completada la indexación.
También es posible indicar:
- Nombre del archivo
- Versión
- URL de referencia
- Descripción
La URL de referencia es la página a la que se dirigirá a los usuarios que seleccionen el documento de la lista de fuentes utilizadas por un asistente para generar su respuesta.
Una vez cargado, el archivo aparecerá como Guardado. Luego pasará al estado Indexación en curso para terminar en Indexación completada.
Guardado > Indexación en curso > Indexación completada
Gestionar los documentos
Para cada documento es posible realizar las siguientes operaciones:
- Edición
- Sustitución
- Eliminación
Para modificar un documento, seleccione el documento y haga clic en Editar.
Las opciones seleccionables son las mismas que al cargar un archivo.
Para sustituir el archivo actual por uno nuevo, basta con seleccionar Examinar y cargar el nuevo archivo.
El archivo antiguo pasará al estado En eliminación y se eliminará definitivamente cuando el nuevo archivo haya completado la indexación.
Para eliminar un documento, seleccione el documento y haga clic en Eliminar seleccionados.
Es posible seleccionar más de un documento para eliminarlos. Para ello, seleccione la opción Selección múltiple y elija todos los documentos. Una vez elegidos, seleccione Eliminar seleccionados.
Visualizar un documento
Seleccionando la opción Abrir depuración es posible visualizar cómo el sistema ha indexado el documento seleccionado.
En la vista abierta, cada recuadro coloreado corresponde a un párrafo, es decir, un fragmento del documento que representa una información agrupada.
Configuración del asistente
Para conectar un asistente a la documentación de Smart Document Access es necesario acceder a la Configuración del asistente (ver Configuración del asistente) y luego a la sección SDA.
Antes de continuar, es útil comprender cómo el asistente consulta Smart Document Access.
Búsqueda y respuesta
Cuando un usuario hace una pregunta a un asistente conectado a Smart Document Access, se realiza una búsqueda dentro de la documentación y luego se genera una respuesta.
La fase de búsqueda puede realizarse en 3 modalidades: híbrida (recomendada), vectorial y semántica. El objetivo de la búsqueda es identificar los párrafos más relevantes respecto a la pregunta del usuario.
La fase de búsqueda de los documentos no utiliza la IA y no puede personalizarse.
Una vez identificados los párrafos, la IA los utiliza para generar una respuesta, siguiendo las instrucciones del prompt introducido; la IA utilizará también el contexto de la conversación para responder de la mejor manera.
1. Pregunta del usuario
El usuario hace una pregunta al asistente conectado a Smart Document Access.
2. Búsqueda en la documentación
Se realiza una búsqueda para identificar los párrafos más relevantes respecto a la pregunta del usuario.
3. Generación de la respuesta
La IA genera la respuesta usando los contenidos recuperados, el prompt y el contexto de la conversación.
Conectar las subcarpetas
A cada asistente es posible conectar una o más subcarpetas, siempre que formen parte de la misma carpeta.
Configuración de búsqueda
Seleccionando la opción Acrónimos se pueden introducir asociaciones de palabras para ayudar a Smart Document Access en la fase de búsqueda.
Por ejemplo, introduciendo “fijar” y “pedir” como acrónimos de “reservar”:
- Pregunta del usuario: ¿Cómo puedo pedir una cita?
- Pregunta utilizada para la búsqueda: ¿Cómo puedo pedir o reservar una cita?
La opción Número de párrafos por documento permite establecer el número máximo de párrafos que se pueden seleccionar para cada documento.
Un número bajo de párrafos puede acelerar los tiempos de respuesta, pero puede comprometer la relevancia de la respuesta. Un número de párrafos más alto puede mejorar la calidad de la respuesta, pero puede conllevar tiempos de respuesta más largos.
El Tipo de búsqueda permite seleccionar el tipo de búsqueda que realizará Smart Document Access:
- Vectorial: convierte preguntas e intents en representaciones matemáticas llamadas vectores. La similitud entre una pregunta y un intent se determina calculando la distancia entre sus vectores: cuanto más cercanos están, más relevante se considera la respuesta.
- Semántica: analiza la información semántica contenida en la pregunta del usuario y en los intents definidos, devolviendo la respuesta más pertinente. Se basa en la comprensión del significado de las palabras y de las frases, priorizando el contexto y las relaciones lingüísticas.
- Híbrida (recomendada): integra la búsqueda semántica y la vectorial, combinando sus puntos fuertes para proporcionar respuestas más precisas y completas.
Búsqueda proactiva
La búsqueda proactiva permite a la IA evaluar si la solicitud del usuario es ambigua y, en su caso, hacer una o más preguntas al usuario para aclarar su solicitud.
La solicitud del usuario podría considerarse ambigua en función de dos factores:
- la solicitud se refiere a varios documentos o párrafos de la documentación;
- el prompt de la búsqueda proactiva contiene instrucciones que consideran la solicitud ambigua.
Según la configuración habilitada, la IA seguirá haciendo preguntas al usuario hasta que su solicitud sea lo suficientemente clara.
Al habilitar la búsqueda proactiva, es posible acceder a su configuración.
El Tipo de búsqueda indica a la IA la granularidad de la búsqueda proactiva:
- Documento: es más probable que una solicitud se considere ambigua si la búsqueda encuentra información en documentos diferentes.
- Párrafo: es más probable que una solicitud se considere ambigua si la búsqueda encuentra información en párrafos diferentes.
- Cuerpo: es más probable que una solicitud se considere ambigua si la búsqueda encuentra información diferente dentro del mismo párrafo.
El Número máximo de preguntas establece el número máximo de preguntas que el asistente puede hacer al usuario antes de proporcionar una respuesta definitiva.
Las Instrucciones de ambigüedad permiten personalizar las instrucciones proporcionadas a la IA para evaluar si la solicitud del usuario es ambigua.
A continuación, un ejemplo de instrucciones estructuradas. Es posible adaptarlas al propio caso de uso, añadiendo o eliminando reglas en función de la documentación cargada.
La solicitud del usuario no es ambigua si:
- se refiere a una transferencia ya realizada o a una operación histórica;
- es una solicitud de contacto directo con un operador;
- se refiere a un mal funcionamiento genérico.
La solicitud del usuario es ambigua si:
- se refiere a "la tarjeta" sin especificar si es de crédito, débito o prepago;
- se refiere a "la cuenta" sin especificar si es corriente o de depósito;
- se refiere a "la transferencia" sin especificar si es SEPA, internacional o nacional;
- implica varios servicios a la vez (ej. tarjeta y cuenta);
- se refiere a "el tipo de interés" sin especificar el producto financiero de referencia.
Las Instrucciones de desambiguación permiten personalizar las instrucciones proporcionadas a la IA para generar la pregunta que se hará al usuario para aclarar su solicitud.
Cuando generes una pregunta de desambiguación:
- usa siempre un tono formal, dirigiéndote al usuario de "usted";
- no repitas información que el usuario ya haya proporcionado en su solicitud;
- si el usuario menciona "la tarjeta" sin especificar, pregunta: ¿crédito, débito o prepago?;
- si el usuario menciona "la cuenta" sin especificar, pregunta: ¿corriente o de depósito?;
- si el usuario menciona "la transferencia" sin especificar, pregunta: ¿SEPA, internacional o nacional?;
- si el usuario menciona "asistencia" de forma genérica, pregunta para qué servicio necesita ayuda.
Las instrucciones personalizadas son opcionales.
Si no se introducen instrucciones, se dejará plena autonomía a la IA para evaluar la ambigüedad y generar la pregunta.
La opción Mostrar la documentación utilizada después de cada pregunta habilitará la opción para visualizar los documentos utilizados para la generación de las preguntas.
Esta opción no tiene efecto si está activa la opción No mostrar la opción ‘Mostrar documentos’ después de la respuesta (ver Opciones de documentación).
La opción Generar una respuesta parcial antes de cada pregunta permite a la IA generar una respuesta parcial antes de generar la pregunta de desambiguación.
Por ejemplo, si la pregunta de desambiguación es “¿A qué tipo de tarjeta te refieres: crédito o débito?”, la respuesta parcial contendrá la información para ambos tipos de tarjeta.
Generación de la respuesta
Al activar la opción Utilizar AI Gen para generar las respuestas se habilita el editor del prompt de respuesta.
En el prompt se pueden introducir las instrucciones que la IA utilizará para generar la respuesta a la pregunta del usuario.
A continuación, un ejemplo de prompt estructurado. Es posible adaptarlo al propio caso de uso, modificando las reglas según las necesidades.
Eres un asistente virtual de [Nombre del Banco]. Tu tarea es responder de forma clara, precisa y completa basándote EXCLUSIVAMENTE en los contenidos de la documentación proporcionada.
## REGLAS DE LENGUAJE
- DEBES tratar SIEMPRE de usted al usuario.
- Tono: profesional, educado y claro.
- Las respuestas NUNCA deben ser genéricas; cada respuesta debe hacer referencia a la nomenclatura indicada en la documentación.
- Proporciona respuestas en lenguaje natural, evitando listas con viñetas.
## QUÉ DEBES HACER
- Si el usuario expresa dificultades, tranquilízalo proporcionando información útil con un lenguaje amable.
- Mantén los nombres de los menús y de las secciones exactamente como se indican en la documentación.
## QUÉ NO DEBES HACER
- No inventes información que no esté presente en la documentación.
- No des consejos sobre productos ni expreses preferencias.
- No utilices un lenguaje demasiado técnico o de difícil comprensión.
- No proporciones información sobre la existencia o el estado de cuentas corrientes.
## CASOS ESPECIALES
- Si el usuario pide hablar con un operador, indica que lo pones en contacto con un operador especializado.
- Si el usuario señala un mal funcionamiento genérico, responde con “Respuesta no encontrada”.
- Si la pregunta no está relacionada con los servicios ofrecidos, responde con “Respuesta no encontrada”.
La frase “Respuesta no encontrada” en el prompt es una instrucción técnica: cuando la IA la genera, Algho no utiliza Smart Document Access para esa respuesta y el sistema gestiona de forma autónoma la respuesta al usuario. El usuario no verá literalmente la frase “Respuesta no encontrada”.
No es necesario incluir instrucciones sobre cómo realizar la búsqueda, ya que estas no son personalizables (ver Búsqueda y respuesta)
Tokens y número de palabras
Usando el control deslizante Número máximo de tokens de entrada para AI Gen es posible establecer el número de tokens que se usarán como entrada para la IA.
Un valor más alto corresponde a más información enviada a AI Gen, que puede generar respuestas más precisas, pero puede conllevar tiempos de respuesta más largos.
Usando el control deslizante Longitud de la respuesta generada es posible establecer (de forma orientativa) el número máximo de palabras de la respuesta generada.
El número de palabras es un parámetro orientativo que la IA tendrá en cuenta, pero que podría no respetar al pie de la letra.
Opciones de documentación
En esta sección es posible configurar el uso y la visualización de la documentación.
La opción No mostrar la opción ‘Mostrar documentos’ después de la respuesta deshabilitará para los usuarios la opción de visualizar los documentos utilizados para generar la respuesta.
La opción Utilizar solo la documentación más relevante para generar la respuesta indica a la IA que muestre en Mostrar documentos solo los párrafos más relevantes utilizados para generar la respuesta.
Activar esta opción puede conllevar tiempos de respuesta más largos.
La opción Configuración avanzada para la vista previa de los documentos permite establecer con más precisión qué documentos pueden mostrarse en la lista Mostrar documentos.
Esta opción y No mostrar la opción ‘Mostrar documentos’ después de la respuesta son mutuamente excluyentes.
Por tanto, es posible elegir no mostrar los documentos procedentes de Smart Document Crawler o los documentos Estándar, es decir, los documentos cargados manualmente.
Opciones adicionales
En esta sección es posible establecer las funciones adicionales que se activan o desactivan después de la respuesta generada.
La opción Ocultar la documentación utilizada para generar la respuesta si hay un enlace ocultará la opción Mostrar documentos si la respuesta contiene un enlace como adjunto multimedia.
La opción Configuración avanzada para la visualización de los enlaces permite establecer con más precisión qué documentos pueden mostrarse en la lista Mostrar documentos en función del tipo de fuente del documento.
La opción Deshabilitar la navegación automática para los enlaces insertados en la respuesta permite desactivar la navegación automática si la respuesta generada presenta un enlace como elemento multimedia (ver Intent para más información sobre la navegación automática).
Inicio de Formularios e Intents
Las dos últimas opciones permiten configurar el inicio de un formulario o de un intent después de la respuesta generada.
Las dos opciones son mutuamente excluyentes.
Iniciar formulario establecido por AI Gen permite vincular uno o más formularios e indicar mediante prompt las condiciones en las que deben iniciarse.
A continuación, un ejemplo de estructura para los prompts de inicio de formulario. Cada bloque corresponde a un formulario vinculado; las condiciones determinan cuándo se propone ese formulario al usuario.
## Cuenta corriente
DEBES devolver este formulario SOLO y ÚNICAMENTE cuando TODAS estas
condiciones sean válidas:
- el usuario ha solicitado información relativa a la cuenta corriente;
- la respuesta del asistente confirma que puede proporcionar asistencia
sobre el tema.
NO DEBES devolver este formulario si la solicitud del usuario se refiere a
tarjetas, inversiones o préstamos.
## Tarjetas de pago
DEBES devolver este formulario SOLO y ÚNICAMENTE cuando TODAS estas
condiciones sean válidas:
- el usuario ha solicitado información relativa a tarjetas de pago;
- la respuesta del asistente confirma que puede proporcionar asistencia
sobre el tema.
NO DEBES devolver este formulario si la solicitud se refiere a cuentas,
inversiones o préstamos.
## Inversiones
DEBES devolver este formulario SOLO y ÚNICAMENTE cuando TODAS estas
condiciones sean válidas:
- el usuario ha solicitado información relativa a inversiones o
productos financieros;
- la respuesta del asistente confirma que puede proporcionar asistencia
sobre el tema.
NO DEBES devolver este formulario si la solicitud se refiere a cuentas o
tarjetas de pago.
Las frases “similar a...” presentes en los prompts se refieren al contenido de la respuesta generada por la IA, no a una comparación textual exacta. La IA evalúa si el significado de la respuesta corresponde al indicado.
Iniciar intent después de cada respuesta generada permite establecer un intent que debe iniciarse después de cada respuesta generada.
