Merge pull request #4408 from ms-johnalex/upd-aif-ext-042925

Update AI Foundry Extension agent article for 0.3.0 release

Author: JamesJBarnett

articles/ai-foundry/how-to/develop/vs-code-agents.md

@@ -7,7 +7,7 @@ ms.service: azure-ai-foundry
 content_well_notification: 
   - AI-contribution
 ms.topic: how-to
-ms.date: 04/28/2025
+ms.date: 04/29/2025
 ms.reviewer: erichen
 ms.author: johalexander
 author: ms-johnalex
@@ -179,25 +179,27 @@ Selecting the deployed agent opens the **Agent Preferences** page in a view only
 
 Open the **Agents Playground** using the following steps:
 
-1. Right-click on your deployed agent and select the **Open Playground** option This action starts a thread with your agent and let you send messages.
+1. Right-click on your deployed agent and select the **Open Playground** option This action starts a thread with your agent and let you send messages. 
+
+1. Alternatively, select the **Agent Playground** link in the **Tools** subsection, and select your agent from the top-center list. 
 
 1. The **Playground** page is displayed.
 
     :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-display-playground.png" alt-text="Screenshot of the **Agents Playground** page in VS Code." lightbox="../../media/how-to/get-started-projects-vs-code/agent-display-playground.png":::
 
-1. Type your prompt and see the outputs. 
+1. Type your prompt and see the outputs. The **Grounding with Bing search** tool is used to search the web for information. The agent uses the model and tools you configured in the agent designer. The source of the information is displayed in the **Agent Annotations** section, highlighted in the following image. 
+
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-playground-run.png" alt-text="Screenshot of the Agents Playground page with agent annotations highlighted in VS Code." lightbox="../../media/how-to/get-started-projects-vs-code/agent-playground-run.png":::
 
 ## Explore Threads
 
 The **Threads** subsection displays the threads created during a run with your agent. In the Azure Resources Extension view, select the **caret** icon in front of the **Threads** subsection to view the list of threads.
 
 :::image type="content" source="../../media/how-to/get-started-projects-vs-code/thread-list.png" alt-text="Screenshot of the threads in the Threads subsection." lightbox="../../media/how-to/get-started-projects-vs-code/thread-list.png":::
 
-
-
 ###  View thread details
 
-Select a thread to view its details. The **Thread Details** page is displayed. 
+Select a thread to see the **Thread Details** page.
 
 :::image type="content" source="../../media/how-to/get-started-projects-vs-code/thread-view.png" alt-text="Screenshot of the thread details view." lightbox="../../media/how-to/get-started-projects-vs-code/thread-view.png":::
 
@@ -207,6 +209,11 @@ Select a thread to view its details. The **Thread Details** page is displayed.
 
 - A **Run** is a single execution of an agent. Each run can have multiple threads, and each thread can have multiple messages. The agent uses its configuration and Thread’s Messages to perform tasks by calling models and tools. As part of a Run, the agent appends Messages to the Thread.
 
+###  View run details
+
+Select the **View run info** button in the **Thread Details** page to see the run information in a JSON file.
+
+:::image type="content" source="../../media/how-to/get-started-projects-vs-code/run-file.png" alt-text="Screenshot of the run details .json file." lightbox="../../media/how-to/get-started-projects-vs-code/run-file.png":::
 
 ## Cleanup resources
 
@@ -216,15 +223,15 @@ The Azure resources that you created in this article are billed to your Azure su
 
 Delete the deployed agent in the [online AI Foundry portal](https://ai.azure.com). Select **Agents** from the navigation menu on the left, select your agent, then select the **Delete** button.
 
-:::image type="content" source="../../media/how-to/get-started-projects-vs-code/delete-agent.png" alt-text="Screenshot of the AI Foundry portal with 'Agents' from the navigation menu on the left and the **Delete** button highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/delete-agent.png":::
+:::image type="content" source="../../media/how-to/get-started-projects-vs-code/delete-agent.png" alt-text="Screenshot of the AI Foundry portal with Agents from the navigation menu on the left and the Delete button highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/delete-agent.png":::
 
 ### Delete your models
 
 1. In the VS Code navbar, refresh the **Azure Resources** view. Expand the **Models** subsection to display the list of deployed models.
 
 1. Right-click on your deployed model to delete and select the **Delete** option.
 
-    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/delete-model.png" alt-text="Screenshot of the model context menu with the 'Delete' option highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/delete-model.png":::
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/delete-model.png" alt-text="Screenshot of the model context menu with the Delete option highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/delete-model.png":::
 
 ### Delete your tools
 
@@ -236,4 +243,4 @@ Delete the connected tool with the following steps:
 
 ##	Next steps
 
-- Learn about the tools you can use with Azure AI Agents, such as [file search](/azure/ai-services/agents/how-to/tools/file-search?tabs=python&pivots=overview), or [code interpreter](/azure/ai-services/agents/how-to/tools/code-interpreter?tabs=python&pivots=overview).
+- Learn about the tools you can use with Azure AI Agents, such as [file search](/azure/ai-services/agents/how-to/tools/file-search?tabs=python&pivots=overview), or [code interpreter](/azure/ai-services/agents/how-to/tools/code-interpreter?tabs=python&pivots=overview).