Asistente de IA con tablas de MaviBot
Usando una función dedicada desarrollada por el equipo de MaviBot, tu chatbot de IA puede leer de forma inteligente los valores de una hoja de Google y almacenarlos en una variable del sistema dentro de la configuración de tu proyecto. Esto crea una fuente de datos sincronizada y dinámica para tu asistente.
Aplicaciones prácticas
Esta capacidad es esencial para escenarios como:
Asistente de catálogo de productos: una IA que asesora a los clientes sobre tu gama actual de productos, precios y disponibilidad en tiempo real.
Bot inteligente de promociones: un bot que promociona tus ofertas destacando dinámicamente características, especificaciones o ofertas obtenidas directamente de tu hoja.
Cómo preparar tu tabla para la integración
Para empezar, ve a la sección de hojas:
A continuación, verás el botón "Add sheet", que abre una ventana modal en la que debes introducir el nombre de la hoja:
Introduce el nombre de la hoja y haz clic en el botón "Done". Luego se creará una nueva hoja en el proyecto y aparecerá en la sección "Sheets":
Configuración de la hoja
Después de crear la hoja, debes añadir filas y columnas. Para hacerlo, busca el botón "Go to" en la tarjeta de la hoja deseada y haz clic en él.
Ves la siguiente configuración:
Para añadir una columna con un nombre, haz clic en el botón "+":
Cuando hagas clic en el botón, se abrirá una ventana modal donde podrás introducir un nombre para la nueva columna.
Después de introducir el nombre de la columna, haz clic en el botón "Done"; entonces la nueva columna se añadirá a la hoja. Añade el número necesario de columnas y luego filas.
Ahora, tu hoja se ve así.
Copia (recuerda) el ID de la hoja: para hacerlo, haz clic en la barra de direcciones:
A continuación, vamos a configurar los bloques en el constructor.
Trabajar en el constructor del chatbot
Función get_records_from_table()
Para usar la función get_info_from_table(), necesitas un bloque en el constructor del chatbot.
Ve a la pestaña correspondiente en Mavibot y crea un bloque con un disparador (bloque de inicio o bloque Trigger):
Define una variable (se utilizará para el conocimiento del asistente de IA): en este ejemplo, la variable es 'record'.
Ejemplo de código de la Calculadora
project.record = get_records_from_table(1)
project. - es un constructor para establecer una variable en la configuración del proyecto;record - nombre de la variable;get_records_from_table(1) - función, donde el parámetro se pasa como ID de la tabla.
Lee más sobre la función get_record_from_table()
get_records_from_table(table_id, start_row, count, start_col, end_col) – para obtener registros de una tabla
! table_id
ID de la tabla (parámetro obligatorio)
start_row
parámetro opcional, entero. Especifica la fila inicial del rango
acepta el número de fila desde el cual comenzar a leer los valores de la tabla, inclusive. Debe especificarse sin comillas
count
parámetro opcional, entero. Especifica el número de filas a recuperar
valor predeterminado: 1000. Máximo: 5000. Debe especificarse sin comillas
start_col
parámetro opcional, cadena. Especifica la columna inicial del rango
acepta el nombre de la columna desde la cual comenzar a leer los valores de la tabla, inclusive. Debe especificarse entre comillas
end_col
parámetro opcional, cadena. Especifica la columna final del rango
acepta el nombre de la columna hasta la cual leer los valores de la tabla, inclusive. Debe especificarse entre comillas
Para leer todos los datos desde un cierto punto: Especifica solo el inicio del rango. Para leer todos los datos hasta un cierto punto: Especifica solo el fin del rango.
En lugar de #{none}, escribiremos nuestra variable en el mensaje usando la construcción #{} para ver visualmente qué datos se han escrito en la variable del proyecto.
Atención
La variable insertada en el mensaje sirve para comprobar si el bot lee correctamente la función. Cuando ejecutes el bloque en modo de prueba, el bot mostrará los valores que se asignarán a la variable.
Tenga en cuenta
Después de configurar la llamada del bloque en modo de prueba y guardar la variable en la configuración del proyecto, no elimines este bloque.
Puede que lo necesites: por ejemplo, si has añadido más valores a la tabla, simplemente ejecuta el bloque en modo de prueba. Entonces los datos de la variable del proyecto se actualizarán.
El nombre de la variable puede ser cualquier nombre que te guste.
Bloque de transferencia de datos
A continuación, crearemos un bloque "Chat" para transferir datos a la tarjeta del cliente.
"Este bloque también puede transmitir un mensaje de cierre del bot, como: '¡Estoy pasando la información al gerente! El gerente se pondrá en contacto en 10 minutos.'"
A continuación, copia el ID del bloque. Lo necesitarás para configurar el asistente de IA en el comando "start_block_from_ai 11956" y el comando de prueba "Block call 11956", donde en lugar del ID del bloque del ejemplo, debes insertar tu ID de bloque.
Tenga en cuenta
Después de probar, reemplaza "Block call 31241050" con el comando "start_block_from_ai 31241050".
El comando "Block call 31241050" es de depuración y ayuda a entender qué datos está registrando el bot (ver la sección "Testing").
Para lanzar el bot para los clientes, especifica el comando "start_block_from_ai 31241050".
Lectura de una tabla
Navega al modo de prueba del bot .
Lanza el bloque que contiene el disparador para leer los datos de la tabla.
El bloque ha funcionado correctamente. Puedes verlo confirmado por los valores ahora almacenados en la variable correspondiente dentro de la configuración de tu proyecto.
Para verificar manualmente:
Ve a la pestaña Configuración del proyecto sección.
Localiza la variable para ver sus datos actuales.
En la pestaña "Variables" de la configuración del proyecto, verás tu variable con los valores añadidos desde la tabla. Así que ahora, dentro de tu proyecto, hay una variable con bienes, costo y todo lo que especificaste en la tabla.
Trabajar en el asistente de IA
Ve a la sección "AI assistant" y inicia el chatbot con configuración de IA.
Debes elegir el rol "Sales assistant":
También estableceremos ajustes adicionales:
Configuración del asistente de IA
En la configuración del bot escribe los siguientes datos:
La posición y las instrucciones para el bot.
El comando para llamar al bloque y transferir variables al sistema se escribe de la siguiente manera:
"Si todo es correcto, ejecuta el comando "start_block_from_ai 11956", donde en lugar de N se escribe el ID del bloque con el mensaje final: el bloque Chat transmite datos a la tarjeta del cliente:
Conocimiento del bot
En el campo "Bot Knowledge", pasa la variable que se almacenó previamente como un bloque con el disparador.
Conocimiento del bot.
De esta manera, el bot tomará la información de una variable en la configuración del proyecto y asesorará a tus clientes sobre la gama de productos disponible.
Formato de datos
En el formato de los datos transmitidos, tú mismo especificas los datos que estás recopilando (por ejemplo, un producto), luego introduces la frase con la "key" y asignas un valor a la clave.
el nombre del cliente con la clave client_name, el número de teléfono del cliente con la clave phone_number, la ciudad y la dirección con la clave city_address, el producto elegido con la clave product, la cantidad de producto con la clave quantity, el importe total del pedido con la clave total_amount.
Así, cuando se llame al bloque, las variables se transferirán a la tarjeta del cliente: luego podrás trabajar con las variables, por ejemplo, en el constructor del chatbot:
En esta etapa, la configuración del asistente de IA está completa.
Los parámetros restantes se pueden establecer a tu discreción:
Prueba de un bot
"Si ya tienes bots en ejecución, especifica en la condición de inicio del asistente de IA que se inicie solo en la ventana de prueba."
Paso 1. Haz clic en el constructor de disparadores
Paso 2. Selecciona la pestaña con la ventana de prueba y haz clic en "Add trigger":
Ahora, en la condición del disparador, verás el siguiente valor:
De esta manera, el bot se ejecutará solo en la ventana de prueba y en ningún otro lugar.
Después de depurar el bot, elimina esta condición.
Este mensaje se está enviando en modo de prueba debido al comando "Block call 3124105
Después de probar y depurar el bot, escribe el comando en la configuración del bot "start_block_from_ai 31241050".
Este enfoque te permite crear cualquier tipo de tienda en línea y aprovechar cualquier valor de datos almacenados dentro de tu tabla.
El único límite real es tu imaginación.
Última actualización