0
Phase 15

Screen Understanding

~3 min read

Concept & How It Works

    Why Does It Exist?

    Computer use and browser agents need to 'see' the UI before clicking. Screen understanding bridges raw pixels (or DOM) and agent reasoning, grounding actions in what's actually visible.

    Real-World Analogy

    Screen understanding is reading a restaurant menu before ordering — you look at what's available, then decide what to ask for.
    Loading diagram...

    Visual Workflows

    What is Screen Understanding?

    Loading diagram...

    Example

    Scenario

    Agent receives screenshot of settings page → identifies 'Privacy' section at coordinates (320, 450) → clicks it → reads new screen → toggles 'Share analytics' off.

    Solution

    In Voice & Multimodal Agents, apply Screen Understanding to this scenario: Agent receives screenshot of settings page → identifies 'Privacy' section at coordinates (320, 450) → clicks it → reads new screen → toggles 'Share analytics' off. Identify the inputs, run the technique, validate the output, and note one thing you would monitor in production.

    Practice Task

    Do this before moving to the next module — reading alone is not enough.

    Open the Code Walkthrough below and run it locally. Change one parameter related to Screen Understanding (e.g. model, temperature, top_k, or tool name), observe the difference in output, and write 2–3 sentences explaining what changed.

    Code Walkthrough

    Highlighted lines show where Screen Understanding happens in the code.

    Screen Understanding
    1# Set-of-Mark approach2annotated = overlay_element_numbers(screenshot, accessibility_tree)  # key line for Screen Understanding3response = vision_llm.invoke([4    {"type": "image_url", "image_url": {"url": annotated_url}},5    {"type": "text", "text": "Click the element to disable analytics. Return element number."},6])7element_id = parse_element_number(response)8click(accessibility_tree[element_id].bounds)

    Commands to Remember

    Commands to Remember

    • pip install openai # vision, audio, and TTS APIs
    • pip install pypdf # PDF ingestion for document agents

    Common Mistakes

    • Treating Screen Understanding as a black box without evaluation
    • Ignoring cost and latency in production
    • Skipping error handling for screen understanding

    Cheat Sheet

    Quick recap — the most important points from this module.

    Cheat Sheet

    quick ref
    • Screen Understanding
    • Accessibility Tree
    • Set-of-Mark
    • UI Grounding