Skip to content

[Feature Request]: Render Mermiad #2900

Description

@anhnhdo

Bug Description

Support Mermaid Rendering in Teams Agents SDK Responses

Scenario

AI Agents frequently generate Mermaid diagrams to explain workflows, business processes, architectures, and decision trees.

Today, when an agent returns Mermaid syntax, Microsoft Teams displays it as plain text rather than a rendered diagram.

Example:

flowchart TD
    User --> Agent
    Agent --> KnowledgeBase
    Agent --> ExternalSystem
    Agent --> Response
Loading

Current Limitation

Teams Agents SDK does not provide a built-in mechanism for rendering Mermaid diagrams generated by agents.

Developers currently need to:

  • Convert Mermaid to images before sending
  • Host external rendering pages
  • Build custom client-side rendering solutions

These workarounds increase complexity and reduce the usefulness of AI-generated visual content.

Proposed Enhancement

Allow Teams clients to automatically render Mermaid blocks returned by AI agents.

Possible implementations:

  • Support Mermaid code blocks in agent responses
  • Support Mermaid rendering within Adaptive Cards
  • Support Mermaid rendering in Loop components generated by agents
  • Provide a Teams SDK rendering component for Mermaid content

Benefits

  • Better AI-generated visual explanations
  • Improved user experience
  • Reduced implementation effort
  • Richer agent interactions inside Teams

As AI agents increasingly generate structured visual content, native Mermaid rendering would significantly improve the Teams agent experience.

Steps to Reproduce

.

Expected Behavior

.

Actual Behavior

.

SDK Version

.

Languages Affected

Python

Additional Context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions