[Extensión] Cómo usar la extensión Google Gemini en Blip

1. Introducción

2. Funcionalidades

3. Instalación y configuración

4. Usar Gemini en el flujo de Builder

5. Ejemplos de uso

6. Soporte

Descripción breve: Conecta los modelos de inteligencia artificial de Google Gemini a tu chatbot en Blip y genera respuestas automáticas con base en tus instrucciones y en tu propia base de conocimiento.

Introducción

La extensión Google Gemini incorpora los modelos de IA de Google a los flujos de tu chatbot en Blip. Configuras la clave de API, eliges el modelo y defines cómo debe comportarse el asistente, y Gemini comienza a generar las respuestas dentro del flujo de Builder.

Por ejemplo, un cliente pregunta por WhatsApp cuál es el plazo de entrega de un producto. El bloque de Gemini recibe el mensaje, consulta los documentos que registraste en la base de conocimiento y devuelve una respuesta en lenguaje natural, que el flujo envía de vuelta al cliente.

Funcionalidades

• Generación de respuestas con la IA de Google (Gemini) dentro del flujo de Builder.

• Elige entre los modelos Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash-Lite, Gemini 3 Flash y Gemini 3 Pro.

• Base de conocimiento: envía documentos (PDF, TXT, CSV, Markdown, HTML, XML, RTF, JavaScript, Python y CSS) para que Gemini responda con base en ellos.

• Instrucciones del asistente para definir el rol, el alcance y el tono de las respuestas.

• Control de temperatura y límite de tokens por llamada.

• Configuración de seguridad por categoría (acoso, discurso de odio, contenido sexualmente explícito y material peligroso), con cuatro niveles de bloqueo.

• Almacenamiento de la respuesta en una variable para usarla en el resto del flujo.

Compatible con los siguientes canales: todos los canales disponibles en la plataforma Blip.

Requisitos previos

• Acceso al bot en Blip con permiso para instalar extensiones.

• Una cuenta de Google con acceso a Google AI Studio.

• Una clave de API válida de Gemini.

Instalación y configuración

Instalar la extensión en el bot

Instala la extensión en el bot que contiene el flujo en el que Gemini generará las respuestas (el bot de atención), y no en el Router.

1. Accede al bot deseado en Blip.

2. Abre la Blip Store y localiza la extensión Google Gemini, o busca Google Gemini en el buscador de la tienda.

3. Selecciona la extensión y haz clic en Instalar.

4. Elige el bot en el que se usará la extensión.

Después de instalarla, abre la página de la extensión para iniciar la configuración. En el menú del bot, haz clic en los tres puntos y localiza la extensión Google Gemini.

Crear una clave de API en Google AI Studio

La extensión usa la API de Gemini, por lo que necesitas una clave de API de Google. En la página de la extensión, debajo del campo Clave de API, el enlace en Disponible aquí abre la página de claves de Google AI Studio.

1. Accede a Google AI Studio.

2. Abre el área de claves de API y haz clic en Create API Key.

3. Selecciona o importa un proyecto de Google Cloud y confirma. Se generará la clave.

4. Copia la clave y guárdala en un lugar seguro.

Si usas una cuenta de Google Workspace (cuenta empresarial), es posible que debas solicitar al administrador de la organización los permisos para acceder a Google AI Studio y crear la clave. Google mantiene una guía específica para habilitar Gemini en la empresa.

Atención: no compartas la clave en documentos, capturas de pantalla, tickets o canales públicos. Si una clave queda expuesta, genera una nueva en Google AI Studio y reemplaza la anterior.

Configurar el modelo y la seguridad

Regresa a Blip y abre la extensión Google Gemini, en la pestaña Configuración de IA.

1. En Modelo, selecciona el modelo de Gemini que usará el asistente. Cada modelo tiene sus propios costos y límites, definidos por el plan de tu cuenta de Google.

2. Pega la clave generada en Google AI Studio en el campo Clave de API.

3. En la sección Seguridad, ajusta el nivel de bloqueo de cada categoría. Los niveles más altos bloquean más respuestas, incluidas algunas inofensivas. Mantén los valores predeterminados si no existe una regla específica para tu operación.

4. Haz clic en Guardar. La extensión prueba la clave antes de guardarla. Si la clave no es válida, muestra una alerta de error en lugar de completar el proceso.

Agregar una base de conocimiento

La base de conocimiento proporciona información específica para que Gemini responda con precisión. Abre la pestaña Base de conocimiento.

1. En Documentos, arrastra o selecciona el archivo que quieres enviar. Los formatos aceptados son PDF, TXT, CSV, Markdown, HTML, XML, RTF, JavaScript, Python y CSS.

2. Haz clic en Cargar nuevo archivo. El archivo aparecerá en la lista Archivos.

3. Para eliminar un documento, haz clic en el botón de la papelera que aparece junto a él.

Usa documentos objetivos y actualizados. Evita versiones duplicadas o información contradictoria, porque confunden las respuestas. La base de conocimiento complementa las instrucciones del asistente, pero no sustituye una definición clara del comportamiento.

Usar Gemini en el flujo de Builder

Instalar la extensión de Builder en Chrome

Para agregar Gemini al flujo, necesitas la extensión de Builder en Google Chrome. Abre la pestaña Integrar en Builder en la página de la extensión y haz clic en Instalar extensión para finalizar la instalación en Chrome Web Store.

Agregar el bloque de integración al flujo

1. En Builder, abre el punto del flujo en el que Gemini debe generar la respuesta.

2. Haz clic en el ícono para agregar un bloque. Con la extensión de Chrome instalada, aparecerá la opción de agregar un bloque de integración.

3. Abre la pestaña de integración y selecciona la integración de Google Gemini.

Configura los campos del bloque:

• Variable de entrada: la variable del flujo que contiene el mensaje del usuario. El valor predeterminado es input.content.

• Instrucciones: el comportamiento del asistente (consulta la siguiente sección).

• Temperatura: un valor de 0 a 1 que controla la creatividad de la respuesta.

• Límite de tokens: la cantidad máxima de tokens de la respuesta, de 1 a 8192 (1 token equivale aproximadamente a 3 letras). El valor predeterminado es bajo, así que auméntalo si las respuestas necesitan ser más largas.

• Variable de resultado (en Guardar respuesta): la variable en la que se almacenará la respuesta de Gemini.

El modelo y las configuraciones de seguridad provienen de la pestaña Configuración de IA en la página de la extensión, no del bloque.

Definir las instrucciones del asistente

Las instrucciones le indican a Gemini cómo comportarse. Escribe claramente cuál es el rol del asistente, qué temas puede responder, cuáles debe rechazar, qué tono debe usar y qué hacer cuando no encuentre la información. Evita instrucciones genéricas como "responde todo" y orienta al modelo para que no invente datos. Si la API de Gemini devuelve un error, la extensión devuelve una respuesta predeterminada ("No sé hablar sobre ese tema.") y registra el error en el registro.

Guardar la respuesta en una variable

Define un nombre en la Variable de resultado del bloque, por ejemplo geminiResponse. Después de ejecutar la integración, usa esta variable en un bloque de contenido:

{{geminiResponse}}

Confirma que el nombre usado en el bloque de contenido sea exactamente igual al definido en la integración.

Probar el flujo

Antes de publicar, ejecuta el bot en modo de prueba y valida su comportamiento:

1. Envía una pregunta dentro del alcance de las instrucciones y confirma que la respuesta se haya almacenado en la variable.

2. Envía preguntas fuera del alcance y verifica que el asistente rechace responder como lo definiste.

3. Haz preguntas cubiertas por los archivos de la base de conocimiento y revisa las respuestas.

4. Prueba el caso en el que la información no existe.

Ejemplos de uso

Una instrucción clara define al asistente. Por ejemplo:

Eres un asistente virtual responsable de responder preguntas sobre los productos y servicios de la empresa. Responde únicamente con base en la información de la base de conocimiento. Usa un lenguaje claro, educado y objetivo. Si no encuentras la respuesta, informa que no tienes datos suficientes y orienta al usuario a hablar con un agente. No inventes información, precios, plazos ni reglas.

A partir de esta base, puedes crear un asistente para resolver dudas sobre productos, un asistente para consultar manuales internos o una herramienta de apoyo para atención que responda antes de contactar a un agente humano.

Atención: los límites de uso y el cobro dependen del modelo y del plan contratado en tu cuenta de Google, y pueden medirse por solicitudes y tokens, por minuto o por día. Los modelos experimentales suelen tener límites menores y mayor inestabilidad. Valida los costos y límites antes de usar la integración en producción y evita enviar datos personales o confidenciales sin una evaluación previa.

Soporte

Si tienes alguna duda, problema o sugerencia, contáctanos por correo electrónico en support@wiv.com.br.

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃