Repository navigation
Releases
Releases · rquattros/CopilotStudioTraceViewer
v1.1.0 - Dataverse Integration: Auto Topic Resolution, Orchestrator Identification & Enhanced Trace Types
v1.1.0 - Dataverse Integration: Auto Topic Resolution, Orchestrator Identification & Enhanced Trace Types
Latest
What's New
🔗 Auto Topic Name Resolution from Dataverse
When loading a conversation transcript from Dataverse, the viewer now automatically fetches bot components from the botcomponents table and resolves raw component GUIDs to friendly display names — no manual upload needed.
- Topic Redirects (
DialogRedirect) now display as → Greeting instead of3399ac22… - Component names appear in both the timeline title and the expanded detail panel
- Results are cached per bot — switching between conversations from the same bot doesn't re-fetch
🟣 Orchestrator Step Identification
Orchestrator events (DynamicPlanReceived, DynamicPlanStepTriggered, DynamicPlanStepBindUpdate, DynamicPlanStepFinished, DynamicPlanCancelled) are now visually distinct:
- Purple left border on the step card
- Dedicated Orchestrator filter button to show/hide orchestrator-only steps
📊 New Trace Type Badges
- Var Assignment —
VariableAssignmenttraces show scope (Topic/Global), variable name, and formatted value - Topic Redirect —
DialogRedirecttraces with cyan badge, resolved topic name, and full component ID - Dialog Tracing action-type badges — 15 distinct action types (SetVariable, SendActivity, Question, InvokeFlowAction, BeginDialog, ConditionGroup, etc.) each with their own color-coded badge
Dataverse Setup — How to Use
Prerequisites
- A Microsoft Entra ID App Registration (SPA)
- Dynamics CRM
user_impersonationAPI permission - Read access to these Dataverse tables:
| Table | Entity Name | Purpose |
|---|---|---|
| Bot | bots |
Populate agent filter dropdown |
| Conversation Transcript | conversationtranscripts |
List and load transcripts |
| Bot Component | botcomponents |
Resolve GUIDs to friendly topic names |
Quick Setup (5 minutes)
- Go to Azure Portal → App registrations → + New registration
- Name:
Copilot Studio Trace Viewer - Platform: Single-page application (SPA) with redirect URI pointing to where you host
index.html(e.g.https://yourusername.github.io/CopilotStudioTraceViewer/) - Go to API permissions → + Add a permission → Dynamics CRM →
user_impersonation - Copy the Application (Client) ID and Directory (Tenant) ID
- Assign the Bot Transcript Viewer security role in Power Platform Admin Center
- (Recommended) Add Read on the Bot Component table to your security role for auto topic resolution
- Open the viewer, enter your Environment URL + Client ID + Tenant ID, and click Connect
See the full step-by-step guide in the README for detailed instructions with screenshots.
Hosting Options
- GitHub Pages (recommended): Fork the repo → Settings → Pages → Deploy from
mainbranch - Localhost:
npx http-server -p 8080(addhttp://localhost:8080as redirect URI)
Full Changelog
- Auto-fetch
botcomponentsfrom Dataverse with per-bot caching friendlyComponentId()for GUID → display name resolution- Orchestrator purple border + filter button (both viewers)
VariableAssignmenttrace rendering with scope + formatted valueDialogRedirect→Topic Redirectwith cyan badge and resolved names- 15
DialogTracingInfoaction-type badges with color coding - README: documented all 3 Dataverse tables, security role setup, troubleshooting
- README: removed duplicate content sections
v1.0.0 - Topic Definition Explorer
New Feature: Topic Definition Explorer
A full-featured overlay for exploring and searching bot topic definitions from your botContent.yml.
Topic List Home
- Grid view of all topics and actions, grouped by type (Topics vs Actions)
- Shows action count, trigger count, and trigger type for each topic
- Click any card to drill into the topic detail view
Topic Detail View
- Trigger info: type, description, and trigger phrases
- Topic inputs/outputs from inputType/outputType definitions
- TaskDialog details: action type, connection references, operation IDs, inputs/outputs
- Full action flow tree with color-coded nodes for each action kind (Message, Question, Condition, Set Variable, Go to Topic, Flow/Connector, AI Builder Prompts)
- Condition branches rendered with nested indent and dashed borders
- ForEach loops with loop body rendering
Navigation
- Dropdown selector to pick any topic/action from the header
- Back button to return to topic list from any detail or search view
- Escape or click-outside to close the overlay
Cross-Topic Search
- Real-time search bar with 250ms debounce
- Searches all actions across all topics by serializing action properties
- Results grouped by topic with match count and highlighted matches
- Click any topic name in search results to navigate into it
- TaskDialog inputs/outputs are also searchable
Floating Toggle Button
- Topics button in the bottom nav bar, always accessible when a trace is loaded