Ir para o conteúdo
Todas as ferramentas

web_navigate

Automação Web · macOS · Windows

Efeito: envio. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Navega uma sessão web até uma URL (usando o login salvo, se houver) e retorna a URL resultante + o título da página. Abre a sessão se ela não existir. VERIFIQUE `loaded` antes de ler: quando é false a página não carregou e `message` diz o motivo — ler a sessão nesse caso descreve um documento em branco, não o site. Leia a página com web_read. Quando a chamada vem pelo conector da nuvem, um endereço deste Mac ou da sua rede local (localhost, 127.0.0.1, 192.168.x.x…) é recusado com relay_local_address, em todas as ferramentas web_*; um app de IA executado no próprio Mac não tem essa limitação.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para web_navigate. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Navega uma sessão web até uma URL (reutilizando o login salvo, se houver) e retorna a URL resultante + o título da página. Abre a sessão se ela ainda não existir. Leia a página depois com web_read. A primeira chamada retorna uma prévia e não abre nada; confirm=true navega.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para web_navigate. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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