Learn how to debug Agent Script in Agentforce Builder, DX extension, and with Agentforce Vibes. Trace routing, variables, and reasoning loops to fix issues fast.

The Salesforce Developers Blog offers insights, tutorials, and best practices for building applications on the Salesforce platform using Apex, Lightning Web Components, and other Salesforce technologies. Developers can learn about Salesforce development tools, APIs, and integration patterns, as well as explore topics such as declarative development, Salesforce DX, and mobile app development on the Salesforce platform. Additionally, the blog covers Salesforce events, certifications, and community initiatives, providing resources for Salesforce developers of all skill levels.

Salesforce Developers Blog

A guide to debugging Agentforce agents built with Agent Script. Covers the execution flow model (deterministic instruction phase vs. non-deterministic LLM reasoning), then walks through three debugging approaches: using the Interaction Summary and Trace panels in Agentforce Builder, using the Agent Tracer tab in the Agentforce DX VS Code extension, and a 'vibe debugging' workflow where you paste the JSON execution trace into Agentforce Vibes (or other AI coding tools like Claude Code or Cursor) to get AI-assisted diagnosis and code suggestions. Key mental models include understanding that start_agent always routes first each turn, that prompt text accumulates separately from logic, and that multi-turn bugs often live in variable state transitions.

Agent Script Decoded: How to Debug Agent Script

Debug Agent Script with Agentforce Builder