Saltearse al contenido

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

CampoQué hace
User PromptLa 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.
InputEl texto que sustituye a {input}, normalmente conectado desde un Chat Input.
ConexiónQué conectar
Model (obligatorio)El modelo de IA que dirige al agente, por ejemplo OpenAI. Necesita un modelo que sepa usar herramientas.
Compression ModelOpcional. 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 ToolsOpcional. 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

CampoQué hace
SecretsContraseñ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 SitesSi 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 ActionsPermite 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 AsUn 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 DirectoryUna 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 SearchPermite al agente buscar en internet la web adecuada cuando no le das la dirección. Por defecto, activado.
Enable Browser ToolsPermite usar un navegador real para iniciar sesión, hacer clic, rellenar formularios o cargar listas infinitas. Por defecto, activado.
Enable Bulk Crawl ToolsPermite recorrer sitios y descargar muchas páginas a la vez. Por defecto, activado.
Enable Python SandboxPermite 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 AccessDeja que ese Python acceda a internet. Desactivado es más seguro. Por defecto, desactivado.
Respect robots.txtAl recorrer muchas páginas, se salta las que el sitio pide que no visiten los robots. Por defecto, activado.
ProxyOpcional. 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 RunsTras 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 TurnsCuánto puede trabajar el agente antes de detenerse. Súbelo si las respuestas llegan incompletas. Por defecto, 90.
Output SchemaObliga a que la respuesta tenga una forma fija. Normalmente no hace falta: los registros ya salen como tabla por Records.
System Prompt OverrideSustituye las instrucciones internas del agente. Déjalo vacío.
Stream Response y Stream ThinkingMuestran 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 SkillsPermite 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 (items y items_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.