Skip to content

Rework of "Agents user experience" - #14418

Draft
nickwalkmsft wants to merge 7 commits into
mainfrom
nickwalk-agents-user-experience-updates
Draft

Rework of "Agents user experience"#14418
nickwalkmsft wants to merge 7 commits into
mainfrom
nickwalk-agents-user-experience-updates

Conversation

@nickwalkmsft

@nickwalkmsft nickwalkmsft commented Jun 11, 2026

Copy link
Copy Markdown
Collaborator

@microsoft-production-github-app

Copy link
Copy Markdown

Acrolinx Scorecards

We 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:

Article Score Issues Scorecard Processed
msteams-platform/TOC.yml 92 25 link
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md 81 54 link

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-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 9115f7b:

⚠️ Validation status: warnings

File Status Preview URL Details
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md ⚠️Warning View Details
msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md ⚠️Warning View Details
msteams-platform/whats-new.md ⚠️Warning View Details
msteams-platform/TOC.yml ✅Succeeded View

msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md

  • Line 90, Column 91: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/proactive-bots-and-messages/graph-proactive-bots-and-messages?tabs=dotnet' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 90, Column 354: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 116, Column 1: [Warning: disallowed-heading - See documentation] Heading 'H2 'Feedback'' matches the text of a disallowed Docs template heading.
  • Line 122, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/bot-feedback-buttons.png'.
  • Line 124, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/bot-feedback-form.png'.
  • Line 128, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-buttons-mobile.png'.
  • Line 130, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-form-mobile.png'.
  • Line 90, Column 91: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/proactive-bots-and-messages/graph-proactive-bots-and-messages?tabs=dotnet' will be broken in isolated environments. Replace with a relative link.
  • Line 90, Column 354: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages' will be broken in isolated environments. Replace with a relative link.

msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md

  • Line 30, Column 87: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#best-practices-for-agents-in-teams' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

msteams-platform/whats-new.md

  • Line 535, Column 122: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-app-profile-card' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

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.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@microsoft-production-github-app

Copy link
Copy Markdown

Acrolinx Scorecards

We 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:

Article Score Issues Scorecard Processed
msteams-platform/TOC.yml 92 25 link
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md 79 49 link

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-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 02543b8:

⚠️ Validation status: warnings

File Status Preview URL Details
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md ⚠️Warning View Details
msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md ⚠️Warning View Details
msteams-platform/whats-new.md ⚠️Warning View Details
msteams-platform/TOC.yml ✅Succeeded View

msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md

  • Line 95, Column 91: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/proactive-bots-and-messages/graph-proactive-bots-and-messages?tabs=dotnet' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 95, Column 354: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 121, Column 1: [Warning: disallowed-heading - See documentation] Heading 'H2 'Feedback'' matches the text of a disallowed Docs template heading.
  • Line 127, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/bot-feedback-buttons.png'.
  • Line 129, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/bot-feedback-form.png'.
  • Line 133, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-buttons-mobile.png'.
  • Line 135, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-form-mobile.png'.
  • Line 95, Column 91: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/proactive-bots-and-messages/graph-proactive-bots-and-messages?tabs=dotnet' will be broken in isolated environments. Replace with a relative link.
  • Line 95, Column 354: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages' will be broken in isolated environments. Replace with a relative link.

msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md

  • Line 30, Column 87: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#best-practices-for-agents-in-teams' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

msteams-platform/whats-new.md

  • Line 535, Column 122: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-app-profile-card' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

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.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@microsoft-production-github-app

Copy link
Copy Markdown

Acrolinx Scorecards

We 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:

Article Score Issues Scorecard Processed
msteams-platform/TOC.yml 92 25 link
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md 79 41 link

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-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit e0f2e42:

⚠️ Validation status: warnings

File Status Preview URL Details
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md ⚠️Warning View Details
msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md ⚠️Warning View Details
msteams-platform/whats-new.md ⚠️Warning View Details
msteams-platform/TOC.yml ✅Succeeded View

msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md

  • Line 75, Column 105: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/proactive-bots-and-messages/graph-proactive-bots-and-messages?tabs=dotnet' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 75, Column 368: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 117, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/bot-feedback-buttons.png'.
  • Line 119, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/bot-feedback-form.png'.
  • Line 123, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-buttons-mobile.png'.
  • Line 125, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-form-mobile.png'.
  • Line 75, Column 105: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/proactive-bots-and-messages/graph-proactive-bots-and-messages?tabs=dotnet' will be broken in isolated environments. Replace with a relative link.
  • Line 75, Column 368: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages' will be broken in isolated environments. Replace with a relative link.

msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md

  • Line 30, Column 87: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#best-practices-for-agents-in-teams' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

msteams-platform/whats-new.md

  • Line 535, Column 122: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-app-profile-card' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

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.

@nickwalkmsft nickwalkmsft self-assigned this Jun 12, 2026
@nickwalkmsft
nickwalkmsft force-pushed the nickwalk-agents-user-experience-updates branch from e0f2e42 to 6e00a0b Compare June 12, 2026 23:34
@microsoft-production-github-app

Copy link
Copy Markdown

Acrolinx Scorecards

We 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:

Article Score Issues Scorecard Processed
msteams-platform/TOC.yml 92 25 link
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md 79 40 link

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-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 6e00a0b:

⚠️ Validation status: warnings

File Status Preview URL Details
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md ⚠️Warning View Details
msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md ⚠️Warning View Details
msteams-platform/whats-new.md ⚠️Warning View Details
msteams-platform/TOC.yml ✅Succeeded View

msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md

  • Line 125, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-buttons-mobile.png'.
  • Line 127, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-form-mobile.png'.
  • Line 79, Column 105: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/microsoftteams/platform/graph-api/proactive-bots-and-messages/graph-proactive-bots-and-messages?tabs=dotnet' will be broken in isolated environments. Replace with a relative link.
  • Line 79, Column 362: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages' will be broken in isolated environments. Replace with a relative link.

msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md

  • Line 30, Column 87: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#best-practices-for-agents-in-teams' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

msteams-platform/whats-new.md

  • Line 535, Column 122: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-app-profile-card' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

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.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@microsoft-production-github-app

Copy link
Copy Markdown

Acrolinx Scorecards

We 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:

Article Score Issues Scorecard Processed
msteams-platform/TOC.yml 92 25 link
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md 77 47 link

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-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 25792e9:

⚠️ Validation status: warnings

File Status Preview URL Details
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md ⚠️Warning View Details
msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md ⚠️Warning View Details
msteams-platform/whats-new.md ⚠️Warning View Details
msteams-platform/TOC.yml ✅Succeeded View

msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md

  • Line 127, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-buttons-mobile.png'.
  • Line 129, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-form-mobile.png'.
  • Line 79, Column 105: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/microsoftteams/platform/graph-api/proactive-bots-and-messages/graph-proactive-bots-and-messages?tabs=dotnet' will be broken in isolated environments. Replace with a relative link.
  • Line 79, Column 362: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages' will be broken in isolated environments. Replace with a relative link.

msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md

  • Line 30, Column 87: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#best-practices-for-agents-in-teams' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

msteams-platform/whats-new.md

  • Line 535, Column 122: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-app-profile-card' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

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.

@microsoft-production-github-app

Copy link
Copy Markdown

Acrolinx Scorecards

We 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:

Article Score Issues Scorecard Processed
msteams-platform/TOC.yml 92 25 link
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md 77 42 link

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-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 56640e5:

⚠️ Validation status: warnings

File Status Preview URL Details
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md ⚠️Warning View Details
msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md ⚠️Warning View Details
msteams-platform/whats-new.md ⚠️Warning View Details
msteams-platform/TOC.yml ✅Succeeded View

msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md

  • Line 115, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-buttons-mobile.png'.
  • Line 117, Column 1: [Warning: file-not-found - See documentation] Invalid file link: '../../assets/images/bots/feedback-form-mobile.png'.

msteams-platform/concepts/deploy-and-publish/appsource/post-publish/overview.md

  • Line 30, Column 87: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#best-practices-for-agents-in-teams' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

msteams-platform/whats-new.md

  • Line 535, Column 122: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-app-profile-card' in 'bots/how-to/teams-conversational-ai/ai-ux.md'.

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.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

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.

1 participant