[Dev-Docs AI Improvement]: Build your first agent #13650
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 0f0245b: ✅ Validation status: passed
For more details, please refer to the build report. |
| ## See also | ||
|
|
||
| [Agents user experience](../bots/how-to/teams-conversational-ai/ai-ux.md) | ||
| [Agents user experience](../bots/how-to/teams-conversational-ai/ai-ux.md) |
There was a problem hiding this comment.
I don't find any change here.
| :::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/select-agent-prompt.png" alt-text="Screenshot shows how to select a prompt from the agent." lightbox="../assets/images/agents-in-teams/first-agent-qsg/select-agent-prompt.png"::: | ||
|
|
||
| When you select the prompt, it shows up in the comment box, and you can select the **Send** icon. The agent responds to the prompt. | ||
| When you select the prompt, it appears in the comment box. Select the **Send** icon to receive the agent's response. |
There was a problem hiding this comment.
Select send icon to get the agent's response. Also, don't know it is an icon or button
| | `env` | Environment files. | | ||
| | `infra` | Templates for provisioning Azure resources. | | ||
| | `src` | The source code for the project. | | ||
| | `src` | Source code for the project. | |
There was a problem hiding this comment.
These descriptions we usually copy from the VS code. So not sure if we should change them
| :::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/add-agent-name.png" alt-text="Screenshot shows the field to add the agent name." lightbox="../assets/images/agents-in-teams/first-agent-qsg/add-agent-name.png"::: | ||
|
|
||
| The toolkit displays a message that the agent has been successfully created. You can also provision the agent at this time or later. If the toolkit displays a message to confirm if you trust the author, select **Yes, I trust the authors**. | ||
| The toolkit displays a message indicating successful agent creation. You can provision the agent immediately or later. If the toolkit asks to confirm trust for the author, select **Yes, I trust the authors**. |
There was a problem hiding this comment.
The first sentence has "displays the message" and also the second one. But only the second one is changed.
| # Build your first agent | ||
|
|
||
| Agents use AI to automate and execute business processes, working alongside or on behalf of a person, team, or organization. Agents range from simple prompt-and-response agents to more advanced, fully autonomous agents. | ||
| Agents utilize AI to automate and execute business processes, working alongside or on behalf of a person, team, or organization. Agents range from simple prompt-and-response implementations to more advanced, fully autonomous solutions. |
There was a problem hiding this comment.
It should be "Agents use".
It should be agents not implementations.
It should be agents not solutions.
| | Install | For using... | | ||
| | --- | --- | | ||
| | [Visual Studio Code](https://code.visualstudio.com/download) | JavaScript, TypeScript, or Python build environments. Use the latest version. | | ||
| | [Teams SDK](/microsoftteams/platform/teams-ai-library/teams/overview) | A simplified SDK for building intelligent agents. Now GA for JavaScript and C#, and in public preview for Python. | |
There was a problem hiding this comment.
A simplified is correct
| | [Microsoft 365 Agents Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension) | Microsoft Visual Studio Code extension that creates project scaffolding for your agent. Use latest version.| | ||
| | [Node.js](https://nodejs.org/en/download/) | Back-end JavaScript runtime environment. For more information, see [Node.js version compatibility table for project type](~/toolkit/build-environments.md#nodejs-version-compatibility-table-for-project-type).| | ||
| | [Microsoft Teams](https://www.microsoft.com/microsoft-teams/download-app) | Microsoft Teams to collaborate with everyone you work with through agents and apps for chat, meetings, and calls all in one place.| | ||
| | [Azure OpenAI](https://oai.azure.com/portal)| First create your OpenAI API key to use OpenAI's Generative Pretrained Transformer (GPT). If you want to host your agent or access resources in Azure, you must create an Azure OpenAI service.| |
There was a problem hiding this comment.
We should use the article an here.
| | --- | --- | | ||
| | [Visual Studio Code](https://code.visualstudio.com/download) | JavaScript, TypeScript, or Python build environments. Use the latest version. | | ||
| | [Teams SDK](/microsoftteams/platform/teams-ai-library/teams/overview) | A simplified SDK for building intelligent agents. Now GA for JavaScript and C#, and in public preview for Python. | | ||
| | [Microsoft 365 Agents Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension) | Microsoft Visual Studio Code extension that creates a project scaffolding for your agent. Use the latest version.| |
There was a problem hiding this comment.
We should use the article the here
|
|
||
| ## Set up your environment | ||
|
|
||
| 1. Install the latest versions of Visual Studio Code, Node.js, and the Microsoft 365 Agents Toolkit. |
There was a problem hiding this comment.
The should be used here. "Install the latest versions.
| ## Set up your environment | ||
|
|
||
| 1. Install the latest versions of Visual Studio Code, Node.js, and the Microsoft 365 Agents Toolkit. | ||
| 1. If you want to use Azure OpenAI service to access large language model (LLM) for your agent, create an Azure OpenAI service on the [Azure portal](https://ms.portal.azure.com/#home) and get your API key. |
There was a problem hiding this comment.
For plain English we can say "If you want to use"
This PR updates the content of the file: msteams-platform/agents-in-teams/build-first-agent.md.
Submitted by: @yashy797