Multimodal Agents

A multimodal agent is an agent whose inputs are not only text. It can look at a screenshot, a scanned form, or a photo, and then take action based on what it saw.

This chapter is where Module 4 comes together: the eyes from 4.1 and 4.2, the retrieval from 4.3, and the agent loop from 4.4.

Intuition

Picture a support engineer handling a ticket that arrives as a screenshot of an error dialog.

They read the error code off the image, search the internal runbook for that code, find the documented fix, and either apply it or hand it to someone who can. Four steps, two of which need eyes.

A text-only agent cannot start this task at all — the first piece of information is a picture. A vision model alone can read the dialog but cannot then go and find the runbook. You need both.

How it works

A worked example

The ticket is a screenshot. The agent runs the ordinary loop, but the first perception step is visual:

flowchart LR S[Screenshot of error dialog] --> V[VLM reads the image] V --> E["Error code: DB-5012"] E --> R[Search runbook for DB-5012] R --> F[Documented fix found] F --> H{Risky change?} H -->|Yes| A[Ask a human to approve] H -->|No| X[Apply fix] A --> X X --> D[Report what was done]
Step Which part of Module 4 does it Why it is needed
Read the dialog VLM with OCR strength, chapter 4.1–4.2 The input is pixels, not text
Find the runbook page Multimodal retrieval, chapter 4.3 The fix lives in a document, not the model
Decide and act Agent loop, chapter 4.4 Something has to actually change
Ask before risky steps Human-in-the-loop Wrong actions cost more than wrong answers

The building blocks

Why grounding matters more here

In a text agent, a misread means the model quotes the wrong sentence. In a multimodal agent, a misread means the model acts on something it never actually saw.

If the VLM reads DB-5012 as DB-5Ol2, every step afterwards is confidently wrong — the same compounding error described in the visual reasoning lesson, except now it ends in an action rather than a sentence.

Practical consequence: have the agent state what it saw before acting on it. A visible line like "Read error code DB-5012 from the dialog" costs nothing and makes the one failure that matters reviewable.

What goes wrong

One-line summary

A multimodal agent reads images, retrieves what it needs, and acts — so the visual observation must be exposed and checked before it becomes an action.

Key terms