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