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