web_navigate

Automatisation web · macOS · Windows

Effet: envoi. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Fait naviguer une session web vers une URL (en utilisant sa connexion enregistrée, le cas échéant) et renvoie l’URL obtenue + le titre de la page. Ouvre la session si elle n’existe pas. VÉRIFIEZ `loaded` avant de lire : lorsqu’il vaut false, la page ne s’est pas chargée et `message` en donne la raison — lire alors la session décrit un document vide, pas le site. Lisez la page avec web_read. Lorsque l’appel passe par le connecteur cloud, une adresse de ce Mac ou de son réseau local (localhost, 127.0.0.1, 192.168.x.x…) est refusée avec relay_local_address, pour tous les outils web_* ; une app d’IA exécutée sur le Mac lui-même n’est pas limitée.

Entrées requises

url

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour web_navigate. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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

Windows

Objectif

Fait naviguer une session web vers une URL (en réutilisant sa connexion enregistrée, le cas échéant) et renvoie l’URL obtenue + le titre de la page. Ouvre la session si elle n’existe pas encore. Lisez ensuite la page avec web_read. Le premier appel renvoie un aperçu et n’ouvre rien ; confirm=true navigue.

Entrées requises

url

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

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