[Dev-Docs AI Improvement]: Microsoft 365 Agents Toolkit Overview #13668
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 2cd99df:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| msteams-platform/toolkit/agents-toolkit-fundamentals.md | View | Details |
msteams-platform/toolkit/agents-toolkit-fundamentals.md
- Line 1, Column 1: [Warning: title-missing - See documentation]
Missing required attribute: 'title'. Add a title string to show in search engine results. - Line 1, Column 1: [Warning: ms-topic-missing - See documentation]
Missing required attribute: 'ms.topic'. - Line 13, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/toolkit-v2/toolkit-fundamentals/toolkit-user-journey2.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 36, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/toolkit-v2/toolkit-fundamentals/teams-agents.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 50, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/toolkit-v2/build-environment-dev-portal.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 1, Column 1: [Suggestion: ms-date-missing - See documentation]
Missing required attribute: 'ms.date'. - Line 1, Column 1: [Suggestion: description-missing - See documentation]
Missing required attribute: 'description'. - Line 13, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/toolkit-v2/toolkit-fundamentals/toolkit-user-journey2.png' will be broken in isolated environments. Replace with a relative link. - Line 36, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/toolkit-v2/toolkit-fundamentals/teams-agents.png' will be broken in isolated environments. Replace with a relative link. - Line 50, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/toolkit-v2/build-environment-dev-portal.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.
| @@ -1,34 +1,24 @@ | |||
| --- | |||
There was a problem hiding this comment.
These are mandatory fields
| # Microsoft 365 Agents Toolkit Overview | ||
|
|
||
| [!INCLUDE [Deprecation note](../includes/deprecation-note-teamsfx-sdk.md)] | ||
| > ⚠️ **Error loading included file: ../includes/deprecation-note-teamsfx-sdk.md** |
There was a problem hiding this comment.
Retain original version. This is not looking like a note
| * Run and debug to Teams, Outlook, and Copilot directly from Visual Studio Code. | ||
| * Smart defaults for hosting in Azure using infrastructure-as-code and Bicep. | ||
| * Test with different configurations such as dev, test, and prod using the environment features. | ||
| * Smart defaults for hosting in Azure by using infrastructure-as-code and Bicep. |
There was a problem hiding this comment.
Retain original
| [!INCLUDE [Deprecation note](../includes/deprecation-note-teamsfx-sdk.md)] | ||
| > ⚠️ **Error loading included file: ../includes/deprecation-note-teamsfx-sdk.md** | ||
| Agents Toolkit (previously known as Teams Toolkit) makes it simple to get started with app development for Microsoft Teams, Outlook, and Microsoft 365 Copilot using Visual Studio Code. |
There was a problem hiding this comment.
Avoid unnecessary “by” + gerund — MSTP prefers simpler constructions.
There was a problem hiding this comment.
Do this for all instances where by has been added
| * Smart defaults for hosting in Azure by using infrastructure-as-code and Bicep. | ||
| * Test with different configurations such as dev, test, and prod by using the environment features. | ||
|
|
||
| :::image type="content" source="../assets/images/toolkit-v2/toolkit-fundamentals/toolkit-user-journey2.png" alt-text="Illustration shows the User Journey of the Agents Toolkit." lightbox="../assets/images/toolkit-v2/toolkit-fundamentals/toolkit-user-journey2.png"::: |
There was a problem hiding this comment.
Dont change the syntax
| ### Project templates | ||
|
|
||
| Save time getting started with new Teams apps using the capability-focused templates for tabs, bots, message extensions, and common app scenarios. | ||
| Save time getting started with new Teams apps by using the capability-focused templates for tabs, bots, message extensions, and common app scenarios. |
There was a problem hiding this comment.
retain original
| ### Composable automation tasks | ||
|
|
||
| Automate repetitive or tedious configuration using a composable task framework that creates app IDs, bot registrations, Microsoft Entra apps, and so on. | ||
| Automate repetitive or tedious configuration by using a composable task framework that creates app IDs, bot registrations, Microsoft Entra apps, and so on. |
There was a problem hiding this comment.
retain original
| ### Quick access to Teams Developer Portal | ||
|
|
||
| You can access Teams Developer Portal where you can configure, publish, and manage your app. For more information, see [manage your Teams apps using Developer Portal](../concepts/build-and-test/manage-your-apps-in-developer-portal.md). | ||
| Access Teams Developer Portal where you can configure, publish, and manage your app. For more information, see [manage your Teams apps by using Developer Portal](../concepts/build-and-test/manage-your-apps-in-developer-portal.md). |
| ### Microsoft 365 Agents Playground | ||
|
|
||
| Microsoft 365 Agents Playground (previously known as Teams App Test Tool) makes debugging bot-based apps effortless. You can chat with your bot and see its messages and Adaptive Cards as they appear in Teams. You don’t need a Microsoft 365 developer account, tunneling, or Teams app and bot registration to use Agents Playground. For more information, see [Agents Playground](debug-your-Teams-app-test-tool.md). | ||
| Microsoft 365 Agents Playground (previously known as Teams App Test Tool) makes debugging bot-based apps effortless. Chat with your bot and see its messages and Adaptive Cards as they appear in Teams. You don’t need a Microsoft 365 developer account, tunneling, or Teams app and bot registration to use Agents Playground. For more information, see [Agents Playground](debug-your-Teams-app-test-tool.md). |
There was a problem hiding this comment.
Here retain original as this is not a step.
This PR updates the content of the file: msteams-platform/toolkit/agents-toolkit-fundamentals.md.
Submitted by: @yashy797