Spaces:
Paused
Paused
Download modules/llm/prompt_builder.py from SamilG2/BACKEND-CheckScan: direct link, hf CLI and curl.
- Browser
- Download file 6.09 kB
-
https://huggingface.co/spaces/SamilG2/BACKEND-CheckScan/resolve/main/modules/llm/prompt_builder.py
- Command line
-
hf download hf://spaces/SamilG2/BACKEND-CheckScan/modules/llm/prompt_builder.py
-
curl -L -o prompt_builder.py https://huggingface.co/spaces/SamilG2/BACKEND-CheckScan/resolve/main/modules/llm/prompt_builder.py
6.09 kB
| from modules.analysis.classifier import classify | |
| from modules.transcription.validator import translate_move_en_es | |
| # El entrenador SOLO comenta el patrón estratégico. La mejor jugada y la | |
| # evaluación numérica las muestra Stockfish por separado en la UI, así que el | |
| # modelo NO debe mencionarlas (de hecho no se las pasamos en el prompt). | |
| SYSTEM = ( | |
| "Eres un entrenador de ajedrez serio y didáctico, con un registro claro y " | |
| "profesional, como un buen profesor. Comentas las jugadas de tu alumno " | |
| "hablándole de 'tú' en una o dos oraciones precisas, explicando con rigor " | |
| "pero en lenguaje accesible la idea estratégica detrás de la jugada (control " | |
| "del centro, seguridad del rey, actividad de las piezas, iniciativa, " | |
| "estructura de peones). Mantén un tono sobrio y respetuoso: SIN exclamaciones " | |
| "efusivas, SIN emojis y SIN jerga ni coloquialismos. La prioridad es que la " | |
| "explicación sea correcta, concisa y fácil de entender. " | |
| "Reglas estrictas: responde SIEMPRE en español (nunca en otro idioma); NO " | |
| "menciones números ni evaluaciones; NO recomiendes ninguna jugada " | |
| "alternativa; nada de muletillas. Lo esencial es la idea estratégica " | |
| "expresada con claridad." | |
| ) | |
| # Clasificaciones que cuentan como "mala jugada" para detectar tendencia. | |
| _MALAS = {"Imprecisión", "Error"} | |
| _BUENAS = {"Brillante", "Excelente", "Buena"} | |
| def _tendencia(history: list, max_n: int = 4) -> str: | |
| """Resume la tendencia reciente en lenguaje natural (sin tokens de jugadas). | |
| En vez de pasar el historial crudo (que el modelo copiaba textual), le | |
| damos una señal de alto nivel: si viene fallando o jugando bien. Así el | |
| comentario considera la tendencia sin filtrar nombres de jugadas. | |
| """ | |
| recientes = [classify(h.get("diferencia_cp", 0)) for h in history[-max_n:]] | |
| if not recientes: | |
| return "Tendencia: es de las primeras jugadas, aún no hay patrón." | |
| malas = sum(1 for c in recientes if c in _MALAS) | |
| if malas >= 2: | |
| return "Tendencia: el jugador viene cometiendo varias imprecisiones seguidas." | |
| if malas == 0 and all(c in _BUENAS for c in recientes): | |
| return "Tendencia: el jugador venía jugando con precisión." | |
| return "Tendencia: el juego venía equilibrado, sin un patrón marcado." | |
| def _fase(numero: int) -> str: | |
| """Fase aproximada de la partida según el número de jugada. Señal simple y | |
| CONSISTENTE entre entrenamiento e inferencia, para que el modelo no hable de | |
| 'el final' en pleno medio juego (bug observado en la v1).""" | |
| if numero <= 10: | |
| return "apertura" | |
| if numero <= 25: | |
| return "medio juego" | |
| return "final" | |
| def build(move: dict, clasificacion: str, history: list | None = None) -> str: | |
| color_str = "Blancas" if move["color"] == "white" else "Negras" | |
| # La jugada llega en SAN inglés (board.san); el modelo debe verla en español | |
| # para no mezclar idiomas en su respuesta. | |
| jugada_es = translate_move_en_es(move["move"]) | |
| return ( | |
| f"{_tendencia(history or [])}\n" | |
| f"Fase: {_fase(move.get('number', 0))}.\n" | |
| f"Jugada actual ({color_str}): {jugada_es}, clasificada como {clasificacion}. " | |
| f"Explica en una oración el mérito o el problema estratégico de esta jugada." | |
| ) | |
| # ── EXPANDIDO (botón "Explicar" / texto largo) ──────────────────────────────── | |
| # Rol distinto al corto: aquí SÍ puede nombrar la mejor jugada (que entrega | |
| # Stockfish) y explicar el porqué en 2-4 oraciones. Regla dura: solo la jugada | |
| # que se le pasa, nunca inventar. Es un SYSTEM aparte para no mezclar reglas | |
| # contradictorias con el corto. | |
| SYSTEM_EXPANDIDO = ( | |
| "Eres el mismo entrenador de ajedrez, serio y didáctico, y ahora EXPLICAS el " | |
| "error con calma y en palabras SENCILLAS, pensando en un jugador principiante o " | |
| "intermedio que quiere entender qué hizo mal. En 2 a 4 oraciones: (1) expón con " | |
| "claridad qué problema tuvo su jugada, (2) indícale qué jugada era mejor —solo la " | |
| "que se te indica— y por qué le convenía, y (3) cierra con una lección breve y " | |
| "fácil de recordar. Evita tecnicismos innecesarios; usa lenguaje cotidiano pero " | |
| "preciso. Reglas CRÍTICAS: usa ÚNICAMENTE la jugada que se te indica como mejor " | |
| "jugada (NUNCA inventes otra); y si se te dan datos de lo que esa jugada logra (a " | |
| "qué pieza ataca, qué casilla domina...), úsalos TAL CUAL y NO añadas piezas, " | |
| "casillas ni amenazas que no se te hayan dado. No menciones evaluaciones " | |
| "numéricas. Responde SIEMPRE en español, nunca en otro idioma. Mantén un tono " | |
| "sobrio y profesional, sin exclamaciones ni jerga; lo primero es que el alumno " | |
| "ENTIENDA su error." | |
| ) | |
| def build_expandido(move: dict, clasificacion: str, history: list | None = None, | |
| mejor_es: str | None = None, detalle: str | None = None) -> str: | |
| color_str = "Blancas" if move["color"] == "white" else "Negras" | |
| # La jugada jugada llega en SAN inglés; se traduce para que coincida con la | |
| # mejor jugada (mejor_es) y el modelo no mezcle notaciones/idiomas. | |
| jugada_es = translate_move_en_es(move["move"]) | |
| base = ( | |
| f"{_tendencia(history or [])}\n" | |
| f"Fase: {_fase(move.get('number', 0))}.\n" | |
| f"Jugada actual ({color_str}): {jugada_es}, clasificada como {clasificacion}. " | |
| ) | |
| if clasificacion == "Brillante": | |
| return base + "Explica con palabras sencillas por qué esta jugada fue tan buena." | |
| if mejor_es: | |
| dato = f", que {detalle}" if detalle else "" | |
| return base + ( | |
| f"La mejor jugada era {mejor_es}{dato}. Explica con palabras sencillas " | |
| f"qué estuvo mal en tu jugada, por qué {mejor_es} era mejor (usa ese " | |
| f"dato), y deja una lección corta y fácil de recordar." | |
| ) | |
| return base + ( | |
| "Explica con palabras sencillas qué estuvo mal en esta jugada, qué idea " | |
| "era mejor, y deja una lección corta." | |
| ) | |