[Dev-Docs AI Improvement]: Agents user experience #13700
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 1a84966:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md | View | Details |
msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md
- Line 63, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-streaming-ux.gif' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 80, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-citation.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 95, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-labels-1.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 98, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-labels-2.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 117, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-zero-prompts.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 147, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-feedback-loop.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 174, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-suggested-prompts.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 185, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/contoso-app-profile-card.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 63, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-streaming-ux.gif' will be broken in isolated environments. Replace with a relative link. - Line 80, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-citation.png' will be broken in isolated environments. Replace with a relative link. - Line 95, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-labels-1.png' will be broken in isolated environments. Replace with a relative link. - Line 98, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-labels-2.png' will be broken in isolated environments. Replace with a relative link. - Line 117, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-zero-prompts.png' will be broken in isolated environments. Replace with a relative link. - Line 147, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-feedback-loop.png' will be broken in isolated environments. Replace with a relative link. - Line 174, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/ai-suggested-prompts.png' will be broken in isolated environments. Replace with a relative link. - Line 185, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/bots/contoso-app-profile-card.png' will be broken in isolated environments. Replace with a relative link.
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.
| # Agents user experience | ||
|
|
||
| [!INCLUDE [teams-ai-lib-v2-rec](../../../includes/teams-ai-lib-v2-rec.md)] | ||
| > ⚠️ **Error loading included file: ../../../includes/teams-ai-lib-v2-rec.md** |
There was a problem hiding this comment.
Syntax shouldn't change.
| An agent uses LLM for complex user requests, which may delay responses. To prevent noticeable delays, the agent streams its responses, making them appear fast. | ||
|
|
||
| :::image type="content" source="../../../assets/images/bots/ai-streaming-ux.gif" alt-text="Graphical representation shows streaming agent messages" border="false"::: | ||
|  |
There was a problem hiding this comment.
images path being deleted, which is not the correct convention
| - Example of AI-generated label: | ||
|
|
||
| :::image type="content" source="../../../assets/images/bots/ai-labels-1.png" alt-text="Image shows an example of AI label for AI-generated message." border="false"::: | ||
|  |
There was a problem hiding this comment.
images path being deleted, which is again not the correct convention
| "type": "bot", | ||
| "id": "00001111-aaaa-2222-bbbb-3333cccc4444" | ||
| }] | ||
| }, |
There was a problem hiding this comment.
Code Indentation has been changed
| ms.topic: | ||
| ms.localizationpriority: | ||
| ms.date: | ||
| ms.owner: |
There was a problem hiding this comment.
The details of the initial section, such as the title and description, are appearing here unnecessarily and without any relevant context. They are not required.
This PR updates the content of the file: msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md.
Submitted by: @yashy797