# Google Sheets para el asistente de IA Gracias a una función desarrollada por el equipo de Mavibot, el chatbot de IA interpreta con precisión los valores introducidos en la hoja y luego los guarda en una variable del sistema en la configuración del proyecto. Por ejemplo, puede que necesites esto para un asistente de IA que asesorará a tus clientes sobre la gama de productos disponibles en tu tienda en línea, así como para promocionar tus capacidades con un bot inteligente. Exactamente cómo usar un bot para leer una hoja de Google depende de ti, y nosotros, a su vez, te mostraremos cómo crear una hoja y configurar el bot para que trabaje con ella. ## Preparación de la hoja de Google ### Creación y relleno Abre el editor de la hoja:
Debes completar las filas con las categorías de columnas:
Dado que la IA puede leer datos, usará la función para escribir valores de la hoja en una variable en la configuración del proyecto, por lo que recomendamos añadir nombres concisos y comprensibles para las categorías de columnas para tu comodidad y para entender la lógica del bot. A continuación, especifica los nombres necesarios en las columnas:
Veamos la categoría de columna "Unidad de medida":
La unidad de medida puede incluir: 1. Un indicador cuantitativo en forma de piezas/unidades (una unidad de producto, dos unidades de producto, una pieza, etc.):
2. Unidades de medida de magnitudes: litros, kilogramos, gramos, metros:
{% hint style="success" %} El bot entenderá perfectamente lo que quisiste decir y usará los valores insertados en los campos. {% endhint %} El paso final para completar la hoja de Google será introducir el precio por unidad de medida.
En esta etapa, la hoja de Google está completa. ### Configuración de acceso Para que el bot de IA pueda tomar valores de la hoja, debes abrir la configuración de acceso:
Haz clic en configuración y se abrirá la siguiente ventana:
Aquí debes cambiar la configuración de "El acceso está restringido" a "Cualquiera que tenga el enlace":
### ID de la hoja Para trabajar con la función get\_info\_from\_table(!sheet\_id, number\_sheet, sheet\_json\_keys), necesitaremos el ID de la hoja, ya que la función toma sheet\_id como parámetro obligatorio. Para obtener el ID, solo haz clic en la barra de direcciones:
Verás una línea con la dirección de la página:
De la cual necesitaremos un conjunto de símbolos y letras, que es simplemente el ID de la hoja:
Con esto se completa el trabajo con la hoja y su configuración. ## Trabajo en el constructor de embudos ### Uso de la función get\_info\_from\_table() Para usar la función get\_info\_from\_table(), necesitarás un bloque en el constructor de embudos. Ve a la pestaña correspondiente en Mavibot y crea un bloque principal de verificación de condición:
En lugar de #{none}, escribiremos en el mensaje una notificación para el modo de prueba después de iniciar este bloque y una variable incrustada mediante la construcción #{}:
{% hint style="warning" %} ¡Atención! La variable incrustada en el mensaje es necesaria para verificar que el bot está leyendo la función. Al ejecutar el bloque en modo de prueba, el bot mostrará los valores que estarán anidados en la variable. {% endhint %} {% hint style="success" %} ¡Atención! 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 en la variable del proyecto se actualizarán. {% endhint %} {% hint style="info" %} El nombre de la variable puede ser cualquier nombre que te convenga. {% endhint %} A continuación, necesitamos la función get\_info\_from\_table(sheet\_id, number\_sheet, sheet\_json\_keys), una función diseñada para leer datos de una tabla.
parámetrosdescripción
! sheet_idid de la hoja de Google
number_sheetNúmero de hoja en la tabla; por defecto = 1
sheet_json_keys Parámetro opcional, clave de acceso a los datos de la tabla
Abre la calculadora e introduce el ID de la tabla, encerrándolo en una variable (por ejemplo, sheet):
A continuación, asigna la variable especificada en el mensaje del bloque y asígnale un valor en forma de la función get\_info\_from\_table() con el parámetro requerido sheet\_id (en lugar del cual inserta la variable sheet, donde está el ID de la tabla):
**¡Atención!** Antes de la variable product\_pay\_info en la calculadora, escribe project. Esto es necesario para que la VARIABLE y los VALORES de la tabla se introduzcan en la configuración del proyecto (en caché):
Ahora escribe cualquier palabra/número en la condición del bloque:
### Bloque de transmisión de datos A continuación, crea un segundo bloque de Estado:
Este bloque de Estado será necesario para transferir variables a la tarjeta del cliente. También puedes enviar un mensaje final del bot en este bloque, por ejemplo: "¡Gracias por tu pedido! ¡Estoy enviando los datos al gestor de comunicaciones!":
A continuación, copia el ID del bloque; lo necesitarás para configurar el asistente de IA en el comando "start\_block\_from\_ai 31241050", donde en lugar del ID del ejemplo, debes insertar el ID de tu bloque. ### Lectura de la hoja Ahora inicia el bloque en la versión de prueba para que el chatbot lea los valores de la hoja y los coloque en tu variable en la configuración del proyecto:
Así, el bloque funcionó correctamente: ves los valores que leíste y que están en la variable en la configuración del proyecto. Puedes verificarlo yendo a la sección correspondiente:
A continuación, verás tu variable con los valores incrustados en ella desde la tabla:
Así que ahora, dentro de tu proyecto, hay una variable con productos, costos y todo lo que especificaste en la hoja. ## Trabajar como asistente de IA Ve a la sección "Asistente de IA" y comienza a configurar la inteligencia artificial. Rol del asistente: vendedor
También configuraremos las opciones "Botones" y "Entrada de datos paso a paso":
Necesitaremos botones para respuestas diseñadas visualmente por el bot, así como para la comodidad del cliente (así tu usuario no necesita introducir manualmente palabras en el diálogo); la entrada de datos paso a paso es para que el bot sondee el pedido que se está generando. ### Configuración del asistente de IA En la configuración del bot escribimos los siguientes datos: 1. La posición y las instrucciones para el bot. Ejemplo: \. **Presta atención** a la línea "Calcular el costo total del producto, igual a la unidad del producto multiplicada por el costo" - esta línea mostrará el resultado final del costo de todas las categorías seleccionadas por el cliente: Ejemplo: El cliente seleccionó tres kg de un producto. El bot, a su vez, calcula el costo total:
2. El comando para llamar al bloque y transferir variables al sistema se escribe de la siguiente manera: \, donde en lugar de N se escribe el ID del bloque con el mensaje final: el bloque de Estado transfiere datos a la tarjeta del cliente:
Los comandos en la configuración del asistente de IA se ven así:
### Conocimiento del bot En el campo "Bot Knowledge", pasa la variable que fue almacenada previamente en caché por el bloque de Verificación principal de la condición:
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, indicas los datos que recopilas tú mismo (por ejemplo, un producto), luego introduces la frase con la "clave" y asignas un valor a la clave:
#### Explicación Línea 1: "El formato de los datos transmitidos: producto con la clave product, unidad de medida con la clave thing, precio con la clave count, el costo total de todos los productos seleccionados con la clave result" - deja claro al bot qué datos y con qué valor deben transmitirse al sistema. Estas variables se mostrarán en la tarjeta del cliente:
2. Si necesitas que cada producto seleccionado por el cliente se muestre por separado, añade una segunda línea: "Si el cliente ha seleccionado varios productos, entonces añade el primer producto con la clave product1, el segundo producto con la clave product2, el tercer producto con la clave product3, y así sucesivamente". Con esto concluye la configuración del asistente de IA. Los parámetros restantes se pueden establecer a tu discreción:
## Prueba del bot Usa el constructor de condiciones para añadir el funcionamiento del bot en la ventana de prueba: Paso 1. Haz clic en el constructor de condiciones
Paso 2. Selecciona la pestaña con el cuadro de texto y haz clic en "Añadir":
Ahora, en la condición de inicio, ves el siguiente valor:
{% hint style="info" %} De este modo, el bot se iniciará solo en la ventana de prueba y en ningún otro lugar. Después de depurar el bot, elimina esta condición. {% endhint %} Ahora probemos el bot: 1. Hagamos una pregunta de seguridad al bot sobre la gama de productos:
El bot mostró una variedad de productos que se introdujeron en la hoja de Google, capturando valores de una variable contenida en la configuración del proyecto. 2. A continuación, seleccionaremos el producto y hablaremos con el bot inteligente:
3. Elijamos otro producto:
El bot también se muestra correctamente, mostrando al cliente las categorías de productos para su posterior selección. 4. El cliente seleccionó varios productos y eligió su cantidad:
El bot calculó el costo de los artículos seleccionados y calculó el costo total. 5. Enviando los datos al sistema:
Resultado: después de que el bot duplicó el pedido y el cliente respondió que el pedido era correcto, el chatbot, según la configuración, llamó al bloque "Estado del diálogo":
Después de eso, los datos generados por el bot en el diálogo con el cliente se enviaron a la tarjeta del cliente:
El bot resolvió todo correctamente. {% hint style="success" %} De esta manera puedes crear una tienda en línea de cualquier tipo y usar cualquier valor necesario dentro de la tabla. ¡La principal limitación es solo tu imaginación! {% endhint %} ## Guía en video {% embed url="" %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/es/chatbot/ai/google-sheets-para-el-asistente-de-ia.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.