Vai al contenuto
Tutti gli strumenti

web_navigate

Automazione web · macOS · Windows

Effetto: invio. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Porta una sessione web su un URL (usando l'accesso salvato, se presente) e restituisce l'URL risultante + il titolo della pagina. Apre la sessione se non esiste. CONTROLLA `loaded` prima di leggere: quando è false la pagina non si è caricata e `message` ne spiega il motivo; leggere la sessione in quel caso descrive un documento vuoto, non il sito. Leggi la pagina con web_read. Quando la chiamata arriva tramite il connettore cloud, un indirizzo di questo Mac o della sua rete locale (localhost, 127.0.0.1, 192.168.x.x…) viene rifiutato con relay_local_address, per ogni strumento web_*; un'app di IA in esecuzione sul Mac stesso non ha questo limite.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per web_navigate. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows

Scopo

Porta una sessione web su un URL (riutilizzando l'accesso salvato, se presente) e restituisce l'URL risultante + il titolo della pagina. Apre la sessione se non esiste ancora. Leggi la pagina in seguito con web_read. La prima chiamata restituisce un'anteprima e non apre nulla; confirm=true naviga.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per web_navigate. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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