How to Debug AI Steps in Zapier Using Zap History

AI steps fail in their own ways: empty output, extra commentary that breaks a JSON parser, or a label that no longer matches a Paths rule. Zapier's Zap History shows the exact input and output of every run, which is almost always enough to find the cause. This guide is your debugging routine.

What you need

• A live Zap with an AI step that is misbehaving
• Access to Zap History (in the left sidebar)
• About 10 minutes

Step 1: Open the failed run

Go to Zap History and find the run that went wrong. Click it to expand every step. Each step shows Data In and Data Out, so you can trace the exact values that flowed through the Zap on that run.

Step 2: Inspect the AI Data Out

Open the AI step and read its Data Out exactly as returned. The usual culprit is the model wrapping JSON in prose or a code fence, which a parser then rejects. Seeing the raw text tells you precisely what to fix.

Sure! Here is the JSON you asked for:

```json
{ "name": "Dana", "total": 148.5 }
```

Step 3: Fix the prompt and re-test

Edit the AI step prompt to forbid extra text explicitly, and lower the temperature if you control it. Then use the editor's Test button to run the step again with the same sample and confirm the output is now clean.

Reply with raw JSON only. No prose. No code fences.
No leading or trailing characters. Start with { and
end with }.

{ "name": string, "total": number }

Step 4: Replay the run

Back in Zap History you can often use Replay on the failed run to re-send the same data through the fixed Zap. This confirms the fix works on the exact case that broke, without waiting for a new live event.

Result: You can pinpoint why any AI step misbehaved by reading its real input and output, fix the prompt, replay the exact failure, and confirm the Zap now runs clean end to end.