""" 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")