[Dev-Docs AI Improvement]: Build your first agent #13665
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
Contributor
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 |
Contributor
|
Learn Build status updates of commit e4d4354:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| msteams-platform/agents-in-teams/build-first-agent.md | View | Details |
msteams-platform/agents-in-teams/build-first-agent.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 31, Column 40: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/icons/m-365-agents-toolkit-icon.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 33, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/create-new-agent.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/agents-in-teams/first-agent-qsg/teams-agents.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 39, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/general-teams-agent.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 42, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/access-llm.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 51, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/select-language.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 54, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/select-workspace.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 57, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/add-agent-name.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 59, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/trust-author.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 78, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/run-agent-in-teams.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 81, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/select-agent-prompt.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 83, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/agent-response.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 31, Column 40: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/icons/m-365-agents-toolkit-icon.png' will be broken in isolated environments. Replace with a relative link. - Line 33, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/create-new-agent.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/agents-in-teams/first-agent-qsg/teams-agents.png' will be broken in isolated environments. Replace with a relative link. - Line 39, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/general-teams-agent.png' will be broken in isolated environments. Replace with a relative link. - Line 42, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/access-llm.png' will be broken in isolated environments. Replace with a relative link. - Line 51, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/select-language.png' will be broken in isolated environments. Replace with a relative link. - Line 54, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/select-workspace.png' will be broken in isolated environments. Replace with a relative link. - Line 57, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/add-agent-name.png' will be broken in isolated environments. Replace with a relative link. - Line 59, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/agents-in-teams/first-agent-qsg/trust-author.png' will be broken in isolated environments. Replace with a relative link.
This comment lists only the first 25 errors (including error/warning/suggestion) in the pull request.
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.
SharanGarcha-MSFT
requested changes
Dec 10, 2025
| @@ -1,11 +1,3 @@ | |||
| --- | |||
Collaborator
There was a problem hiding this comment.
Do not delete these elements. These are mandatory for the article
| ## Create an agent using Microsoft 365 Agents Toolkit | ||
|
|
||
| 1. Open Visual Studio Code. | ||
| 1. Select the Microsoft 365 Agents Toolkit :::image type="icon" source="~/assets/icons/m-365-agents-toolkit-icon.png" border="false"::: icon in the Visual Studio Code **Activity Bar**. |
Collaborator
There was a problem hiding this comment.
Do not delete this path. Retain this for all images
| :::column-end::: | ||
| :::row-end::: | ||
|
|
||
| **Description** |
Collaborator
There was a problem hiding this comment.
Retain original for the look and feel.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR updates the content of the file: msteams-platform/agents-in-teams/build-first-agent.md.
Submitted by: @yashy797