ui_read_tree
Écran, fenêtres et interface · macOS · Windows
Effet: lecture. É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
Renvoie une arborescence d'accessibilité COMPACT des éléments étiquetés + interactifs d'une application native en cours d'exécution (boutons, liens, champs de texte, cases à cocher, menus…) - l'équivalent natif du mode a11y de web_read. Utilisez-le pour DISCOVER sur quoi agir dans une application inconnue lorsque vous ne connaissez pas déjà le rôle/l'étiquette d'un élément (ui_find_element en a besoin à l'avance). Chaque nœud interactif porte un « ref » que vous pouvez transmettre directement à ui_click. Transmettez app_bundle_id d'une application en cours d'exécution (par exemple com.apple.finder — voir list_windows) ; l'arbre est élagué aux nœuds porteurs de signaux et délimité par max_depth (par défaut 12) et un budget de nœud, donc les très grandes fenêtres renvoient une partie. La barre de menus macOS de l'application est ignorée par défaut (il s'agit de centaines de nœuds d'éléments de menu) — transmettez include_menu_bar=true si vous devez spécifiquement agir sur les éléments de la barre de menus.
Entrées requises
Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.
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": {
"app_bundle_id": {
"description": "Bundle id of a RUNNING app (e.g. com.apple.finder)",
"type": "string"
},
"include_menu_bar": {
"description": "Include the app's macOS menu bar (hundreds of menu-item nodes). Default false.",
"type": "boolean"
},
"max_depth": {
"description": "Max tree depth to descend (default 12, max 20)",
"type": "integer"
},
"window_id": {
"description": "Alternative to app_bundle_id: a window id from list_windows (targets that window's app)",
"type": "string"
}
},
"required": [],
"type": "object"
}Exemple documentaire
Exemple de documentation pour ui_read_tree. 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.
{}Windows
Objectif
Renvoie une arborescence COMPACT UI Automation des éléments étiquetés + interactifs d'un Windows app en cours d'exécution (boutons, liens, modifications, cases à cocher, menus…) - l'équivalent natif du mode a11y de web_read. Utilisez-le pour DISCOVER sur quoi agir dans un app inconnu lorsque vous ne connaissez pas déjà le rôle/l'étiquette d'un élément (ui_find_element en a besoin à l'avance). Chaque nœud interactif porte un « ref » que vous pouvez transmettre directement à ui_click. Transmettez `app` (le nom d'un processus app en cours d'exécution, par exemple le bloc-notes). L'arborescence est élaguée aux nœuds porteurs de signaux et délimitée par max_depth (par défaut 12) et un budget de nœud, de sorte que les très grandes fenêtres renvoient une partie.
Entrées requises
Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.
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 — Windows
{
"properties": {
"app": {
"description": "Process name of a RUNNING app (e.g. notepad).",
"type": "string"
},
"max_depth": {
"description": "Max tree depth to descend (default 12, max 20).",
"type": "integer"
}
},
"required": [],
"type": "object"
}Exemple documentaire
Exemple de documentation pour ui_read_tree. 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.
{}