Agentic AI Notebook
Phase 24

Screen Understanding

~3 min read

Concept & How It Works

  • Key points are in the visual diagram above.

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