Fercor95mx commited on
Commit
c48ea10
·
verified ·
1 Parent(s): 3995911

Upload preguntas_amx.py

Browse files
Files changed (1) hide show
  1. 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
+