ui_read_tree

Scherm, vensters en interface · macOS · Windows

Effect: lezen. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Retourneert een COMPACTE toegankelijkheidsstructuur met gelabelde en interactieve elementen van een actieve native app (knoppen, koppelingen, tekstvelden, selectievakjes, menu's…) — het native equivalent van de a11y-modus van web_read. Gebruik dit om te ONTDEKKEN waarop je in een onbekende app kunt handelen wanneer je de rol of het label van een element nog niet kent (ui_find_element vereist er vooraf een). Elk interactief knooppunt bevat een `ref` die je rechtstreeks aan ui_click kunt doorgeven. Geef de app_bundle_id van een actieve app door (bijvoorbeeld com.apple.finder — zie list_windows); de structuur wordt beperkt tot knooppunten met relevante signalen en begrensd door max_depth (standaard 12) en een knooppuntenbudget, waardoor zeer grote vensters gedeeltelijk worden geretourneerd. De macOS-menubalk van de app wordt standaard overgeslagen (deze bevat honderden menuknooppunten) — geef include_menu_bar=true door als je specifiek menubalkitems wilt bedienen.

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor ui_read_tree. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{}

Windows

Doel

Retourneert een COMPACTE UI Automation-structuur met gelabelde en interactieve elementen van een actieve Windows-app (knoppen, koppelingen, invoervelden, selectievakjes, menu's…) — het native equivalent van de a11y-modus van web_read. Gebruik dit om te ONTDEKKEN waarop je in een onbekende app kunt handelen wanneer je de rol of het label van een element nog niet kent (ui_find_element vereist er vooraf een). Elk interactief knooppunt bevat een `ref` die je rechtstreeks aan ui_click kunt doorgeven. Geef `app` door (de procesnaam van een actieve app, bijvoorbeeld notepad). De structuur wordt beperkt tot knooppunten met relevante signalen en begrensd door max_depth (standaard 12) en een knooppuntenbudget, waardoor zeer grote vensters gedeeltelijk worden geretourneerd.

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

{}