Skip to content

Commit 54cedac

Browse files
author
Corina Gum
committed
Clarify MCP knowledge and messageBack
1 parent f02a661 commit 54cedac

2 files changed

Lines changed: 6 additions & 2 deletions

File tree

teams.md/src/pages/templates/in-depth-guides/html-widgets/README.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ HTML Widgets let your app render rich, interactive HTML inside a Teams message.
1010
A widget is an [MCP Apps (ext-apps)](https://github.com/modelcontextprotocol/ext-apps) surface that the Teams client renders in a sandboxed iframe.
1111
The widget can call tools on your app, send messages back, request display mode changes, open links, and contribute content to the model context for future turns.
1212

13+
You do not need to know the MCP Apps protocol to build widgets. The SDK helpers handle the wire format and protocol handshake for you, and the links to the specification are here only if you want the underlying details.
14+
1315
:::warning Preview
1416
HTML Widgets are in preview and the API surface may change.
1517
<LanguageInclude content={{"typescript": "Every widget type and helper is annotated `@experimental` in its JSDoc (diagnostic `ExperimentalTeamsHtmlWidget`) to mark it as preview.", "python": "Every widget type and helper is decorated with `@experimental` (`ExperimentalTeamsHtmlWidget`), which emits a runtime preview warning when it is used.", "csharp": "Every widget type and helper is guarded by the `ExperimentalTeamsHtmlWidget` compiler diagnostic, so you opt in explicitly to use them."}} />

teams.md/src/pages/templates/in-depth-guides/html-widgets/updating-model-context.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,10 @@ title: 'Updating Model Context'
77
# Updating Model Context
88

99
A widget can contribute content to the model context so your app can use it on future turns.
10-
This is the widget-side equivalent of `Action.Submit` for adaptive cards: the widget reuses the existing messageBack mechanism, so the request arrives as a normal message activity.
11-
It is fire-and-forget, meaning your app does not send a response.
10+
11+
Widgets send data back to your app over the same messageBack channel other Teams surfaces use, so the request arrives as an ordinary message activity. `ui/update-model-context` is the specific request for contributing to model context; other widget-to-app requests (such as [tool calls](./handling-tool-calls)) travel over the same channel with different methods. This particular request is fire-and-forget: your app does not send a response.
12+
13+
(If you have used adaptive cards, this is the widget-side equivalent of `Action.Submit`.)
1214

1315
:::warning Preview
1416
HTML Widgets are in preview and the API surface may change.

0 commit comments

Comments
 (0)