Spaces:
Sleeping
Sleeping
Download modules/preguntas_amx.py from Fercor95mx/mx-data-api: direct link, hf CLI and curl.
- Browser
- Download file 12 kB
-
https://huggingface.co/spaces/Fercor95mx/mx-data-api/resolve/main/modules/preguntas_amx.py
- Command line
-
hf download hf://spaces/Fercor95mx/mx-data-api/modules/preguntas_amx.py
-
curl -L -o preguntas_amx.py https://huggingface.co/spaces/Fercor95mx/mx-data-api/resolve/main/modules/preguntas_amx.py
12 kB
| """ | |
| 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") | |