Skip to content
This repository was archived by the owner on Aug 10, 2026. It is now read-only.

Commit 60ebfee

Browse files
committed
docs: update README with trace sources and navigation instructions
1 parent 5c89e40 commit 60ebfee

1 file changed

Lines changed: 12 additions & 2 deletions

File tree

README.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,23 @@ Load a trace from the **Agentforce DX** extension and AgentLens shows you:
1515
- **Step-by-Step Inspector** — walk through every event with full detail: system prompts, model output, tool inputs/outputs, and variable diffs
1616
- **Graph Analysis Report** — one-click PDF with degree distribution, connectivity analysis, betweenness centrality, and algorithm explanations
1717

18+
## Getting a Trace
19+
20+
AgentLens accepts trace JSON from any of these sources:
21+
22+
| Source | How to get the trace |
23+
|--------|---------------------|
24+
| **Agentforce Builder** | Open your agent in Setup > Agentforce Builder, run a conversation in the Preview panel, then copy the JSON trace from the conversation details |
25+
| **SF CLI — Agent Preview** | `sf agent preview -o <org>` — after the conversation, save the transcript JSON (saved to `./temp/agent-preview` by default, or specify `--output-dir`) |
26+
| **Agentforce DX Extension** | Use the trace viewer in the Agentforce DX VS Code extension and copy the plan response JSON |
27+
1828
## Quick Start
1929

2030
### Web App
2131

2232
1. Open <https://msrivastav13.github.io/AgentLens/> (or `index.html` locally — no server required)
23-
2. Paste or upload the plan response JSON from the Agentforce DX extension
24-
3. Click a sub agent to explore its state machine and step through the trace
33+
2. Paste or upload a trace JSON from any of the sources above
34+
3. The first sub agent is auto-selected — step through the trace with arrow keys or the prev/next buttons; handoffs navigate to the next agent automatically
2535

2636
### VS Code Extension
2737

0 commit comments

Comments
 (0)