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.

Comenzar la lección interactivaLeer los apuntes

¿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.

Archivos del taller

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

Start hereArchivos del taller

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.

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

Archivos de este paso

Start hereArchivos del taller

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.

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.

Archivos de este paso

Start hereArchivos del taller

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.

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.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

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.

¿Te resultó útil esta lección?

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

Sigue aprendiendo

Explora las otras lecciones