...
Nombre: Es el nombre del nodo.
Descripción: Es la descripción y/o objetivo del nodo dentro del flujo.
Intención: Es la intención específica del cliente final al ingresar en el nodo. Es recomendable que las intenciones de cada uno de los nodos sean únicas y diferentes, ya que este valor servirá para sacar estadísticas y analizar las conversaciones del bot.
Patrón: Es el patrón o regla regular que debe coincidir con los mensajes entrantes enviados por tu cliente para que el bot ejecute la lógica del nodo. Este patrón puede ser una cadena de texto exacta (por ejemplo, si el patrón dado el “Hola”, la lógica del nodo de ejecutará cuando el cliente escriba “Hola”, o una expresión regular que abarque varias opciones. Más información sobre expresiones regulares y patrones aquí: https://mzl.la/3jecVOJ
Banderas de Expresión Regular: Son opciones que puedes agregar para cambiar el comportamiento de una búsqueda o coincidencia de texto de la expresión regular configurada en el campo “Patrón”. Cada bandera tiene un propósito específico y se usa para adaptar la búsqueda a situaciones particulares:
multi line: Esta bandera permite que los caracteres especiales que indican el inicio (^) y el final ($) de un texto funcionen en cada línea de un texto, no solo al inicio o al final del texto completo. Por ejemplo, si buscas "hola" al inicio de una línea, funcionará en cada línea, no solo al principio del texto.insensitive: Esta bandera permite que la búsqueda ignore si las letras están en mayúsculas o minúsculas. La coincidencia será la misma sin importar cómo estén escritas las palabras. Por ejemplo, si buscas "hola", también coincidirá con "Hola", "HOLA" o "hoLa".extended: Esta bandera permite escribir más claro tu patrón de búsqueda añadiendo espacios y comentarios sin que afecte a la búsqueda. Los espacios extra no importarán, lo que facilita leer patrones complejos. Por ejemplo, puedes separar visualmente las partes de tu patrón de búsqueda y agregar notas para que sea más fácil de entender.single line: Esta bandera permite que el punto (.), que normalmente significa "cualquier cosa menos un salto de línea", también coincida con los saltos de línea (\n). Esto hace que tu patrón vea el texto como una sola línea grande, aunque tenga saltos de línea. Por ejemplo, si buscas "a.b", con esta opción también coincidirá con algo como "a\nb" (donde hay un salto de línea entre "a" y "b").unicode: Esta bandera permite que tu patrón funcione con caracteres de otros idiomas o símbolos especiales que usan Unicode, no solo con letras en inglés. Esto es útil cuando trabajas con texto en diferentes idiomas. Por ejemplo, tu patrón podrá coincidir con caracteres en chino, árabe o acentos en español, por ejemplo.ungreedy: Esta bandera permite cambiar el comportamiento de la búsqueda para que sea menos ambiciosa. En lugar de intentar coincidir con la mayor cantidad de texto posible, intentará coincidir con la menor cantidad de texto posible. Por ejemplo, si buscas entre dos letras, en lugar de capturar toda la frase entre ellas, capturará el trozo más corto posible.anchored: Esta bandera permite que tu búsqueda solo funcione al inicio del texto. No buscará coincidencias en el medio o final del texto, solo al principio. Por ejemplo,si buscas una palabra, solo la encontrará si está justo al principio del texto.jchanged: Esta bandera permite utilizar el mismo símbolo que utilizas para delimitar tu expresión regular (como/o#) dentro de tu patrón, sin que cause problemas. Por ejemplo, si estás buscando algo que incluye el mismo símbolo que delimita tu búsqueda, esta opción lo permite sin errores.dollar and only: Esta bandera permite cambiar el funcionamiento del signo de dólar ($), que normalmente indica el final de una línea o el texto. Con esta opción, el$solo coincidirá si está justo al final del texto, no en el final de una línea con un salto de línea. Por ejemplo, si buscas algo al final del texto, solo funcionará si realmente está al final del todo, no solo al final de una línea.
Tipo de Nodo: Es el tipo de nodo y debe ser seleccionado de acuerdo a la finalidad del mismo (dar un mensaje al cliente, preguntar información al cliente, consultar un servicio web externo, etc.). Los tipos de nodo disponibles son (encuentra la descripción detallada de cada tipo de nodo más abajo):
Preguntar
Decir
Capturar: Al seleccionar este tipo de nodo, los siguientes campos adicionales se desplegarán en el formulario:
Esperado: Digita aquí una expresión regular para validar la respuesta enviada por el cliente.
Lista: Al seleccionar este tipo de nodo, los siguientes campos adicionales se desplegarán en el formulario:
Lista: Especifica aquí la lista de valores que sean mostrados al cliente para su selección. En caso de que los casos provengan de un nodo anterior de tipo Web Service, utiliza la nomenclatura {{webhook.response}}.
Fallback: Al seleccionar este tipo de nodo, los siguientes campos adicionales se desplegarán en el formulario:
Bot: Selecciona aquí el bot al cual se moverá la conversación en caso de exceder los intentos máximos.
Nodo del Bot: Selecciona aquí el nodo del bot al cual se moverá la conversación en caso de exceder los intentos máximos.
Intentos Máximos: Especifica aquí el máximo de intentos que tendrá el cliente para reintentar el paso anterior a este nodo.
Nodo Programado: Al seleccionar este tipo de nodo, los siguientes campos adicionales se desplegarán en el formulario:
Fecha Inicial: Especifica aquí la fecha de inicio del periodo/rango durante el cual se aplicara este nodo.
Fecha Final: Especifica aquí la fecha de fin del periodo/rango durante el cual se aplicara este nodo.
Validador: Al seleccionar este tipo de nodo, los siguientes campos adicionales se desplegarán en el formulario:
Tipo de Condición: Especifica aquí si las reglas de validación se aplicarán con el condicional y (or - todas las reglas de cumplen) ó con el condicionar o (or - alguna de las reglas de cumple).
Reglas de Validación: Agrega una o más reglas de validación, especificando una variable, un operador, y un valor.
Web Service: Al seleccionar este tipo de nodo, los siguientes campos adicionales se desplegarán en el formulario:
Tipo de Petición: Selecciona uno de los tipo de petición HTTP disponibles (GET, HEAD, POST, PUT, DELETE, CONNECT, OPTONS, TRACE, PATCH).
URL/ Endpoint / IP: Especifica aquí la URL / endpoint / dirección IP de acceso al webservice. Por ejemplo, https://mywebservice.mybusiness.com/getCustomerInfo/4224563
Headers: Especifica aquí los headers que deberán ser agregados a la petición HTTP para consumir el web service. Pr ejemplo, { “Authorization”: “AccessKey GoCsdWE5rR2x7oXTQ4cPn4fTb5R”}.
Body: Especifica aquí el body o cuerpo de la petición HTTP. Generalmente, este cuerpo deberá tener una estructura en JSON. Por ejemplo, {“nombre“: “Jane”, “apellido”: “Doe}.
Tiempo de Espera: Especifica aquí el tiempo máximo de espera que tendrá Sagicc al consumir el web service. Al exceder ese tiempo, se considerará fallida la petición.
Dialog Flow
Ir a
Bot: Selecciona aquí el bot al cual se moverá la conversación.
Nodo del Bot: Selecciona aquí el nodo del bot al cual se moverá la conversación.
Gen AI: Al seleccionar este tipo de nodo, los siguientes campos adicionales se desplegarán en el formulario:
Prompt: Redacta aquí el prompt que se utilizará para dar instrucciones al agente de IA, asegurándote de incluir el tono de comunicación, el contexto, las expectativas, y otros detalles relevantes que guíen su comportamiento de manera efectiva. Recuerda que el éxito en la implementación de un bot con un agente impulsado por Inteligencia Artificial Generativa depende en gran medida de la calidad del prompt proporcionado. Encuentra más información sobre Inteligencia Artificial Generativa aquí: https://aws.amazon.com/es/what-is/generative-ai/. Encuentra más información sobre Ingeniería de Prompts aquí: https://aws.amazon.com/es/what-is/prompt-engineering/
Habilitar tecnología RAG: Selecciona esta opción si deseas habilitar la tecnología RAG (Generación Mejorada por Recuperación) en el nodo Gen AI. Esta tecnología le permitirá al nodo acceder a los artículos de la Base de Conocimiento de Sagicc para generar respuestas más precisas y contextualmente relevantes. Encuentra más información sobre la tecnología RAG aquí: https://aws.amazon.com/es/what-is/retrieval-augmented-generation/
Categorías de la Base de Conocimiento para RAG: En caso de habilitar la tecnología RAG para el nodo, selecciona en este campo las categorías de la Base de Conocimiento de Sagicc que contienen los artículos con información que será relevante para el Agente de IA.
...