Herramientas de inspección de página de AI Helper — query_page y list_structure
Un asistente de IA es tan bueno como lo que puede ver. AI Helper no trabaja a partir de una descripción vaga de la página — tiene herramientas para mirar el DOM real y tu biblioteca existente de JustZix. Esta entrada cubre las dos herramientas de inspección: query_page y list_structure.
El contexto de partida
Cada mensaje que envías ya lleva la URL de la página, el título y un fragmento HTML. Eso basta para solicitudes sencillas. Pero un fragmento es un fragmento — para un selector preciso el modelo a menudo necesita mirar más de cerca una parte concreta de la página. Para eso están las herramientas de inspección.
query_page — mira el DOM en vivo
El modelo pasa un selector CSS; la herramienta lo ejecuta contra la página actual y devuelve el número de coincidencias más el HTML de las mismas.
@@JZ_TOOL@@ {"tool": "query_page", "args": {"selector": "header .nav"}} @@END@@
resultado:
matches: 1
html: "<nav class=\"nav\"> ... </nav>"Esto convierte el adivinar en comprobar. En lugar de escribir CSS para una estructura que imagina, el modelo puede confirmar qué hay realmente: ¿existe .nav, hay uno o cinco de ellos, qué clases llevan los hijos, está el botón dentro de un envoltorio? Con eso, el selector que escribe apunta a la página real.
Cómo lo usa el modelo
- Confirmar que un elemento existe — consulta el selector, comprueba que el conteo no es cero.
- Acotar un selector — empieza amplio, lee el HTML devuelto y luego consulta algo más específico.
- Comprobar la unicidad — un conteo de 1 significa que el selector es específico; un conteo de 30 significa que es demasiado amplio para una corrección dirigida.
- Leer la estructura — ve las relaciones padre/hijo antes de escribir un selector
:has()o de descendiente.
A lo largo de un turno agéntico el modelo puede invocar query_page varias veces, refinando a medida que aprende — todo dentro del presupuesto de 8 pasos.
list_structure — lee tus reglas existentes
La segunda herramienta no mira la página, sino tu biblioteca de JustZix. list_structure devuelve tus carpetas, grupos y reglas junto con sus ids.
@@JZ_TOOL@@ {"tool": "list_structure", "args": {}} @@END@@
resultado:
folders:
- id: f_12 "Sitios de noticias"
groups:
- id: g_3 "Correcciones de diseño"
rules:
- id: r_88 "Ocultar anuncios de la barra lateral"
- id: r_90 "Columna de artículo más ancha"Por qué el modelo necesita esto:
- Evitar duplicados — si ya existe una regla similar, el modelo puede señalártela en lugar de crear otra.
- Colocar lo nuevo con sensatez — una regla nueva para un sitio de noticias puede ir a tu carpeta «Sitios de noticias» existente en lugar de dispersar reglas sueltas.
- Usar ids reales —
create_groupycreate_rulenecesitan un id padre;list_structurees de donde salen esos ids.
Es de solo lectura. Ver tu estructura no es lo mismo que cambiarla — crear una carpeta, grupo o regla sigue necesitando las herramientas de creación y tu confirmación explícita.
Por qué la inspección bajo demanda supera a volcar la página entera
Una alternativa obvia sería enviarle al modelo el HTML completo de la página de antemano. AI Helper deliberadamente no lo hace. La inspección bajo demanda gana por razones reales:
| Volcar la página entera | Inspeccionar bajo demanda |
|---|---|
| Coste enorme de tokens en cada mensaje | Pagas solo por lo que se consulta |
| El modelo se ahoga en marcado irrelevante | El modelo ve la parte que importa |
| Las páginas modernas pueden superar la ventana de contexto | Los fragmentos dirigidos siempre caben |
| Obsoleto después de que la página cambia | Cada consulta lee el DOM actual |
Una aplicación web moderna puede ser cientos de kilobytes de HTML. Meter todo eso en el contexto es lento, caro y a menudo contraproducente — la señal se entierra en el ruido. Un query_page enfocado para .cookie-banner le da al modelo exactamente las pocas líneas que necesita.
La frescura también importa
Las páginas no son estáticas. Los menús se abren, los modales aparecen, el contenido carga tarde. Como query_page se ejecuta en el momento en que se invoca, el modelo lee el DOM tal como está ahora mismo — incluidos los elementos que no existían cuando abriste el chat por primera vez. Un volcado único de la página no puede hacer eso.
La inspección alimenta el flujo de trabajo
Estas herramientas son el primer paso del flujo de trabajo agéntico más amplio: inspeccionar con query_page y list_structure, probar en un panel TEMP, pedirte que verifiques y luego persistir. Una buena inspección es lo que hace que los pasos posteriores sean precisos — el selector es correcto porque el modelo realmente miró.
Consulta también
- El flujo de trabajo agéntico completo de llamadas a herramientas
- Conoce a AI Helper — la visión general
- Construye una regla con AI Helper, paso a paso
La inspección bajo demanda es lo que mantiene a AI Helper preciso y barato. Descarga JustZix, añade una clave y pídele que mire un elemento complicado.
Valora este artículo
Sin valoraciones — sé el primero.