El código se copia con un botón: no transcriba nada. Lo que sí tiene que llenar son los campos verdes — se guardan solos en este computador, y al final los baja en un archivo para la entrega.
Baje el archivo apenas termine. Lo que se guarda solo vive en este computador y se pierde si lo reinician.
Lo construimos juntos. Al final de esta parte usted tiene un buscador que funciona.
Baje clase12-rag.zip de los recursos de la clase y descomprímalo en el Escritorio.
Ábralo en VS Code con Archivo → Abrir carpeta. Debe verse así:
clase12-rag/
documentos/
01-devoluciones.txt
02-garantias.txt
03-domicilios.txt
04-fidelizacion.txt
05-horarios.txt
06-reclamos.txtAbra 02-garantias.txt y léalo. Son ocho líneas.
Fíjese en la forma, porque hoy usted va a escribir cinco así. Todos los documentos de esta carpeta siguen el mismo molde:
TITULO EN MAYUSCULAS - NOMBRE DE LA EMPRESA <- de que trata Un parrafo de 3 o 4 lineas con la regla principal, y SIEMPRE con cifras concretas: 8 dias, 9.900 pesos, 30 dias. Un parrafo con los detalles o las excepciones. Una linea con lo que NO cubre.
En VS Code: clic derecho sobre la carpeta → New File, y llámelo buscador.py.
Copie todo este código y péguelo adentro. No lo transcriba: use el botón.
# glob -> busca archivos por patrón: "documentos/*.txt" = todos los .txt de esa carpeta
# re -> expresiones regulares, aquí solo para partir un texto en palabras
import glob, re
# Palabras que aparecen en TODO y no distinguen nada. Si no las quitamos,
# cualquier documento se parece a cualquier pregunta.
VACIAS = {"de","la","el","en","y","a","los","las","un","una","que","se","con",
"por","para","del","al","es","su","o","no","si","mi","me","lo","como",
"cuanto","cuantos","cuanta","cuantas","puedo","tengo","hay","dentro"}
# "días" y "dias" son la misma palabra para usted y dos palabras distintas
# para el computador. El recuperador tiene que igualarlas antes de comparar.
TILDES = str.maketrans("áéíóúüñ", "aeiouun")
def palabras(texto):
limpio = texto.lower().translate(TILDES)
sueltas = [p for p in re.findall(r"[a-z]+", limpio) if p not in VACIAS]
# [:5] = nos quedamos con la raíz, para que "devolver" y "devoluciones"
# cuenten como la misma. Un buscador de verdad usa stemming; esto es
# la versión de juguete, y más abajo vamos a ver dónde se rompe.
return {p[:5] for p in sueltas}
# 1 - EL CORPUS. Cada archivo es un pedazo (un "chunk").
pedazos = []
for ruta in sorted(glob.glob("documentos/*.txt")):
with open(ruta, encoding="utf-8") as f:
pedazos.append((ruta, f.read()))
# La misma guarda de la clase pasada: sin esto, responde "no sé" y parece normal.
if not pedazos:
print("NO ENCONTRE NINGUN DOCUMENTO en documentos/*.txt")
raise SystemExit(1)
pregunta = input("Pregunta: ")
clave = palabras(pregunta)
# 2 - EL RECUPERADOR. Puntaje = qué tanto de la pregunta aparece en el documento.
puntajes = []
for ruta, texto in pedazos:
comunes = clave & palabras(texto)
puntajes.append((len(comunes) / max(len(clave), 1), ruta, texto, comunes))
puntajes.sort(key=lambda x: x[0], reverse=True)
print("\nRANKING COMPLETO")
for score, ruta, _, comunes in puntajes:
print(f" {score:5.2f} {ruta:32} {sorted(comunes)}")
# 3 - EL PROMPT ARMADO. Solo los 2 mejores entran.
print("\n" + "=" * 62)
print("ESTO ES LO UNICO QUE VA A VER EL MODELO")
print("=" * 62)
lineas = [] # aqui vamos armando el prompt, linea por linea
lineas.append("Eres el asistente de servicio al cliente de Cafe Altamar.")
lineas.append("Responde al cliente de forma util y concreta.\n")
for score, ruta, texto, _ in puntajes[:2]:
lineas.append(f"--- EVIDENCIA ({ruta}) ---")
lineas.append(texto.strip() + "\n")
lineas.append(f"PREGUNTA: {pregunta}")
print("\n".join(lineas))
# Y lo guardamos tambien en un archivo, porque copiar desde la terminal
# es incomodo. Abra prompt.txt en VS Code y copie con Ctrl+A, Ctrl+C.
with open("prompt.txt", "w", encoding="utf-8") as f:
f.write("\n".join(lineas))
print("\n(tambien quedo en prompt.txt — abralo en VS Code y copielo de ahi)")Guarde con Ctrl+S.
Abra la terminal de VS Code con Ctrl+Ñ (o Terminal → Nueva terminal) y ejecute:
python buscador.py
Pregunta: antes de escribir. Si escribe antes, la terminal se come la pregunta y le sale command not found.Cuando aparezca, pegue esta pregunta:
¿Cuántos días tengo para devolver un café?
Ahora abra el archivo prompt.txt que acabó de aparecer en la carpeta. Selecciónelo todo con Ctrl+A, cópielo con Ctrl+C, y péguelo en su chat de IA.
Ahora voltee a mirar al compañero de al lado. Si usa un chat distinto al suyo, pídale la respuesta que le salió a él y anótela:
python buscador.py
Y cuando aparezca Pregunta:, pegue esta:
¿Puedo devolver un molino de café?
Vuelva a abrir prompt.txt, cópielo y péguelo en su chat.
Computador a un lado. Esta parte es de hablar y de anotar.
No modifique buscador.py. Vamos a trabajar sobre una copia, para poder comparar las dos. En la terminal:
cp buscador.py buscador2.py
Abra buscador2.py y haga dos cambios.
Cambio 1 · el umbral. Busque estas tres líneas, que son las que imprimen el ranking:
print("\nRANKING COMPLETO")
for score, ruta, _, comunes in puntajes:
print(f" {score:5.2f} {ruta:32} {sorted(comunes)}")Y justo debajo de la última, pegue esto:
UMBRAL = 0.70
mejor = puntajes[0][0]
if mejor != max(p[0] for p in puntajes):
print("\nOJO: este bloque quedo ANTES del sort. Muevalo debajo de")
print(" puntajes.sort(...) o va a bloquear preguntas buenas.")
raise SystemExit(1)
if mejor < UMBRAL:
print(f"\nEVIDENCIA INSUFICIENTE (mejor puntaje {mejor:.2f} < {UMBRAL})")
print("No le pregunto al modelo. Esta pregunta no la cubren los documentos.")
raise SystemExit(0)Cambio 2. Busque esta línea:
lineas.append("Responde al cliente de forma util y concreta.\n")Reemplácela por estas tres:
lineas.append("Responde al cliente de forma util y concreta.")
lineas.append("Responde usando UNICAMENTE la evidencia de abajo.")
lineas.append("Si la evidencia no alcanza, responde exactamente: NO ESTA EN LOS DOCUMENTOS.\n")Guarde, y corra la misma pregunta 2 contra la versión nueva:
python buscador2.py
El molino del paso 5 no salió de la nada: yo lo construí a propósito, y hay una receta. En el taller usted va a tener que fabricar la suya, así que vamos a hacer una aquí primero.
LA RECETA, EN TRES REGLAS
1. Escoja un documento y mire DE QUE habla.
(01-devoluciones habla de cafe en grano y cafe molido)
2. Pregunte por un PRIMO de esa cosa que el documento NO menciona.
(un molino es pariente del cafe... pero no es cafe)
3. Use las PALABRAS del documento en su pregunta.
Si no, saca 0.00 y no sirve como trampa.Ahora le toca a usted. Escoja otro documento de Café Altamar — no el de devoluciones — y fabrique una trampa siguiendo las tres reglas. Pruébela:
python buscador.py
En la misma carpeta ya viene probar.py. Córralo una sola vez:
python probar.py
Son 10 preguntas donde ya se sabe cuál debería ser el resultado: 7 sí se pueden responder con los documentos y 3 no. El programa le muestra tres cosas, una debajo de la otra.
QUE HACE es lo que el sistema hizo de verdad. QUE DEBIA HACER es lo que debió haber hecho. Con el umbral en 0.70, todo lo que saque menos de 0.70 se calla, sin excepción — las filas marcadas MAL también. El error no es que respondieran: es que se callaron teniendo la respuesta en los documentos.Mire solo las dos últimas columnas, no el total.
El programa encuentra varias preguntas con el mismo puntaje.
Y ahora agregue la suya. Abra probar.py y busque la lista que se llama BANCO. Cada línea tiene dos cosas: la pregunta, y el archivo que debería ganar — o None si la respuesta no está en ningún documento.
("¿Puedo devolver un molino de café?", None),
("SU PREGUNTA TRAMPA DEL PASO 8 VA AQUI", None),None porque su respuesta no está en los documentos — la suya también debería llevar None, si de verdad es una trampa.python probar.py
Último paso de la parte guiada, y es el ensayo de lo que más puntos vale en el taller.
Imagine que el gerente de Café Altamar le escribe: «me dicen que el bot a veces no contesta cosas que están en nuestras propias políticas. ¿Por qué?»
Por grupos · 60 minutos · De aquí sale la nota de hoy
Cada grupo construye su propio sistema, con su propio negocio. Carpeta nueva, desde cero:
mkdir taller12 mkdir taller12/documentos
| # | Qué hace | Ya lo hizo en | Pts |
|---|---|---|---|
| 1 | Escriben 5 documentos de su negocio en taller12/documentos/, de 6 a 10 líneas, con cifras concretas, usando el molde | paso 2 la forma de un documento | 10 |
| 2 | Copian su buscador.py a taller12/ y lo hacen correr contra sus documentos | pasos 3 y 4 crear y correr | 18 |
| 3 | Fabrican su pregunta trampa con las tres reglas: puntaje alto y sin respuesta en sus documentos | paso 8 la receta | 18 |
| 4 | Pegan ese prompt en dos chats de IA distintos y comparan | paso 4 con el compañero | 14 |
| 5 | Arman un banco de 8 preguntas — 5 que sí responden y 3 que no — y prueban tres umbrales | paso 9 agregó una al banco | 20 |
| 6 | Escriben el correo al jefe, cinco frases sin jerga | paso 10 escribió una | 20 |
cp buscador.py taller12/buscador.py cd taller12 python buscador.py
documentos/*.txt con ruta relativa, basta con pararse dentro de taller12 para que use los documentos de ustedes.Peguen el prompt de su pregunta trampa en dos chats distintos.
Armen un banco de 8 preguntas sobre su negocio — 5 que sus documentos sí respondan y 3 que no — y métanlas en su propio probar.py.
Su sistema a veces se niega a responder. Su jefe se dio cuenta y le escribió preguntando por qué. No es técnico: es el gerente del negocio.
Primero, baje sus respuestas con el botón azul de abajo. Le va a quedar un archivo respuestas-clase12.txt.
Después, meta ese archivo dentro de taller12/ y comprima la carpeta. Adentro debe quedar:
taller12/ documentos/ los 5 documentos del negocio buscador.py funcionando contra su corpus respuestas-clase12.txt el que baja de esta guía
Arquitectura de Software · Universidad Jorge Tadeo Lozano · 2026-2S