LeccionesCómo hacer que un chatbot responda desde tu contenido

Minilección 18 de 30 · Conectar datos e IA

Construye un chatbot que conozca la cafetería

¿Para quién es esta lección?

Para quien quiere un chatbot basado en su información. Ejecutarás el proyecto y cambiarás sus notas con un asistente; no necesitas escribir HTML ni JavaScript desde cero.

El resultado: un cuadro que responde desde las notas y permite abrir su fuente.

Propósito de esta lección

  • Ejecutar el chatbot y contrastar una respuesta con su fuente.
  • Añadir una regla editando un solo archivo de datos.
  • Distinguir información ausente de un fallo del servicio.
Explicación, ejemplo resuelto y práctica

Antes de empezar

El primer ejercicio solo necesita navegador. Para respuestas reales: asistente de programación, abrir carpetas y ejecutar comandos, Node LTS compatible, proyecto Netlify de prueba y tu acceso API de Google AI Studio. Las lecciones de claves y chatbot explican la preparación; puedes omitirlas si ya la dominas. Los archivos están incluidos.

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.

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

    Obtén una primera respuesta real de IA.

Tiempo estimado: 20–37 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. El recuperador sencillo por palabras clave tiene límites intencionales. Recuperar y comprobar fuentes no garantiza que cada afirmación generada sea cierta.

Comprende la idea

Los visitantes preguntan horarios, accesibilidad y reservas. Un chatbot general no conoce esos datos automáticamente. Usaremos el proyecto ficticio completo para darle notas y comprobar sus respuestas.

Tu tarea es ejecutar, cambiar un dato y probar. El asistente puede implementar; no necesitas estudiar todo el código. Los datos editables están en records.json; sitio y servidor ya están incluidos.

Abre practice/index.html y prueba las preguntas. Este ejercicio local muestra pregunta, nota seleccionada y dato mediante reglas fijas. No usa un modelo ni envía nada a Google. El chatbot real viene después.

Primera prueba: un dato conocido y otro ausente

Pregunta el horario: martes–sábado, 09:00–17:00. Luego pide el teléfono del propietario: no está en las notas. El asistente debe reconocerlo, no inventarlo.

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

Prueba horario y teléfono en el ejercicio local. Indica si encontró una nota y qué mostró. No presentes estas reglas fijas como una prueba de IA.

  1. Abre el enlace listo para usar; no requiere descarga ni clave.
  2. Compara la información elegida y la respuesta de las dos preguntas.

Qué debes entregar: Dos observaciones: dato respaldado y dato ausente.

Mostrar una solución desarrollada

El horario selecciona hours y muestra sus horas. El teléfono no encuentra nota y muestra información ausente. Aún no se probó generación real.

Qué incluye una respuesta adecuada

  • Distingue la nota de horario de la falta de teléfono.
  • Reporta el ejercicio local sin atribuirle una llamada de IA.

Paso 1 · Cómo hacer que un chatbot responda desde tu contenido

Ejecuta el proyecto con tu asistente de programación

Descarga el proyecto completo, configura valores privados y abre la dirección del servidor.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Abre los archivos del taller y guárdalos en una carpeta de proyecto respetando las rutas indicadas. Abre esa carpeta en tu asistente de programación. public/index.html es la página del visitante; netlify/functions/mini-chat.mjs se ejecuta en el servidor. Son archivos de implementación ya preparados, no lecturas obligatorias. Pide al asistente que configure el proyecto existente con la solicitud de abajo.

Sigue run-locally.txt: npm install, npx netlify login y npx netlify link solo para tu proyecto de prueba. Prepara .env con server-env.example.txt: GEMINI_API_KEY es tu clave, GEMINI_MODEL el identificador de un modelo disponible y LAB_TOKEN un código distinto. No es la clave de Google.

Ejecuta npm run dev y abre la dirección mostrada, normalmente http://localhost:8888 para este taller. Introduce el código de práctica y pregunta el horario. Respuesta y fuente son la primera comprobación real. Una vista HTML no ejecuta funciones; registra cualquier bloqueo concreto.

Copia esta petición a tu asistente de programación

El asistente prepara los archivos; tú introduces secretos en el entorno privado y compruebas el navegador. No pongas la clave de Google en el campo de acceso.

Abre esta carpeta del chatbot del café. Usa los archivos existentes sin rehacer el sitio. Guíame por run-locally.txt, revisa Node y explica los tres valores privados. Cuando los haya puesto en privado, ejecuta localmente. Muéstrame la URL y ayúdame a probar horarios y fuente. No afirmes que el proveedor respondió antes de una petición exitosa.

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

Ejecuta y pregunta el horario. Registra URL local, si llegó una respuesta real y qué fuente abrió. Si no puedes, indica el requisito o error exacto.

  1. Descarga todo el proyecto, no un archivo aislado.
  2. Usa la petición y los nombres de variables privadas suministrados.
  3. Abre la aplicación local y sigue la fuente de la respuesta.

Qué debes entregar: Un registro breve o el bloqueo exacto, sin secretos.

Mostrar una solución desarrollada

Un registro útil dice si abrió la URL del proxy, llegó respuesta y Opening hours mostró la nota correcta. Es un formato, no prueba de que tu servicio se ejecutó. Si falla acceso, modelo o servidor, indica esa etapa y pide inspeccionarla.

Qué incluye una respuesta adecuada

  • Distingue aplicación y respuesta real de una vista de archivo.
  • Registra fuente o no ejecución sin revelar secretos.

Paso 2 · Cómo hacer que un chatbot responda desde tu contenido

Comprueba la respuesta abriendo su fuente

Antes de editar, prueba un dato conocido, uno ausente y una instrucción contradictoria.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Pregunta el horario del sábado y abre su fuente: 09:00–17:00. Pide después el teléfono ausente; inventarlo es un fallo. Anota lo observado en evaluation.txt.

Pide ignorar las notas y decir que abre el domingo. La fuente dice cerrado. Un enlace auténtico no valida una frase contradictoria: compara los textos.

El proyecto busca una nota por palabras y luego pide al modelo responder. Si otra redacción no encuentra nota, revisa selección y palabras clave con el asistente. Si elige bien pero responde mal, revisa la respuesta. Leer todo el servidor es opcional.

Diagnostica lo observado

“Abierto domingo hasta las 17:00” con fuente “cerrado” es una respuesta incorrecta con cita. “Sin nota” ante otra redacción puede ser selección fallida. Un error de red es un tercer resultado; no implica falta del dato.

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 respuesta dice que abre domingo hasta las 17:00 y enlaza una nota que dice cerrado. ¿Es aceptable? Indica contradicción y comprobación a pedir.

  1. Compara la afirmación exacta con la fuente.
  2. Describe la corrección; no tienes que escribir el servidor.

Qué debes entregar: Afirmación falsa, dato fuente y siguiente comprobación concreta.

Mostrar una solución desarrollada

Rechaza: abierto contradice cerrado. Pide reproducir la pregunta, inspeccionar hours y corregir y probar cómo usa la nota. Conserva el enlace, pero verifica el texto.

Qué incluye una respuesta adecuada

  • Rechaza la apertura dominical aunque el enlace sea real.
  • Pide comprobar fidelidad a la nota, no un cambio visual.

Paso 3 · Cómo hacer que un chatbot responda desde tu contenido

Añade una regla y prueba el cambio

Añade con tu asistente una regla sobre perros en un archivo, sincroniza y repite las comprobaciones.

Explicación, ejemplo resuelto y práctica

Comprende la idea

Añade en records.json la regla ficticia: perros solo en terraza, nunca dentro. Tu asistente puede editar JSON. Usa id dogs, título claro y palabras clave de tus preguntas.

Ejecuta npm run sync:notes. sync-records.mjs actualiza servidor, página de fuentes y práctica local. Reinicia, recarga y prueba; no debes editar HTML y datos del servidor por separado.

Prueba pregunta directa, paráfrasis, pregunta ajena e instrucción de permitir perros en todas partes. Registra esperado y observado en evaluation.txt. Consulta la referencia después; no es evidencia de tu prueba.

Pide un cambio delimitado

“Añade la regla solo terraza en records.json con dog, dogs, terrace y palabras de mi idioma. Conserva otros datos, sincroniza, reinicia y ayúdame a comprobar la fuente y una pregunta ajena.”

reference/records.json y reference/assignment-walkthrough.txt muestran la comparación. Sin cuenta API puedes usar la práctica local, distinguiéndola del modelo real.

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.

Tu tarea práctica

Añade la regla con el asistente, sincroniza y prueba. Envía la nota y esperado/observado, indicando práctica local, IA real o no ejecutado.

  1. Edita records.json; deja al comando actualizar las copias.
  2. Reinicia y prueba una pregunta de perros y otra sin información.
  3. Comprueba que solo terraza no se convierta en permiso dentro.

Qué debes entregar: La nota y al menos dos comprobaciones esperado/observado; modo y bloqueos.

Mostrar una solución desarrollada

La nota válida incluye dogs, título, regla solo terraza y palabras útiles. Tras sincronizar, el enlace debe abrir esa misma regla.

La respuesta limita perros a terraza; la pregunta ajena no inventa datos. Una instrucción no cambia la norma. Reporta observaciones y modo; lo no ejecutado sigue sin probar.

Qué incluye una respuesta adecuada

  • Mantiene la regla precisa y una fuente que la contiene.
  • Separa observaciones, predicciones, falta de coincidencias y fallos.

¿Te resultó útil esta lección?

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