모든 도구

ui_read_tree

화면, 윈도우 및 인터페이스 · macOS · Windows

효과: 읽기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

실행 중인 네이티브 앱의 레이블이 있거나 상호작용 가능한 요소(버튼, 링크, 텍스트 필드, 체크박스, 메뉴 등)를 간결한 접근성 트리로 반환합니다. web_read의 a11y 모드에 해당하는 네이티브 기능입니다. 익숙하지 않은 앱에서 요소 역할/레이블을 미리 모를 때(ui_find_element에는 이를 미리 지정해야 함) 조작 대상을 찾는 데 사용하세요. 각 상호작용 노드의 `ref`를 ui_click에 바로 전달할 수 있습니다. 실행 중인 앱의 app_bundle_id(예: com.apple.finder, list_windows 참조)를 전달하세요. 트리는 신호가 있는 노드만 남기며 max_depth(기본 12)와 노드 예산으로 제한되어 큰 창은 일부만 반환합니다. macOS 메뉴 막대는 수백 개 노드라 기본적으로 생략됩니다. 메뉴 막대 항목을 조작해야 할 때만 include_menu_bar=true를 전달하세요.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

영문 정식 기술 스키마 — 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"
}

문서 예시

ui_read_tree 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{}

Windows

목적

실행 중인 Windows 앱의 레이블이 있거나 상호작용 가능한 요소(버튼, 링크, 편집 필드, 체크박스, 메뉴 등)를 간결한 UI Automation 트리로 반환합니다. web_read의 a11y 모드에 해당하는 네이티브 기능입니다. 익숙하지 않은 앱에서 요소 역할/레이블을 미리 모를 때(ui_find_element에는 이를 미리 지정해야 함) 조작 대상을 찾는 데 사용하세요. 각 상호작용 노드의 `ref`를 ui_click에 바로 전달할 수 있습니다. 실행 중인 앱 프로세스 이름(예: notepad)을 `app`에 전달하세요. 트리는 신호가 있는 노드만 남기며 max_depth(기본 12)와 노드 예산으로 제한되므로 매우 큰 창은 일부만 반환합니다.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

영문 정식 기술 스키마 — 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"
}

문서 예시

ui_read_tree 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{}