Skip to content

Releases

v1.1.0 - Dataverse Integration: Auto Topic Resolution, Orchestrator Identification & Enhanced Trace Types

Choose a tag to compare

@rquattros rquattros released this 19 Apr 19:06

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 of 3399ac22…
  • 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 — VariableAssignment traces show scope (Topic/Global), variable name, and formatted value
  • Topic Redirect — DialogRedirect traces 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

  1. A Microsoft Entra ID App Registration (SPA)
  2. Dynamics CRM user_impersonation API permission
  3. 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)

  1. Go to Azure Portal → App registrations → + New registration
  2. Name: Copilot Studio Trace Viewer
  3. Platform: Single-page application (SPA) with redirect URI pointing to where you host index.html (e.g. https://yourusername.github.io/CopilotStudioTraceViewer/)
  4. Go to API permissions → + Add a permission → Dynamics CRM → user_impersonation
  5. Copy the Application (Client) ID and Directory (Tenant) ID
  6. Assign the Bot Transcript Viewer security role in Power Platform Admin Center
  7. (Recommended) Add Read on the Bot Component table to your security role for auto topic resolution
  8. 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 main branch
  • Localhost: npx http-server -p 8080 (add http://localhost:8080 as redirect URI)

Full Changelog

  • Auto-fetch botcomponents from Dataverse with per-bot caching
  • friendlyComponentId() for GUID → display name resolution
  • Orchestrator purple border + filter button (both viewers)
  • VariableAssignment trace rendering with scope + formatted value
  • DialogRedirect → Topic Redirect with cyan badge and resolved names
  • 15 DialogTracingInfo action-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

Choose a tag to compare

@rquattros rquattros released this 16 Apr 18:07

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