Conversation
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 4fec754:
|
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 2c2dedf: ✅ Validation status: passed
For more details, please refer to the build report. |
|
Learn Build status updates of commit c7b069f: ❌ Validation status: errorsPlease follow instructions here which may help to resolve issue.
For more details, please refer to the build report. Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them. |
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
|
Learn Build status updates of commit d154a8f: ❌ Validation status: errorsPlease follow instructions here which may help to resolve issue.
For more details, please refer to the build report. Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them. |
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit ac6485f: ✅ Validation status: passed
For more details, please refer to the build report. |
There was a problem hiding this comment.
Pull request overview
Updates documentation references around card actions, primarily aligning links to new sections in cards-actions.md and updating “See also” references across related Adaptive Cards/Universal Actions docs.
Changes:
- Reworked
cards-actions.mdto focus on Adaptive Card actions and Teams SDK handling patterns (including a new “Server handlers” section). - Updated cross-document anchors to point to new sections (for example,
#card-actions,#server-handlers,#actionexecute). - Adjusted “What’s new” and link unfurling docs to reference the updated card actions content.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 13 comments.
Show a summary per file
| File | Description |
|---|---|
| msteams-platform/whats-new.md | Updates two historical entries to point at new cards-actions.md anchors. |
| msteams-platform/task-modules-and-cards/task-modules/task-modules-bots.md | Updates links/anchors for card actions used when invoking dialogs from bots. |
| msteams-platform/task-modules-and-cards/cards/Universal-actions-for-adaptive-cards/Work-with-Universal-Actions-for-Adaptive-Cards.md | Updates “See also” links to new cards-actions.md anchors. |
| msteams-platform/task-modules-and-cards/cards/Universal-actions-for-adaptive-cards/User-Specific-Views.md | Updates “See also” link to #server-handlers. |
| msteams-platform/task-modules-and-cards/cards/Universal-actions-for-adaptive-cards/Up-To-Date-Views.md | Updates “See also” link to #server-handlers. |
| msteams-platform/task-modules-and-cards/cards/Universal-actions-for-adaptive-cards/Sequential-Workflows.md | Updates “See also” links to new cards-actions.md anchors. |
| msteams-platform/task-modules-and-cards/cards/cards-actions.md | Major rewrite: new structure, new anchors, new handler guidance, updated outbound links. |
| msteams-platform/messaging-extensions/how-to/link-unfurling.md | Adds front-matter fields and updates a reference link to cards-actions.md. |
| * A new invoke message `task/fetch`: Using the `invoke` [card action](~/task-modules-and-cards/cards/cards-actions.md#actionexecute) for Bot Framework cards, or the `Action.Submit` [card action](~/task-modules-and-cards/cards/cards-actions.md#card-actions) for Adaptive Cards, with `task/fetch`, either an HTML or Adaptive Card-based dialog is fetched dynamically from your bot. | ||
| * Deep link URLs: Using the [deep link syntax for dialogs](../../concepts/build-and-test/deep-link-application.md#deep-link-to-open-a-dialog), you can use the `openUrl` [card action](~/task-modules-and-cards/cards/cards-actions.md#actionopenurl) for Bot Framework cards or the `Action.OpenUrl` [card action](~/task-modules-and-cards/cards/cards-actions.md#card-actions) for Adaptive Cards, respectively. With deep link URLs, the dialog URL or Adaptive Card body is already known to avoid a server round-trip relative to `task/fetch`. |
There was a problem hiding this comment.
These bullets refer to Bot Framework CardAction types (invoke, openUrl), but the links now point to Adaptive Card sections (Action.Execute / Action.OpenUrl) in cards-actions.md. That mismatch will send readers to the wrong action model; please link Bot Framework card actions to the correct Bot Framework/Teams card-action documentation (or reintroduce a Bot Framework section in cards-actions.md) and keep Adaptive Card links separate.
| The following steps provide instructions on how to invoke a dialog (referred as task module in TeamsJS v1.x) using `task/fetch`: | ||
|
|
||
| 1. This image shows a Bot Framework hero card with a **Buy** `invoke` [card action](~/task-modules-and-cards/cards/cards-actions.md#action-type-invoke). The value of the `type` property is `task/fetch` and the rest of the `value` object can be of your choice. | ||
| 1. This image shows a Bot Framework hero card with a **Buy** `invoke` [card action](~/task-modules-and-cards/cards/cards-actions.md#actionexecute). The value of the `type` property is `task/fetch` and the rest of the `value` object can be of your choice. |
There was a problem hiding this comment.
This step calls out a Bot Framework hero card invoke action but links to the Action.Execute section. Please update the link/label so it points to documentation for the Bot Framework invoke CardAction (or adjust the text to refer to Adaptive Card actions if that’s what’s intended).
| "value": "https://signin.com" | ||
| "type": "AdaptiveCard", | ||
| "version": "1.5", | ||
| "schema": "http://adaptivecards.io/schemas/adaptive-card.json", |
There was a problem hiding this comment.
This JSON sample uses "schema" instead of $schema for the Adaptive Card schema reference. Please update it to $schema (consistent with other Adaptive Card samples in this repo) to avoid implying an invalid payload.
| "schema": "http://adaptivecards.io/schemas/adaptive-card.json", | |
| "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", |
| "version": "1.5", | ||
| "fallbackText": "fallback text for sample 01", | ||
| "speak": "This is Adaptive Card sample 1", | ||
| "schema": "http://adaptivecards.io/schemas/adaptive-card.json", |
There was a problem hiding this comment.
This JSON sample uses "schema" instead of $schema. Please switch to $schema for correctness and to match the convention used by other Adaptive Card JSON samples in this repository.
| "schema": "http://adaptivecards.io/schemas/adaptive-card.json", | |
| "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", |
| ## Server handlers | ||
|
|
||
| If you don't want to display the success message, set the attribute `hide` to `true` in the `msTeams` `feedback` property. Following is an example: | ||
| Card actions arrive as `card.action` activities in your app. These give you access to the validated input values plus any `data` values you had configured to be sent back to you. |
There was a problem hiding this comment.
This section says Action.Execute submissions arrive as card.action activities, but elsewhere in this docset Universal Actions are described as an invoke activity named adaptiveCard/action (for example, cards/Universal-actions-for-adaptive-cards/Work-with-Universal-Actions-for-Adaptive-Cards.md:90-92). Please reconcile this by either using the underlying adaptiveCard/action terminology here or explicitly explaining how card.action maps to that invoke activity in the Teams SDK.
| Card actions arrive as `card.action` activities in your app. These give you access to the validated input values plus any `data` values you had configured to be sent back to you. | |
| Universal Action submissions are delivered to your bot as `invoke` activities named `adaptiveCard/action`. In the Teams SDK, these are surfaced to your app as `card.action` activities, which give you access to the validated input values plus any `data` values you configured to be sent back to you. |
There was a problem hiding this comment.
Made the required changes.
| > [!div class="nextstepaction"] | ||
| > [Universal Actions for Adaptive Cards](../cards/Universal-actions-for-adaptive-cards/Overview.md) | ||
| > [Building Adaptive Cards](/microsoftteams/platform/teams-sdk/in-depth-guides/adaptive-cards/building-adaptive-cards) | ||
|
|
||
| ## See also | ||
|
|
||
| * [Cards reference](./cards-reference.md) | ||
| * [Types of cards](cards-reference.md) | ||
| * [Use dialogs from bots](~/task-modules-and-cards/task-modules/task-modules-bots.md) | ||
| * [Adaptive Cards in bots](../../bots/how-to/conversations/conversation-messages.md#adaptive-cards) | ||
| * [Adaptive Card-based Loop component](../../m365-apps/cards-loop-component.md) | ||
| * [Adaptive Cards overview](/microsoftteams/platform/teams-sdk/in-depth-guides/adaptive-cards/overview) |
There was a problem hiding this comment.
These links use the /microsoftteams/platform/teams-sdk/... path, but elsewhere in this repo “Teams SDK” content links under /microsoftteams/platform/teams-ai-library/... (for example, agents-in-teams/build-first-agent.md:131). Please verify the target URLs and align them to the correct doc path to avoid broken links.
| * [Adaptive Card-based Loop component](../../m365-apps/cards-loop-component.md) | ||
| * [Adaptive Cards overview](/microsoftteams/platform/teams-sdk/in-depth-guides/adaptive-cards/overview) | ||
| * [Executing Actions](/microsoftteams/platform/teams-sdk/in-depth-guides/adaptive-cards/executing-actions) | ||
| * [Listening to Activities](/microsoftteams/platform/teams-sdk/essentials/on-activity/overview) |
There was a problem hiding this comment.
This "See also" link continues using the /microsoftteams/platform/teams-sdk/... doc path. Please confirm the correct Teams SDK documentation location (this repo consistently uses /microsoftteams/platform/teams-ai-library/...) and update the link accordingly.
| * [Listening to Activities](/microsoftteams/platform/teams-sdk/essentials/on-activity/overview) | |
| * [Listening to Activities](/microsoftteams/platform/teams-ai-library/essentials/on-activity/overview) |
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
|
Learn Build status updates of commit 0c911a9: ✅ Validation status: passed
For more details, please refer to the build report. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 56f8aa3: ✅ Validation status: passed
For more details, please refer to the build report. |
No description provided.