Skip to content

Trace Parser: fix agent response formatting (avoid markdown tables)#520

Open
ahmetziyayildirim wants to merge 1 commit intomasterfrom
fix/agent-instructions-no-tables
Open

Trace Parser: fix agent response formatting (avoid markdown tables)#520
ahmetziyayildirim wants to merge 1 commit intomasterfrom
fix/agent-instructions-no-tables

Conversation

@ahmetziyayildirim
Copy link
Copy Markdown
Collaborator

Customer-reported issue: agent responses render badly in narrow chat surfaces (Microsoft Copilot side panel, Copilot Studio test pane, Teams) — markdown tables get character-wrapped vertically and become unreadable.

Root cause: the agent's instructions explicitly directed it to use markdown tables for Session List, Issues Detected, and Keyword Search output. The "Detailed Findings" format (headings + bullets) renders cleanly across all surfaces; this PR extends that pattern to the other response types.

Changes:

  • Rewrote Response Formatting section in agent instructions to use headings + bullet lists instead of wide markdown tables. Reference tables (Available Tools, Time Unit Handling, Pattern-Specific Research, Performance Thresholds) left unchanged — they are agent reference data, not response templates.
  • Added Important Guideline ModelJsonToViewDefinition.sql is only for one entity? #6: "Never output markdown tables in responses."
  • Bumped solution version 1.0.0.4 → 1.0.0.5; renamed TraceParser_1_0_0_4.zip → TraceParser_1_0_0_5.zip.
  • Rebuilt TPA - Solution Files V1.zip with the updated nested zip.
  • Updated Solutions/readme.md to reference the new filename.

Customer-reported issue: agent responses render badly in narrow chat
surfaces (Microsoft Copilot side panel, Copilot Studio test pane,
Teams) — markdown tables get character-wrapped vertically and become
unreadable.

Root cause: the agent's instructions explicitly directed it to use
markdown tables for Session List, Issues Detected, and Keyword Search
output. The "Detailed Findings" format (headings + bullets) renders
cleanly across all surfaces; this PR extends that pattern to the
other response types.

Changes:
- Rewrote Response Formatting section in agent instructions to use
  headings + bullet lists instead of wide markdown tables. Reference
  tables (Available Tools, Time Unit Handling, Pattern-Specific
  Research, Performance Thresholds) left unchanged — they are agent
  reference data, not response templates.
- Added Important Guideline #6: "Never output markdown tables in
  responses."
- Bumped solution version 1.0.0.4 → 1.0.0.5; renamed
  TraceParser_1_0_0_4.zip → TraceParser_1_0_0_5.zip.
- Rebuilt TPA - Solution Files V1.zip with the updated nested zip.
- Updated Solutions/readme.md to reference the new filename.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants