LeccionesCómo añadir un chatbot de IA a tu sitio web

Minilección 17 de 30 · Conectar datos e IA

Elige una conversación breve para probar

¿Para quién es esta lección?

Para quienes añaden un asistente conversacional a un sitio pequeño. El proyecto está listo; tú diriges y pruebas su comportamiento sin escribir gestión de mensajes.

El segundo mensaje debe depender del primero.

Propósito de esta lección

  • Obtén una primera respuesta real de IA.
  • Comprueba una continuación que dependa del mensaje previo.
  • Conserva el mensaje fallido para reintentar.
Explicación, ejemplo resuelto y práctica

Antes de empezar

Necesitas tu acceso API Google AI Studio y el proyecto separado de funciones. La lección de claves explica la configuración privada si hace falta. Confirma acceso a modelos, límites y posibles cargos. Usa mensajes ficticios y código controlado por el propietario; antes de abrirlo se necesitan autenticación, límites duraderos y control de presupuesto.

Comprueba tus habilidades iniciales

Son habilidades útiles, no cursos obligatorios bloqueados. Si ya las tienes, empieza aquí; si no, abre la preparación. Los archivos incluidos evitan necesitar un sitio personal previo.

  1. Cómo mantener las claves de API fuera del frontend

    Pon el secreto solo en el entorno privado del servidor.

Tiempo estimado: 20–32 min

Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. Las solicitudes reales usan la cuota de tu cuenta configurada. La autenticación pública, los límites persistentes y la revisión de privacidad son trabajo aparte.

Comprende la idea

Abre el chatbot con el asistente. Elige un tema ficticio sencillo y una continuación que aluda a la respuesta previa para evaluar si conserva el hilo.

Una buena respuesta aislada no demuestra conversación funcional. Prevé revisar ambos mensajes y su relación.

Un ejemplo concreto

Pide una explicación corta y luego una versión más sencilla de esa misma explicación.

Usa el chatbot y guía la configuración privada de run-locally.txt. Mantén credenciales e instrucciones del modelo en servidor. Ayúdame a preguntar, continuar en el mismo tema y probar un fallo sin perder el mensaje escrito. No reconstruyas el sitio ni afirmes que conversa bien solo por la primera respuesta.

Archivos de este paso

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Pruébalo

¿Qué primera pregunta y continuación dependiente probarás?

Mostrar una solución desarrollada

Ejemplo de pareja: «¿Qué hace un servidor web?», después «Simplifica esa explicación para alguien que crea su primera web». La segunda respuesta debe simplificar el mismo papel, no empezar un tema ajeno.

Es un plan, no una conversación realizada. Evaluaré continuidad después de la primera respuesta real y adaptaré la continuación si hace falta otra aclaración.

Qué incluye una respuesta adecuada

  • Proporciona una pregunta inicial concreta y una continuación referida a su respuesta.
  • Explica cómo reconocer continuidad en vez de aceptar una sola respuesta buena.
Cómo funciona (opcional)

Añade un chatbot capaz de continuar una conversación

Una integración útil debe leer el último mensaje del estudiante y su contexto.

Esta lección crea un pequeño tutor web. El visitante pregunta, lee la respuesta y hace otra pregunta relacionada. El navegador envía la conversación aceptada con cada mensaje; el servidor llama a Gemini y devuelve una respuesta auténtica del modelo.

El modelo no recuerda automáticamente tu solicitud HTTP anterior. Conservamos un historial breve en memoria de esta pestaña. Recargar lo borra y el taller se detiene tras cuatro intercambios correctos para acotar la práctica.

Ejemplo resuelto

Pregunta “What is DNS?” (¿qué es DNS?) y después “Explain that using a street-address example.” (explícalo con el ejemplo de una dirección postal). La segunda solicitud necesita la pregunta y respuesta anteriores para establecer qué significa «eso».

Ejercicio técnico adicional

¿Por qué puede parecer ajena una respuesta del segundo turno aunque la API funcione?

Mostrar una solución desarrollada

Quizá la integración envió solo una instrucción genérica u omitió el historial. Examina la matriz messages saliente y confirma que incluye los turnos aceptados anteriores y la pregunta nueva en orden.

  • Comprueba si se incluyeron mensajes anteriores.
  • Comprueba si se conservó el último mensaje del usuario.

Paso 1 · Cómo añadir un chatbot de IA a tu sitio web

Inicia el chatbot proporcionado

Deja al asistente configurar el servidor privado.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Sigue run-locally.txt con el asistente. Confirma cuenta/modelo y condiciones, define valores privados desde server-env.example.txt y abre la URL del proxy. Introduce el código separado, nunca la clave del proveedor. La preparación es obligatoria; escribir el servidor es opcional.

La clave y las instrucciones rectoras quedan en servidor. Si cuenta/modelo no están disponibles, indica esa etapa sin rellenar una respuesta falsa.

Un ejemplo concreto

Un campo del sitio no debe permitir al visitante elegir tus credenciales privadas.

Archivos de este paso

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Pruébalo

¿La aplicación produjo una primera respuesta real o dónde se detuvo?

Mostrar una solución desarrollada

Ejemplo de primera llamada: «La aplicación completa abrió en la URL del proxy. Introduje el código independiente y recibí una explicación del modelo configurado. La clave Google quedó en el entorno privado del servidor».

Ejemplo bloqueado: «La página local abrió, pero el servidor no obtuvo respuesta del modelo». Registra la etapa real de configuración/acceso/cuota y revisa costes antes de repetir. Un archivo estático no demuestra respuesta real.

Qué incluye una respuesta adecuada

  • Identifica la aplicación del proxy y una primera respuesta real del proveedor o el bloqueo exacto.
  • Distingue código de práctica y clave privada y comprueba límites de cuenta/modelo.
Cómo funciona (opcional)

Conecta el navegador con una función de servidor acotada

Mantén las credenciales y el rol del tutor bajo control del servidor.

Despliega las carpetas y configura las variables de START-HERE.txt. public/app.js envía mensajes user/assistant a tu función mini-chat. La función acepta solo roles alternos, texto limitado y un historial pequeño.

El servidor convierte assistant al rol model de Gemini y proporciona una instrucción de sistema separada. Quien llama no puede elegir una URL de proveedor ni sustituir esa instrucción por un rol system del cliente. El código del propietario restringe el laboratorio; no sustituye autenticación pública ni controles persistentes de gasto.

generate es una función auxiliar local en netlify/functions/mini-chat.mjs, no otro servicio desplegado. Para cambiar el rol del tutor, edita la cadena de instrucción pasada a generate en ese archivo de servidor. Una variable .env del frontend no es alternativa: un valor sustituido en el código del navegador se hace público.

Para la secuencia local completa, abre run-locally.txt: prepara el entorno privado de la raíz, vincula solo el proyecto de práctica e inicia el proxy de funciones de Netlify. server-env.example.txt enumera variables sin secretos reales. Abrir solo el HTML no ejecuta el servidor.

Utiliza la guía actual siguiente o ejecuta list-text-models.mjs desde la raíz privada del taller con tu entorno. Enumera candidatos generateContent visibles para la cuenta sin imprimir la clave. Elige un modelo de texto con soporte, comprueba condiciones y cuota y copia su ID exacto en GEMINI_MODEL del servidor.

Ejemplo resuelto

El validador rechaza mensajes inyectados de rol system antes de llamar al proveedor. No hace infalible la salida, pero mantiene bajo tu control el formato y la configuración privilegiada.

Gemini: API generateContent · Gemini: claves de API · Gemini: ID y capacidades actuales de modelos · Node.js: estado de soporte de versiones

Ejercicio técnico adicional

¿Debe el navegador elegir GEMINI_API_KEY o enviar un mensaje system para anular el rol del tutor?

Mostrar una solución desarrollada

Ninguna de las dos cosas. Configura clave y rol en el servidor. Valida roles y tamaños; sigue siendo necesario evaluar la corrección de las respuestas.

  • Mantiene los secretos del proveedor en el servidor.
  • Trata los mensajes del cliente como entradas de conversación no fiables.

Paso 2 · Cómo añadir un chatbot de IA a tu sitio web

Continúa y prueba un fallo

Protege el mensaje escrito cuando falle la petición.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Envía la continuación y compara su respuesta con el intercambio anterior. Pide ayuda para simular o reproducir un fallo en el proyecto desechable.

La continuación debe seguir tu conversación y el envío fallido conservar borrador y mensajes anteriores para reintentar.

Un ejemplo concreto

Un fallo en el segundo turno no debe borrar la pregunta recién escrita.

Archivos de este paso

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Pruébalo

¿Qué ocurrió en la continuación y en fallo/reintento?

Mostrar una solución desarrollada

Ejemplo de conversación: «Tras explicar el servidor, mi petición de simplificar siguió sobre esa explicación. Luego usé deliberadamente código incorrecto al enviar; borrador e historial permanecieron. Recuperar el código válido permitió reintentar».

El rechazo del código es una prueba local intencional, no caída del proveedor. Si desaparece el borrador o se duplica un intercambio correcto, la conversación aún no está lista.

Qué incluye una respuesta adecuada

  • Compara la respuesta de continuación con el intercambio anterior para verificar continuidad.
  • Prueba un fallo identificado y comprueba que borrador e historial se conserven para reintentar.
Cómo funciona (opcional)

Prueba continuación y fallos

Incluye el segundo turno en la prueba de finalización.

Formula la pregunta sobre DNS del ejemplo y después una pregunta de seguimiento que se refiera a ella. Examina el cuerpo de la solicitud en las herramientas del navegador y compara la respuesta con la última pregunta real. Una respuesta larga y fluida no demuestra que sea pertinente.

Prueba un código incorrecto en el siguiente envío. El borrador permanece en textarea y no se añade ningún intercambio fallido al historial aceptado. Corrige el acceso y reintenta. Enter envía; Shift+Enter crea una línea. El botón se desactiva durante la espera.

Ejemplo resuelto

Un tiempo agotado o una respuesta incompleta del proveedor producen un fallo visible. El navegador no añade un mensaje assistant vacío fingiendo que continuó la conversación.

Ejercicio técnico adicional

La primera respuesta es buena, pero falla la segunda solicitud. ¿Qué debe pasar con el texto escrito y el historial?

Mostrar una solución desarrollada

Conserva el borrador y los turnos aceptados. Muestra el fallo honestamente, restablece los controles y añade el par nuevo solo tras recibir una respuesta válida.

  • Conserva el borrador para reintentar.
  • No registra una respuesta inventada del asistente.

Paso 3 · Cómo añadir un chatbot de IA a tu sitio web

Entrega el comportamiento de conversación

Usa varios intercambios, no una sola respuesta atractiva.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Completa tres intercambios con tu tema ficticio y guarda la transcripción sin datos sensibles. Repite recuperación tras fallos después de corregir.

Comprueba que repetir no pierda borrador ni duplique un intercambio correcto. Marca como no probados los tests indisponibles. Este ejemplo no recupera notas fiables ni garantiza hechos; content-chatbot añade después una tarea de fuentes y comprobación.

Un ejemplo concreto

La evidencia debe mostrar pregunta, respuesta y recuperación tras fallo.

Archivos de este paso

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Pruébalo

Entrega transcripción y observación real de fallo/reintento.

Qué debes entregar: Una transcripción breve de varios turnos y un resultado observado de fallo/reintento sin secretos.

Mostrar una solución desarrollada

Esquema ilustrativo: «1. Explica un servidor web. 2. Simplifica esa respuesta. 3. Da un ejemplo de cómo ayuda a esta web». Un registro completo tendría las respuestas reales junto a esas preguntas para evaluar la relación.

Ejemplo de recuperación: «Un envío rechazado deliberadamente conservó el borrador; repetir añadió un intercambio, no dos». Antes de uso público aún se requieren autenticación, límites duraderos y costes vigilados; este ejemplo restringido no responde basándose en fuentes.

Qué incluye una respuesta adecuada

  • Incluye tres intercambios relacionados y contexto suficiente para evaluar respuestas.
  • Registra recuperación del envío fallido sin perder borrador ni duplicar un intercambio correcto.
Cómo funciona (opcional)

Tu tarea: crear un tutor con el que merezca continuar

Evalúa pertinencia en vez de contar solo solicitudes correctas.

Cambia la instrucción del servidor a un tutor conciso de HTML/CSS. Realiza tres intercambios: pregunta por un anclaje roto, propone un par href/id incorrecto y pregunta por qué falla. Utiliza código sintético, no fuentes privadas.

Conserva una transcripción sin datos sensibles y anota si cada respuesta aborda el último mensaje. Repite un envío fallido y demuestra que el reintento mantiene la coherencia. Antes del acceso público, planifica autenticación real, cuotas persistentes por usuario y una explicación del destino de los mensajes.

Ejemplo resuelto

Un tutor útil indica qué href/id no coinciden. Consejos genéricos sobre nombres de variables no responderían al estudiante, aunque fueran técnicamente ciertos.

Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.

Ejercicio técnico adicional

Entrega tres intercambios y una observación de fallo y reintento.

Mostrar una solución desarrollada

Edita la instrucción de la función de servidor para crear un tutor conciso de HTML/CSS. No cambies una variable del frontend ni muevas generate a public. La función de referencia contiene la versión completa de la instrucción cambiada.

Evaluación de muestra: el usuario pregunta por qué <a href='#work'> no llega a <section id='projects'>. Una respuesta pertinente nombra ese desajuste. Después propone href='#projects'; una respuesta pertinente comprueba esa corrección concreta. Los consejos genéricos sobre variables fallarían esta prueba aunque HTTP devuelva 200.

Envía un código incorrecto en un turno posterior. La conversación aceptada debe seguir intacta y textarea debe conservar el borrador no enviado. Corrige el acceso y reintenta; añade un par user/assistant solo tras una respuesta válida. Esta transcripción es una guía de evaluación, no una afirmación de resultado generado en vivo.

  • Las respuestas de continuación responden a los mensajes reales anteriores.
  • El fallo conserva borrador e historial y la clave permanece privada.

¿Te resultó útil esta lección?

Deja un me gusta o compártela con alguien a quien pueda servirle.