Spaces:
Sleeping
Sleeping
Upload preguntas_amx.py
Browse files- modules/preguntas_amx.py +222 -0
modules/preguntas_amx.py
ADDED
|
@@ -0,0 +1,222 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
"""
|
| 2 |
+
preguntas_amx.py · v1.0 · 09-Jul-2026
|
| 3 |
+
─────────────────────────────────────────────────────────────────────────────
|
| 4 |
+
Catálogo de preguntas base ancladas a los capítulos REALES del
|
| 5 |
+
Reporte Anual 2025 de América Móvil, S.A.B. de C.V. (490 páginas,
|
| 6 |
+
presentado ante la BMV el 28 de abril de 2026, indexado vía T13 RAG).
|
| 7 |
+
|
| 8 |
+
REGLAS (agents.md):
|
| 9 |
+
- Toda pregunta de este catálogo DEBE ser respondible con el documento
|
| 10 |
+
indexado. Ninguna pregunta genérica de industria (McKinsey/GSMA).
|
| 11 |
+
- Cada categoría corresponde 1:1 a un capítulo real del reporte anual.
|
| 12 |
+
- El regulador vigente es la CRT (el IFT fue extinguido el 17-oct-2025);
|
| 13 |
+
las preguntas pueden mencionar ambos porque el documento cubre la
|
| 14 |
+
transición IFT→CRT explícitamente.
|
| 15 |
+
- Este módulo NO tiene dependencias externas — es importable desde
|
| 16 |
+
rag_agente.py sin riesgo. La validación RAG se hace por inyección de
|
| 17 |
+
función (validar_preguntas_rag), nunca importando ChromaDB aquí.
|
| 18 |
+
|
| 19 |
+
INTEGRACIÓN en rag_agente.py:
|
| 20 |
+
from preguntas_amx import PREGUNTAS_BASE, DOC_FUENTE
|
| 21 |
+
# PREGUNTAS_BASE reemplaza al dict anterior del menú contextual
|
| 22 |
+
# (misma forma: {categoría: [pregunta, ...]})
|
| 23 |
+
|
| 24 |
+
DEPLOY (agents.md — Regla de deploy):
|
| 25 |
+
1. Subir a mx-data-intelligence/modules/preguntas_amx.py
|
| 26 |
+
2. Agregar "preguntas_amx.py" a la lista MODULES en main.py de
|
| 27 |
+
mx-data-api — SI NO, NUNCA SE SINCRONIZA.
|
| 28 |
+
3. Restart normal ambos Spaces → verificar /version antes de probar.
|
| 29 |
+
─────────────────────────────────────────────────────────────────────────────
|
| 30 |
+
"""
|
| 31 |
+
|
| 32 |
+
# ── Metadatos del documento fuente ──────────────────────────────────────────
|
| 33 |
+
DOC_FUENTE = {
|
| 34 |
+
"titulo": "Reporte Anual América Móvil 2025 (BMV)",
|
| 35 |
+
"emisora": "América Móvil, S.A.B. de C.V.",
|
| 36 |
+
"ejercicio": "Año terminado el 31 de diciembre de 2025",
|
| 37 |
+
"presentado": "28 de abril de 2026",
|
| 38 |
+
"paginas": 490,
|
| 39 |
+
"nota": (
|
| 40 |
+
"Traducción libre de secciones relevantes de la Forma 20-F "
|
| 41 |
+
"presentada ante la SEC el 28 de abril de 2026."
|
| 42 |
+
),
|
| 43 |
+
}
|
| 44 |
+
|
| 45 |
+
# ── Estructura rica: capítulo → página → preguntas validadas ────────────────
|
| 46 |
+
# Cada pregunta fue verificada contra el texto real del documento
|
| 47 |
+
# (grep sobre el PDF indexado) antes de incluirse. NUNCA agregar
|
| 48 |
+
# preguntas sin validar primero que el contenido existe.
|
| 49 |
+
PREGUNTAS_AMX = {
|
| 50 |
+
"🏢 La Compañía": {
|
| 51 |
+
"capitulo": "Capítulo I — Información sobre la Compañía",
|
| 52 |
+
"pagina": 1,
|
| 53 |
+
"preguntas": [
|
| 54 |
+
"¿En cuántos países opera América Móvil y bajo qué marcas?",
|
| 55 |
+
"¿Cuántos usuarios tiene el segmento de servicios móviles de América Móvil?",
|
| 56 |
+
"¿Cuáles son los segmentos de negocio de América Móvil?",
|
| 57 |
+
"¿Cómo describe América Móvil sus redes y su cobertura?",
|
| 58 |
+
"¿Quiénes son los principales competidores de América Móvil?",
|
| 59 |
+
"¿Qué acuerdo celebró América Móvil con Liberty Latin America?",
|
| 60 |
+
"¿Qué adquisiciones, inversiones o enajenaciones recientes reporta la Compañía?",
|
| 61 |
+
],
|
| 62 |
+
},
|
| 63 |
+
"📊 Situación Financiera": {
|
| 64 |
+
"capitulo": "Capítulo II — Situación financiera y resultados de operación",
|
| 65 |
+
"pagina": 12,
|
| 66 |
+
"preguntas": [
|
| 67 |
+
"¿Cuál fue la utilidad neta de América Móvil en 2025 y cuánto creció frente a 2024?",
|
| 68 |
+
"¿Cuáles fueron los ingresos consolidados de América Móvil en 2025?",
|
| 69 |
+
"¿Cuál fue la utilidad por acción y el dividendo decretado por acción?",
|
| 70 |
+
"¿Cuánto invirtió América Móvil en inversiones de capital durante 2025?",
|
| 71 |
+
"¿Cuál es la deuda total y la deuda neta de América Móvil al cierre de 2025?",
|
| 72 |
+
"¿Cómo define la Compañía la deuda neta y qué razón deuda neta a UAIDA maneja?",
|
| 73 |
+
"¿Cuáles son las fuentes de liquidez y financiamiento de la Compañía?",
|
| 74 |
+
],
|
| 75 |
+
},
|
| 76 |
+
"⚠️ Factores de Riesgo": {
|
| 77 |
+
"capitulo": "Capítulo III — Factores de riesgo",
|
| 78 |
+
"pagina": 31,
|
| 79 |
+
"preguntas": [
|
| 80 |
+
"¿Qué riesgos de seguridad cibernética identifica América Móvil?",
|
| 81 |
+
"¿Qué riesgos señala la Compañía sobre la gestión de datos personales?",
|
| 82 |
+
"¿Cómo afecta el churn o desactivación de usuarios a los resultados de la Compañía?",
|
| 83 |
+
"¿Qué riesgos cambiarios enfrenta América Móvil por su deuda en moneda extranjera?",
|
| 84 |
+
"¿Qué riesgos regulatorios y de competencia describe el reporte anual?",
|
| 85 |
+
"¿Qué riesgos menciona la Compañía sobre la demanda de datos y la capacidad de sus redes?",
|
| 86 |
+
],
|
| 87 |
+
},
|
| 88 |
+
"🏛️ Estructura Accionaria": {
|
| 89 |
+
"capitulo": "Capítulo IV — Estructura accionaria",
|
| 90 |
+
"pagina": 49,
|
| 91 |
+
"preguntas": [
|
| 92 |
+
"¿Quién controla América Móvil y qué participación tiene la Familia Slim?",
|
| 93 |
+
"¿Qué es Control Empresarial de Capitales y qué papel juega en el control de la Compañía?",
|
| 94 |
+
"¿Cuál es la política de dividendos de América Móvil y qué dividendos decretó?",
|
| 95 |
+
"¿En qué mercados cotizan las acciones y los ADS de América Móvil?",
|
| 96 |
+
"¿Cuántas acciones Serie B ampara cada ADS de América Móvil?",
|
| 97 |
+
"¿Qué operaciones con personas relacionadas reporta la Compañía?",
|
| 98 |
+
"¿Cómo funciona el programa de recompra de acciones de América Móvil?",
|
| 99 |
+
],
|
| 100 |
+
},
|
| 101 |
+
"🧭 Gobierno Corporativo": {
|
| 102 |
+
"capitulo": "Capítulo V — Gobierno corporativo",
|
| 103 |
+
"pagina": 60,
|
| 104 |
+
"preguntas": [
|
| 105 |
+
"¿Quiénes integran el Consejo de Administración de América Móvil?",
|
| 106 |
+
"¿Qué comités y prácticas societarias tiene la Compañía?",
|
| 107 |
+
"¿Qué controles y procedimientos internos describe el reporte anual?",
|
| 108 |
+
"¿Cómo gestiona América Móvil la seguridad cibernética a nivel de gobierno corporativo?",
|
| 109 |
+
"¿Qué reporta la Compañía en su informe de sostenibilidad?",
|
| 110 |
+
"¿Qué establece el Código de Ética de América Móvil?",
|
| 111 |
+
"¿Qué políticas aplican a las operaciones con acciones y valores de América Móvil?",
|
| 112 |
+
],
|
| 113 |
+
},
|
| 114 |
+
"⚖️ Regulación": {
|
| 115 |
+
"capitulo": "Capítulo VI — Regulación",
|
| 116 |
+
"pagina": 76,
|
| 117 |
+
"preguntas": [
|
| 118 |
+
"¿Qué significa que América Móvil sea agente económico preponderante y qué medidas le aplican?",
|
| 119 |
+
"¿Qué es la CRT y qué pasó con el IFT según el reporte anual?",
|
| 120 |
+
"¿Cómo se regulan las tarifas de interconexión que cobra América Móvil?",
|
| 121 |
+
"¿Qué obligaciones tiene la Compañía de compartir su infraestructura con otros operadores?",
|
| 122 |
+
"¿Qué son las pruebas de replicabilidad que aplica el regulador a América Móvil?",
|
| 123 |
+
"¿Qué concesiones de espectro tiene la Compañía y qué obligaciones implican?",
|
| 124 |
+
"¿Qué cambió en la regulación de protección de datos personales y qué autoridad la vigila ahora?",
|
| 125 |
+
],
|
| 126 |
+
},
|
| 127 |
+
"📋 Información Adicional": {
|
| 128 |
+
"capitulo": "Capítulo VII — Información adicional",
|
| 129 |
+
"pagina": 98,
|
| 130 |
+
"preguntas": [
|
| 131 |
+
"¿Cuántos empleados tiene América Móvil según el reporte anual?",
|
| 132 |
+
"¿Qué procedimientos legales relevantes enfrenta la Compañía?",
|
| 133 |
+
"¿Cuánto pagó América Móvil en honorarios a su auditor externo y por qué servicios?",
|
| 134 |
+
"¿Qué políticas de aprobación tiene el Comité de Auditoría y Prácticas Societarias?",
|
| 135 |
+
"¿Qué advierte la Compañía sobre las declaraciones con respecto al futuro?",
|
| 136 |
+
],
|
| 137 |
+
},
|
| 138 |
+
"🇲🇽 Mercado Mexicano": {
|
| 139 |
+
"capitulo": "Capítulo VIII — Información para el mercado mexicano",
|
| 140 |
+
"pagina": 102,
|
| 141 |
+
"preguntas": [
|
| 142 |
+
"¿Qué tipo de cambio peso-dólar utiliza el reporte anual y cuál fue al cierre de 2025?",
|
| 143 |
+
"¿Cómo se compararon los resultados de operación de 2024 frente a 2023?",
|
| 144 |
+
"¿Cuáles son las principales políticas contables y estimaciones de la Compañía?",
|
| 145 |
+
"¿Cómo se comportaron las acciones de América Móvil en la BMV y el NYSE?",
|
| 146 |
+
"¿Cómo está integrado el capital social de América Móvil?",
|
| 147 |
+
"¿Qué certificados bursátiles y otros valores tiene inscritos la Compañía?",
|
| 148 |
+
"¿Qué política de inclusión laboral reporta América Móvil?",
|
| 149 |
+
],
|
| 150 |
+
},
|
| 151 |
+
}
|
| 152 |
+
|
| 153 |
+
# ── Compatibilidad con el menú contextual existente en rag_agente.py ────────
|
| 154 |
+
# Misma forma que el dict anterior: {categoría: [pregunta, ...]}
|
| 155 |
+
PREGUNTAS_BASE = {
|
| 156 |
+
categoria: bloque["preguntas"] for categoria, bloque in PREGUNTAS_AMX.items()
|
| 157 |
+
}
|
| 158 |
+
|
| 159 |
+
|
| 160 |
+
def total_preguntas() -> int:
|
| 161 |
+
"""Número total de preguntas del catálogo."""
|
| 162 |
+
return sum(len(p) for p in PREGUNTAS_BASE.values())
|
| 163 |
+
|
| 164 |
+
|
| 165 |
+
def capitulo_de(categoria: str) -> str:
|
| 166 |
+
"""Devuelve el capítulo real del reporte anual al que pertenece una categoría."""
|
| 167 |
+
bloque = PREGUNTAS_AMX.get(categoria)
|
| 168 |
+
return bloque["capitulo"] if bloque else ""
|
| 169 |
+
|
| 170 |
+
|
| 171 |
+
def validar_preguntas_rag(search_fn, top_k: int = 3, umbral_chars: int = 200):
|
| 172 |
+
"""
|
| 173 |
+
Valida el catálogo completo contra el documento indexado (T13).
|
| 174 |
+
|
| 175 |
+
NO importa ChromaDB ni rag_documentos aquí — recibe la función de
|
| 176 |
+
búsqueda por inyección para evitar acoplamiento y duplicación de
|
| 177 |
+
lógica (regla agents.md: nunca fallback con lógica duplicada).
|
| 178 |
+
|
| 179 |
+
Args:
|
| 180 |
+
search_fn: callable(pregunta: str, top_k: int) -> str | list
|
| 181 |
+
Típicamente el tool `search_documentos_usuario` o la
|
| 182 |
+
función de consulta de rag_documentos.py.
|
| 183 |
+
top_k: número de chunks a recuperar por pregunta.
|
| 184 |
+
umbral_chars: mínimo de caracteres recuperados para considerar
|
| 185 |
+
la pregunta respondible.
|
| 186 |
+
|
| 187 |
+
Returns:
|
| 188 |
+
dict con:
|
| 189 |
+
"ok": lista de (categoría, pregunta) respondibles
|
| 190 |
+
"fallan": lista de (categoría, pregunta, motivo) NO respondibles
|
| 191 |
+
Uso (dentro del Space, una sola vez tras indexar):
|
| 192 |
+
from rag_documentos import buscar_documentos
|
| 193 |
+
from preguntas_amx import validar_preguntas_rag
|
| 194 |
+
reporte = validar_preguntas_rag(lambda q, k: buscar_documentos(q, top_k=k))
|
| 195 |
+
print(len(reporte["fallan"]), "preguntas sin sustento — revisar")
|
| 196 |
+
"""
|
| 197 |
+
resultado = {"ok": [], "fallan": []}
|
| 198 |
+
for categoria, preguntas in PREGUNTAS_BASE.items():
|
| 199 |
+
for pregunta in preguntas:
|
| 200 |
+
try:
|
| 201 |
+
res = search_fn(pregunta, top_k)
|
| 202 |
+
except Exception as exc: # error de búsqueda ≠ pregunta inválida
|
| 203 |
+
resultado["fallan"].append((categoria, pregunta, f"error: {exc}"))
|
| 204 |
+
continue
|
| 205 |
+
texto = res if isinstance(res, str) else " ".join(str(r) for r in (res or []))
|
| 206 |
+
if len(texto.strip()) >= umbral_chars:
|
| 207 |
+
resultado["ok"].append((categoria, pregunta))
|
| 208 |
+
else:
|
| 209 |
+
resultado["fallan"].append(
|
| 210 |
+
(categoria, pregunta, f"recuperó {len(texto.strip())} chars < {umbral_chars}")
|
| 211 |
+
)
|
| 212 |
+
return resultado
|
| 213 |
+
|
| 214 |
+
|
| 215 |
+
if __name__ == "__main__":
|
| 216 |
+
# Autodiagnóstico sin dependencias
|
| 217 |
+
print(f"Documento fuente : {DOC_FUENTE['titulo']}")
|
| 218 |
+
print(f"Categorías : {len(PREGUNTAS_BASE)}")
|
| 219 |
+
print(f"Total preguntas : {total_preguntas()}")
|
| 220 |
+
for cat, bloque in PREGUNTAS_AMX.items():
|
| 221 |
+
print(f" {cat} · {bloque['capitulo']} (pág. {bloque['pagina']}) · {len(bloque['preguntas'])} preguntas")
|
| 222 |
+
|