← Todos los artículos

Guías

El flujo de trabajo agéntico de llamadas a herramientas de AI Helper explicado

17 mayo 2026 · por JustZix Team

Un chat que solo responde con texto es útil. Un chat que puede inspeccionar la página, escribir código en una ventana TEMP en vivo y guardar para ti una regla terminada es otra cosa. AI Helper hace lo segundo mediante un flujo de trabajo agéntico de llamadas a herramientas. Así funciona.

Qué significa «agéntico» aquí

Cuando envías un mensaje, el modelo no tiene por qué responder de una sola vez. Puede decidir que necesita información — invocar una herramienta para conseguirla — leer el resultado y continuar. Ese ciclo de pensar → actuar → observar → pensar es el bucle agéntico. En AI Helper el bucle se ejecuta hasta 8 pasos por turno, y luego el modelo debe darte una respuesta final. El límite mantiene un turno acotado y predecible.

El protocolo de herramientas

Cada proveedor tiene su propio formato nativo de llamada a funciones, y no coinciden. Para evitar tres rutas de código separadas, AI Helper usa un único protocolo de texto independiente del proveedor. El modelo emite una llamada a herramienta como un bloque etiquetado:

@@JZ_TOOL@@ {"tool": "query_page", "args": {"selector": ".cookie-banner"}} @@END@@

La extensión analiza ese bloque, ejecuta la herramienta y devuelve el resultado a la conversación para que el modelo pueda continuar. Como es solo texto, exactamente el mismo prompt y la misma lógica de análisis funcionan de forma idéntica para OpenAI, Anthropic y Gemini — cambia de proveedor a mitad del chat y el flujo de trabajo no cambia.

Las herramientas

AI Helper expone un conjunto pequeño y enfocado de herramientas. Se dividen en tres grupos.

Inspección

• query_page — le das un selector CSS y obtienes el número de coincidencias y el HTML de las mismas. Así es como el modelo mira el DOM en vivo bajo demanda.
• list_structure — devuelve tus carpetas, grupos y reglas existentes con sus ids, para que el modelo sepa qué existe ya y dónde podrían ir las cosas nuevas.

Pruebas en vivo

• open_temp_pane — abre una ventana TEMP CSS o JS en la página.
• set_temp_pane_code — escribe código en ese panel TEMP. La página se actualiza de inmediato, así que ves el cambio propuesto por el modelo en el sitio real antes de que se guarde nada.

Persistencia (con tu confirmación)

• create_folder — crea una carpeta.
• create_group — crea un grupo dentro de una carpeta.
• create_rule — crea una regla con CSS y/o JS y un patrón de URL.

Cada una de estas tres requiere una confirmación de usuario separada y explícita. El modelo no puede escribir en silencio en tu biblioteca — cada carpeta, cada grupo, cada regla es un sí deliberado de tu parte. Crear acciones o barras de acciones no forma parte de esta etapa; las herramientas cubren carpetas, grupos y reglas con CSS y JS.

El flujo de trabajo que dirige el prompt de sistema

Las herramientas son solo la mitad de la historia — el prompt de sistema le dice al modelo cómo usarlas en orden:

1. Pedir detalles — aclara qué quieres realmente antes de tocar nada.
2. Inspeccionar la página — usa query_page para confirmar la estructura real en lugar de adivinar.
3. Probar en una ventana TEMP — abre un panel, pon el código, deja que lo veas en vivo.
4. Pedirte que verifiques — «¿se ve bien la página ahora?»
5. Persistir solo después de que estés de acuerdo — y solo entonces invocar una herramienta de creación, con su propia confirmación.

Este es el mismo camino que sigue un humano cuidadoso: mirar primero, probar después, guardar al final.

Un turno, paso a paso

Turno: "haz que la sección de comentarios sea plegable"

paso 1  query_page    .comments        -> 1 coincidencia, HTML devuelto
paso 2  open_temp_pane  css            -> se abre ventana TEMP CSS
paso 3  set_temp_pane_code  ...        -> CSS de plegado inyectado en vivo
paso 4  (texto) "Añadí un interruptor de plegado - revisa la página."
        --- el modelo se detiene, espera por ti ---
Tú: "bien, guárdalo"
paso 5  list_structure                 -> lee tus carpetas/ids
paso 6  create_rule  (¿confirmar?)     -> haces clic en confirmar -> guardado

Seis pasos usados, dos restantes en el presupuesto. Si un turno alguna vez alcanza el límite de 8 pasos, el modelo concluye con lo que tiene y te dice cómo está la situación.

Chips de llamadas a herramientas

Nunca estás adivinando qué hizo el modelo. Cada llamada a una herramienta y su resultado se renderizan como un chip en la ventana de chat — una tarjeta compacta que muestra el nombre de la herramienta, sus argumentos y un resumen de lo que devolvió. Desplázate por la conversación y puedes auditar el turno entero: qué selector se consultó, qué código entró en qué panel, qué regla se creó.

Por qué te importa el protocolo de texto

Las herramientas independientes del proveedor no son solo un detalle de implementación. Significa que puedes elegir un proveedor por motivos de coste o calidad y la capacidad agéntica es idéntica. Sin advertencias del tipo «las llamadas a herramientas solo funcionan en el proveedor X». Cambia en la ventana de chat a mitad de tarea y sigue adelante.

Consulta también

• Las herramientas de inspección de página en profundidad
• Construye una regla con AI Helper, paso a paso
• Probar en ventanas TEMP antes de guardar

El flujo de trabajo agéntico está integrado en AI Helper hoy. Descarga JustZix, añade una clave de API y pídele que construya algo — luego observa los chips.