[Dev-Docs AI Improvement]: Agents user experience #13654
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 875bb0c: ✅ Validation status: passed
For more details, please refer to the build report. |
SukanyaDas-MSFT
left a comment
SukanyaDas-MSFT
left a comment
There was a problem hiding this comment.
Please make the requested changes.
| [!INCLUDE [teams-ai-lib-v2-rec](../../../includes/teams-ai-lib-v2-rec.md)] | ||
|
|
||
| An agent transforms system interactions. For developers, creating an exceptional user experience is crucial. This article details the steps, principles, and considerations for designing intuitive, user-centered interfaces that seamlessly integrate AI capabilities. The main goals are to simplify complex tasks, enhance productivity, and offer personalized experiences through adaptive learning. An agent includes features that enhance its functionality and integration within the Teams environment: | ||
| An agent transforms system interactions. Developers create exceptional user experiences by following these guidelines. This article describes steps, principles, and considerations to design intuitive, user-centered interfaces that integrate AI capabilities. Goals include simplifying complex tasks, enhancing productivity, and offering personalized experiences through adaptive learning. An agent includes features that enhance functionality and integration within Teams environment: |
There was a problem hiding this comment.
The changes in this para are not necessary, and changes the meaning. Please revert to original.
| - Informative updates: Send information on the sub-steps as the agent generates the response before it sends the final response. | ||
| - Response streaming: Send the intermediate states of the final response while the LLM creates its full response. | ||
| - Informative updates: Send information on sub-steps as the agent generates the response before sending the final output. | ||
| - Response streaming: Send intermediate states of the final response while the LLM creates its full reply. |
There was a problem hiding this comment.
response to reply change is not necessary.
| ### Ensure that the agent maintains intelligent conversation | ||
|
|
||
| An agent must track a conversation's context and history to provide an intelligent interaction. The agent must meet the user's expectation by being aware of the conversation's context and allowing them to refer to previous messages and responses. | ||
| An agent tracks conversation context and history to provide intelligent interactions. It meets user expectations by maintaining awareness of the conversation and allowing references to previous messages and responses. |
There was a problem hiding this comment.
Revert the change, intended action is getting changed.
| ### Ensure that the agent offers prompt starters or a welcome card | ||
|
|
||
| An agent must assist users by offering prompt suggestions on how to best utilize the agent. This helps users overcome challenges during both initial and subsequent interactions with the agent. | ||
| An agent assists users by offering prompt suggestions that help them utilize its features effectively. This approach helps users overcome challenges during both initial and subsequent interactions. |
There was a problem hiding this comment.
Revert change, intention is getting altered.
| :::image type="content" source="../../../assets/images/bots/contoso-app-profile-card.png" alt-text="Image shows app profile card." border="false" lightbox="../../../assets/images/bots/contoso-app-profile-card.png"::: | ||
|
|
||
| To enable app profile card to your agents or bots, you must add the `features` field under the `description` field in the app manifest. For more information, see [public developer preview for Teams](/microsoft-365/extensibility/schema/root-description?view=m365-app-prev&tabs=syntax&preserve-view=true). | ||
| To enable app profile card for your agents or bots, add the `features` field under the `description` field in the app manifest. For more information, see [public developer preview for Teams](/microsoft-365/extensibility/schema/root-description?view=m365-app-prev&tabs=syntax&preserve-view=true). |
There was a problem hiding this comment.
Features and Description should not be code tagged, they are screen elements and have to be in bold.
This PR updates the content of the file: msteams-platform/bots/how-to/teams-conversational-ai/ai-ux.md.
Submitted by: @yashy797