For the complete documentation index, see llms.txt. This page is also available as Markdown.

Health Monitor Agent

The Health Monitor Agent finds out why your flows are failing.

It investigates your runs, logs, and scripts, explains the root cause in plain language, and can hand the fix straight to the Implementation Agent to apply for you.

Rather than digging through run logs and error groups yourself to work out which step broke and why, you get a single, direct diagnosis - and, when you want it, a fix carried out on your behalf.

What it does

When you ask about a failure, the Health Monitor Agent reads across the flow's runs, logs, and scripts and synthesises a single answer covering:

  • The failure - which flow failed, when, how many times, and whether it is still recurring.

  • Root cause - the underlying reason, separated from the downstream errors it triggered.

  • What to investigate next - where to look, including practical constraints such as payload retention.

  • A suggested fix - a concrete change to the flow, which it can apply through the Implementation Agent.

Because it distinguishes the root cause from its knock-on errors, you get the one thing that actually needs fixing rather than a wall of retry and "flow run failed" messages.

How to use it

The Health Monitor Agent is available from the AI Studio page under Platform Agents, and can also be opened from the Process Flow Run Logs page while you are reviewing failures.

1

Open the Health Monitor

Navigate to AI Studio → Platform Agents and select the Health Monitor card, then click Start conversation. Alternatively, open it from the Process Flow Run Logs page and select Health Monitor in the assistant, so you can ask about failures while looking at them.

2

Ask what is failing

Ask in plain language - for example, "What are the most recent flow failures?" The agent locates the failing runs, reads the logs and scripts, and returns the root cause with the surrounding detail.

3

Review the suggested fix

Where there is a sensible remediation, the agent describes exactly what it would change and why, then asks whether you would like it applied.

4

Let it apply the fix

Confirm, and the Health Monitor hands the change to the Implementation Agent, which makes it in the flow for you - for example, inserting a validation step ahead of the step that was failing. The agent confirms what was changed and what to expect going forward.

A fix applied by the Health Monitor is a guard against the symptom, not always a cure for the cause. If a bad payload or upstream issue produced the failure, it is still worth tracing back to the source system or step that caused it.

Last updated

Was this helpful?