Paso Agente IA: investigar la web - Insurance Boosters API

El paso browser.use pone a trabajar a un agente de IA autónomo: describe la tarea en lenguaje natural y el agente navega sitios web por su cuenta hasta completarla. Úsalo cuando una automatización necesite investigar información pública, interactuar con una página dinámica o descargar archivos. Si el proceso es siempre el mismo sobre un portal conocido (login, reportes, descargas), usa mejor el paso Agente IA: automatizar portal. El paso se ejecuta de forma asíncrona. La automatización espera el resultado sin mantener una petición HTTP abierta y continúa cuando la tarea termina.

Campos del paso

Campo	Requerido	Descripción
`actionKey`	Sí	Debe ser `browser.use`.
`task`	Sí	Instrucción que debe completar el navegador. Acepta plantillas `{{...}}`.
`resultSchema`	Sí	JSON Schema con `type: "object"` que define el output esperado.
`wait`	Sí	Configuración de espera y consulta del resultado.
`wait.initialDelaySeconds`	No	Segundos antes de consultar el resultado por primera vez. Predeterminado: `30`.
`wait.pollIntervalSeconds`	No	Segundos entre consultas posteriores. Predeterminado: `15`.
`wait.timeoutSeconds`	No	Tiempo total máximo desde que inicia la tarea. Predeterminado: `3600`.

wait.timeoutSeconds debe ser mayor que wait.initialDelaySeconds.

Ejemplo

Este paso investiga un prospecto creado en un tablero:

{
  "actionKey": "browser.use",
  "task": "Investiga en fuentes públicas al prospecto {{trigger.body.record.values.<fieldId>}}. Devuelve su sitio oficial, industria, descripción, ubicación y fuentes. No inventes datos.",
  "resultSchema": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "prospectName",
      "website",
      "industry",
      "description",
      "location",
      "sources"
    ],
    "properties": {
      "prospectName": { "type": "string" },
      "website": { "type": "string" },
      "industry": { "type": "string" },
      "description": { "type": "string" },
      "location": { "type": "string" },
      "sources": {
        "type": "array",
        "items": { "type": "string" }
      }
    }
  },
  "wait": {
    "initialDelaySeconds": 30,
    "pollIntervalSeconds": 15,
    "timeoutSeconds": 3600
  }
}

Especifica qué fuentes debe priorizar y cómo representar datos no encontrados. Un schema pequeño y preciso produce outputs más fáciles de reutilizar.

Salida del paso

El objeto validado con resultSchema se guarda directamente como output. La API agrega _files con los archivos descargados durante la tarea:

{
  "prospectName": "Acme Seguros",
  "website": "https://www.ejemplo.com",
  "industry": "Seguros",
  "description": "Empresa dedicada a seguros empresariales.",
  "location": "Ciudad de México, México",
  "sources": [
    "https://www.ejemplo.com/nosotros"
  ],
  "_files": [
    {
      "name": "reporte.pdf",
      "mimeType": "application/pdf",
      "size": 184320,
      "storagePath": "workflow-runs/<run-id>/steps/0/browser/<archivo>"
    }
  ]
}

_files siempre es un arreglo. Si la tarea no descarga archivos, devuelve []. No declares _files dentro de resultSchema: es un campo reservado que agrega la API.

Usar el resultado en otro paso

Los pasos posteriores leen el JSON directamente con {{steps.N.output.*}}:

{
  "actionKey": "code.javascript",
  "input": {
    "prospectName": "{{steps.0.output.prospectName}}",
    "website": "{{steps.0.output.website}}",
    "sources": "{{steps.0.output.sources}}",
    "files": "{{steps.0.output._files}}"
  },
  "code": "output = { enriched: true, ...input };"
}

No necesitas capture para consumir la salida de browser.use.

Configurar `wait`

wait controla cuándo consulta la automatización el estado de la tarea:

{
  "wait": {
    "initialDelaySeconds": 600,
    "pollIntervalSeconds": 30,
    "timeoutSeconds": 7200
  }
}

En este ejemplo, la primera consulta ocurre después de 10 minutos. Si todavía no termina, vuelve a consultar cada 30 segundos y espera como máximo 2 horas desde el inicio. Usa un retraso inicial mayor cuando sabes que el portal o la investigación tardará varios minutos.

Errores frecuentes

Situación	Qué hacer
El resultado no cumple `resultSchema`	Ajusta la tarea o el schema para que describan exactamente la misma estructura.
La tarea supera `timeoutSeconds`	Aumenta el timeout o reduce el alcance de la tarea.
Una plantilla resuelve vacío	Confirma que la ruta existe en el trigger o en el output anterior.
El output es demasiado grande	Solicita solo campos útiles y usa archivos para contenido extenso.
El sitio requiere autenticación interactiva	En esta versión, usa sitios accesibles sin login o solicita un flujo de integración compatible.

​Campos del paso

​Ejemplo

​Salida del paso

​Usar el resultado en otro paso

​Configurar wait

​Errores frecuentes

​Relacionado

Campos del paso

Ejemplo

Salida del paso

Usar el resultado en otro paso

Configurar `wait`

Errores frecuentes

Relacionado