Usando una función dedicada desarrollada por el equipo de MaviBot, tu chatbot de IA puede leer inteligentemente 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 de promociones inteligente: un bot que promociona tus ofertas destacando dinámicamente características, especificaciones u ofertas extraídas directamente de tu hoja.
Cómo preparar tu tabla para la integración
Para comenzar, ve a la sección de hojas:
A continuación, verás el botón "Añadir hoja", que abre una ventana modal en la que debes ingresar el nombre de la hoja:
Ingresa el nombre de la hoja y haz clic en el botón "Hecho". Luego se creará una nueva hoja en el proyecto y aparecerá en la sección "Hojas":
Configuración de la hoja
Después de crear la hoja, debes agregar filas y columnas. Para ello, busca el botón "Ir a" en la tarjeta de la hoja deseada y haz clic en él.
Verás la siguiente configuración:
Para agregar una columna con un nombre, haz clic en el botón "+":
Al hacer clic en el botón, se abrirá una ventana modal donde podrás ingresar un nombre para la nueva columna.
Después de ingresar el nombre de la columna, haz clic en el botón "Hecho", luego la nueva columna se agregará a la hoja. Agrega la cantidad necesaria de columnas y luego filas.
Ahora, tu hoja se ve así.
Copia (recuerda) el ID de la hoja: para ello, haz clic en la barra de direcciones:
A continuación, pasemos a configurar los bloques en el constructor.
Trabajando 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 de disparador):
Define una variable (se usará 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 tabla.
get_records_from_table(table_id, start_row, count, start_col, end_col) – para obtener registros de una tabla
| Parámetro | Descripción | Nota |
|---|---|---|
| ! table_id | ID de tabla (parámetro requerido) | |
| 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 punto determinado: Especifica solo el inicio del rango. Para leer todos los datos hasta un punto determinado: Especifica solo el final 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 incrustada en el mensaje es necesaria para verificar si el bot lee la función correctamente. Cuando ejecutes el bloque en modo de prueba, el bot mostrará los valores que se asignarán a la variable.
Ten en cuenta
Después de configurar la llamada al 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 agregado más valores a la tabla, simplemente inicia el bloque en modo de prueba. Entonces los datos en 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 comunicará 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 de bloque del ejemplo, debes insertar tu ID de bloque.
Ten en cuenta
Después de las pruebas, 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 (consulta la sección "Pruebas").
Para iniciar el bot para los clientes, especifica el comando "start_block_from_ai 31241050".
Leyendo una tabla
- Navega al modo de prueba del bot.
- Inicia el bloque que contiene el disparador para leer los datos de la tabla.
El bloque ha funcionado correctamente. Puedes ver esto confirmado por los valores ahora almacenados en la variable correspondiente dentro de la configuración de tu proyecto.
Para verificar manualmente:
- Ve a la sección Configuración del proyecto.
- Localiza la variable para ver sus datos actuales.
En la pestaña "Variables" en la configuración del proyecto, verás tu variable con los valores agregados de la tabla. Así que ahora, dentro de tu proyecto, hay una variable con productos, costo y todo lo que especificaste en la tabla.
Trabajando en el asistente de IA
Ve a la sección "Asistente de IA" e inicia el chatbot con la configuración de IA.
Debes elegir el rol "Asistente de ventas":
También estableceremos configuraciones adicionales:
Configuración del asistente de IA
En la configuración del bot, escribe los siguientes datos:
- La posición e 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 "Conocimiento del bot", pasa la variable que se almacenó en caché anteriormente como un bloque con el disparador.
Conocimiento del bot.
De esta manera, el bot tomará 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, especificas los datos que estás recopilando tú mismo (por ejemplo, un producto), luego ingresas la frase con la "clave" y asignas un valor a la clave.
el nombre del cliente con clave client_name, el número de teléfono del cliente con clave phone_number, la ciudad y la dirección con clave city_address, el producto elegido con clave product, la cantidad de producto con clave quantity, el monto total del pedido con clave total_amount.
De esta manera, al llamar al bloque, se pasarán variables a la tarjeta del cliente: luego puedes 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 criterio:
Probando 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 "Agregar disparador":
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 envía en modo de prueba debido al comando "Block call 3124105](/docs/chatbot-ai-assistant#data-transfer-format)
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 construir cualquier tipo de tienda en línea y aprovechar cualquier valor de datos almacenado en tu tabla.
El único límite real es tu imaginación.