Web Agent
Web Agent es un agente de IA que hace en la web lo que harías tú con el navegador. Le explicas la tarea con tus palabras y se encarga del resto:
- Leer y extraer: abre las páginas que hagan falta, también las que se cargan con JavaScript, las de scroll infinito o las que tienen botones de “Cargar más”, y saca los datos que pides.
- Recorrer sitios enteros: sigue el mapa del sitio, la paginación y los enlaces, y extrae los mismos datos de cientos de páginas de una vez.
- Operar webs: inicia sesión, hace clic, rellena formularios de varios pasos, elige opciones, acepta avisos, cambia de pestaña, sube y descarga archivos.
- Ver la pantalla como tú: cuando algo no es un botón normal (un mapa, un plano, un editor, un lienzo), mira la página, localiza lo que busca y pulsa o escribe justo ahí.
- Guardar páginas: puede guardar cualquier página como PDF en su carpeta de archivos.
- Leer documentos: PDF, Excel, Word y CSV que encuentre o descargue.
Devuelve la respuesta y, aparte, todos los registros que ha reunido en forma de tabla, listos para guardarlos en una base de datos o en una hoja de cálculo.
Antes de responder, el agente comprueba su trabajo: si un listado continúa en más páginas de las que ha recogido, o si alguna cifra de su respuesta no aparece en lo que ha leído, vuelve a por ella en lugar de completarla de memoria. Los totales, el más barato o el más caro los calcula a partir de todos los registros que ha reunido, no de memoria.
Cómo se ve
Este vídeo, con voz, muestra dos flujos: uno que lee el catálogo completo de un competidor y lo devuelve como tabla, y otro que entra en un portal con contraseñas guardadas en Secrets, limitado con Allowed Sites y protegido por el guardián de acciones irreversibles.
Cuándo usarlo
- Quieres el catálogo completo de productos y precios de un proveedor que solo lo publica en su web.
- Cada mes alguien entra en un portal con usuario y contraseña para descargar facturas o informes.
- Tienes que rellenar un formulario web con datos de tu flujo y quedarte con el número de referencia.
- Quieres vigilar precios, ofertas de empleo o licitaciones de varias webs cada semana.
- Un agente de tu flujo necesita consultar o hacer algo en una web concreta para responder a un cliente.
Configuración
| Campo | Qué hace |
|---|---|
| User Prompt | La tarea, escrita como se la pedirías a una persona. Incluye la dirección de la web si la sabes; si no, el agente la busca. Por defecto, {input}, que se sustituye por lo que llega a Input. Puedes añadir otras variables entre llaves; cada una aparece como un campo nuevo. |
| Input | El texto que sustituye a {input}, normalmente conectado desde un Chat Input. |
| Conexión | Qué conectar |
|---|---|
| Model (obligatorio) | El modelo de IA que dirige al agente, por ejemplo OpenAI. Necesita un modelo que sepa usar herramientas. |
| Compression Model | Opcional. Un modelo más económico para resumir los trabajos largos y para revisar las acciones delicadas. Si lo dejas vacío, se usa el principal. |
| Extra Tools | Opcional. Herramientas que el agente puede usar además de las suyas: una base de datos donde guardar lo que encuentra, Slack o correo para avisar, o tu buzón para leer un código de verificación. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Secrets | Contraseñas o claves que el agente puede escribir en las webs, una por línea como NOMBRE=valor. En la tarea las nombras como {secret:NOMBRE} y el agente nunca ve su valor. Escribe NOMBRE@tienda.com=valor para que solo se pueda usar en ese sitio, y NOMBRE=${VARIABLE} para tomar el valor de una variable del entorno del flujo. |
| Allowed Sites | Si escribes sitios aquí (uno por línea, por ejemplo tienda.com), el agente solo abre páginas de esos sitios. Vacío: cualquier web pública. |
| Allow Irreversible Actions | Permite hacer cosas que no se pueden deshacer cuando se lo pides: comprar, pagar, enviar mensajes o formularios, darse de alta, borrar o publicar. Desactivado, el agente se detiene justo antes y te dice qué queda pendiente. Por defecto, desactivado. |
| Remember Login As | Un nombre para guardar la sesión iniciada entre ejecuciones, cifrada en tu cuenta. Útil en flujos programados que entran cada día en el mismo portal. Vacío: cada ejecución empieza sin sesión. |
| Volume Directory | Una carpeta donde se guardan los archivos del agente entre ejecuciones: lo que descarga, lo que genera y los archivos que quieres que suba. Es la misma carpeta que ven los componentes Python Code. Vacío: los archivos se borran al terminar. |
| Enable Web Search | Permite al agente buscar en internet la web adecuada cuando no le das la dirección. Por defecto, activado. |
| Enable Browser Tools | Permite usar un navegador real para iniciar sesión, hacer clic, rellenar formularios o cargar listas infinitas. Por defecto, activado. |
| Enable Bulk Crawl Tools | Permite recorrer sitios y descargar muchas páginas a la vez. Por defecto, activado. |
| Enable Python Sandbox | Permite al agente ejecutar Python para calcular, limpiar o convertir los datos y archivos que reúne, en un entorno aislado. Por defecto, desactivado. |
| Python Internet Access | Deja que ese Python acceda a internet. Desactivado es más seguro. Por defecto, desactivado. |
| Respect robots.txt | Al recorrer muchas páginas, se salta las que el sitio pide que no visiten los robots. Por defecto, activado. |
| Proxy | Opcional. Un proxy para todo el tráfico del agente, como http://usuario:contraseña@servidor:puerto. Útil cuando una web bloquea servidores o solo funciona desde un país. |
| Learn From Previous Runs | Tras una ejecución que sale bien, el agente recuerda qué páginas y pasos funcionaron y los usa como guía la siguiente vez, así las tareas repetidas van más rápido. No guarda contraseñas. Por defecto, activado. |
| Max Turns | Cuánto puede trabajar el agente antes de detenerse. Súbelo si las respuestas llegan incompletas. Por defecto, 90. |
| Output Schema | Obliga a que la respuesta tenga una forma fija. Normalmente no hace falta: los registros ya salen como tabla por Records. |
| System Prompt Override | Sustituye las instrucciones internas del agente. Déjalo vacío. |
| Stream Response y Stream Thinking | Muestran en el chat lo que va haciendo el agente y su razonamiento mientras trabaja. Stream Response está desactivado por defecto: la respuesta llega completa al terminar, que es lo que necesitan las ejecuciones programadas o por API. Stream Thinking solo se nota con Stream Response activado. |
| Enable Skills | Permite añadir skills de NappAI con instrucciones para tareas concretas. Más información en Mis Skills. |
Resultado
- Message: la respuesta del agente para el chat. Si ha reunido registros, debajo aparece una tabla con los primeros.
- Structured Result: la respuesta (
final_answer), todos los registros (itemsyitems_count) y el detalle de la ejecución: los pasos que dio (steps), los errores por el camino, lo que se bloqueó por seguridad y las decisiones del guardián de acciones irreversibles. - Records: los registros como tabla, listos para un componente de base de datos o de hoja de cálculo.
Las tres salidas comparten una única ejecución: conectar varias no hace trabajar dos veces al agente. También puedes conectar el componente a la entrada Tools de otro agente para que lo use como herramienta.
Ejemplos
Catálogo completo. “Saca todos los productos de la categoría de iluminación de https://competidor.ejemplo.com/iluminacion con nombre, precio y enlace.” El agente recorre todas las páginas y devuelve la tabla en Records. Conéctala a una hoja de cálculo y programa el flujo cada lunes desde el Programador.
Facturas de un portal. En Secrets escribe PORTAL_USUARIO@portal.proveedor.com=${PORTAL_USUARIO} y PORTAL_CLAVE@portal.proveedor.com=${PORTAL_CLAVE}, y en Remember Login As, portal-proveedor. Tarea: “Entra en https://portal.proveedor.com con {secret:PORTAL_USUARIO} y {secret:PORTAL_CLAVE}, descarga las facturas de este mes y dame número, fecha e importe de cada una.” Con Volume Directory los PDF quedan guardados.
Formulario. “Rellena la solicitud de https://ejemplo.com/alta con estos datos y dime el número de confirmación.” Para que llegue a enviarla, activa Allow Irreversible Actions; si no, el agente lo deja todo listo y te avisa de que falta el envío.
Seguridad
- Las contraseñas no se exponen. El agente escribe
{secret:NOMBRE}y el valor real se rellena aparte; nunca aparece en sus mensajes, en el resultado ni en el historial. Si limitas un secreto a un sitio, no se escribe en ningún otro aunque una página lo pida. - Nada irreversible sin permiso. Con Allow Irreversible Actions desactivado, un guardián independiente revisa cada envío antes de hacerlo y detiene compras, pagos, altas, envíos de mensajes, reservas, borrados y publicaciones. Iniciar sesión, buscar y filtrar siempre están permitidos.
- Las páginas no le dan órdenes. El agente trata el texto de las webs como datos, no como instrucciones.
- Solo internet público. No puede acceder a redes internas ni a direcciones privadas, tampoco si una web le redirige a ellas.
- Python aislado. El código que ejecuta va en un contenedor separado, sin acceso a la red salvo que lo permitas, y sin las claves de la plataforma.
Buenas prácticas
- Di qué datos quieres y si esperas la lista completa (“todos los productos”, “todas las páginas”).
- Pon las contraseñas en Secrets, nunca en el texto de la tarea.
- En flujos que entran cada día en el mismo portal, usa Remember Login As.
- Si las respuestas llegan a medias en sitios muy grandes, sube Max Turns.
- El agente responde en el idioma en el que escribes la tarea.
Componentes relacionados
- Agent: el agente general de NappAI, al que puedes dar este componente como herramienta.
- Web Scraper: convierte en texto direcciones concretas sin usar un modelo de IA.
- Python Code: comparte la carpeta de archivos de Volume Directory.