
Minilección · Español
Cómo añadir un chatbot de IA a tu sitio web
Ejecuta un chatbot privado listo con un asistente y prueba si una continuación usa la conversación y resiste peticiones fallidas.
¿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.
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.
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.
Qué aprenderás
- Obtén una primera respuesta real de IA.
- Comprueba una continuación que dependa del mensaje previo.
- Conserva el mensaje fallido para reintentar.
Paso 1
Elige una conversación breve para probar
El segundo mensaje debe depender del primero.
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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».
Extra implementation exercise
¿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.
Error habitual
Llamar conversación a una secuencia de respuestas predefinidas sin relación.
Paso 2
Inicia el chatbot proporcionado
Deja al asistente configurar el servidor privado.
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.
Gemini: API generateContent · Gemini: claves de API · Gemini: ID y capacidades actuales de modelos · Node.js: estado de soporte de versiones
Pruébalo
¿La aplicación produjo una primera respuesta real o dónde se detuvo?
Comenta tu respuesta con el tutor
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.
- 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.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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
Extra implementation exercise
¿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.
Error habitual
Confiar en roles aportados por el cliente porque la interfaz normal no los expone.
Paso 3
Continúa y prueba un fallo
Protege el mensaje escrito cuando falle la petición.
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.
Pruébalo
¿Qué ocurrió en la continuación y en fallo/reintento?
Comenta tu respuesta con el tutor
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.
- 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.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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.
Extra implementation exercise
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.
Error habitual
Probar solo «hola» y declarar funcional toda la conversación.
Paso 4
Entrega el comportamiento de conversación
Usa varios intercambios, no una sola respuesta atractiva.
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.
Pruébalo
Materiales para empezar
Los archivos y contenidos de prueba están incluidos. La verificación real requiere tu propia cuenta, buzón o dominio, según los requisitos. Puedes inspeccionar localmente; registra los pasos reales como no probados hasta ejecutarlos.
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.
Comenta tu respuesta con el tutor
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.
- 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.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- netlify/functions/mini-chat.mjsDescargar este archivo
- conversation-tests.txtDescargar este archivo
- worksheet.htmlDescargar este archivo
- reference/assignment-walkthrough.txtDescargar este archivo
- reference/START-HERE.txtDescargar este archivo
- reference/netlify/functions/mini-chat.mjsDescargar este archivo
How it works (optional)
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.
Extra implementation exercise
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.
Error habitual
Evaluar una integración de IA solo por el éxito HTTP.
¿Te resultó útil esta lección?
Deja un me gusta o compártela con alguien a quien pueda servirle.
Sigue aprendiendo
- Cómo crear tu primer sitio web personal
- Cómo publicar tu sitio web desde GitHub
- Cómo conectar un dominio propio a tu sitio web
- Cómo configurar correo en tu propio dominio
- Cómo hacer que tu sitio web se pueda utilizar en teléfonos
- Cómo acelerar la carga de imágenes de tu sitio web
- Cómo recibir los comentarios de tu sitio web en tu bandeja de entrada
- Cómo añadir suscripciones por correo a tu sitio
- Cómo enviar correos automáticos desde tu sitio web
- Cómo guardar envíos de formularios en una base de datos
- Cómo permitir que las personas inicien sesión en tu sitio web
- Cómo mantener privada una página
- Cómo permitir que los usuarios editen su perfil
- Cómo permitir que los usuarios suban imágenes
- Cómo mantener las claves de API fuera del frontend
- Cómo mostrar datos de una API externa en tu sitio web
- Cómo hacer que un chatbot responda desde tu contenido
- Cómo añadir un blog a tu sitio web
- Cómo añadir búsqueda a tu sitio web
- Cómo añadir otro idioma a tu sitio web
- Cómo ayudar a Google a encontrar tu sitio web
- Cómo corregir la vista previa de tu sitio al compartir un enlace
- Cómo medir visitas y acciones útiles en tu sitio web
- Cómo permitir que los visitantes reserven una cita
- Cómo aceptar un pago en tu sitio web
- Cómo previsualizar cambios de tu sitio antes de publicarlos
- Cómo revertir un despliegue defectuoso de tu sitio web
- Cómo hacer copias de seguridad y restaurar los datos de tu sitio
- Cómo encontrar y corregir errores en tu sitio publicado