Saltar al contenido
Todas las herramientas

web_navigate

Automatización web · macOS · Windows

Efecto: envío. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Navega una sesión web a una URL (usando su inicio de sesión guardado, si lo hay) y devuelve la URL resultante y el título de la página. Abre la sesión si no existe. COMPRUEBA `loaded` antes de leer: cuando es false, la página no cargó y `message` explica por qué; leer la sesión entonces describe un documento en blanco, no el sitio. Lee la página con web_read. Cuando la llamada llega a través del conector en la nube, una dirección de este Mac o de su red local (localhost, 127.0.0.1, 192.168.x.x…) se rechaza con relay_local_address, en todas las herramientas web_*; una app de IA que se ejecuta en el propio Mac no tiene ese límite.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — macOS
{
  "properties": {
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait for load (default 25).",
      "type": "integer"
    },
    "url": {
      "description": "URL to open (https).",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para web_navigate. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "session": "demo-browser",
  "url": "https://example.com"
}

Windows

Propósito

Navega una sesión web a una URL (reutilizando su inicio de sesión guardado, si lo hay) y devuelve la URL resultante y el título de la página. Abre la sesión si todavía no existe. Lee la página después con web_read. La primera llamada devuelve una vista previa y no abre nada; confirm=true navega.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — Windows
{
  "properties": {
    "confirm": {
      "description": "Must be true to act. Without it, returns a preview.",
      "type": "boolean"
    },
    "session": {
      "description": "Session name (a named login profile). Defaults to 'default'.",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait for the page to load (default 25).",
      "type": "integer"
    },
    "url": {
      "description": "URL to open (https assumed if no scheme).",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para web_navigate. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "session": "demo-browser",
  "url": "https://example.com"
}