Merge pull request #6336 from ms-johnalex/aif-vsc-upd-070925

AI Foundry VS Code Extension 0.18.0 update

Author: v-regandowner

articles/ai-foundry/how-to/develop/get-started-projects-vs-code.md

@@ -8,7 +8,7 @@ content_well_notification:
   - AI-contribution
 ai-usage: ai-assisted
 ms.topic: how-to
-ms.date: 07/10/2025
+ms.date: 08/05/2025
 ms.reviewer: erichen
 ms.author: johalexander
 author: ms-johnalex
@@ -48,7 +48,20 @@ Before using the Azure AI Foundry for Visual Studio Code extension, you must:
 
 After you install Visual Studio Code, you need to install the Azure AI Foundry for Visual Studio Code extension.
 
-To install the Azure AI Foundry for Visual Studio Code extension:
+To install the Azure AI Foundry for Visual Studio Code extension, you can either use the Visual Studio Code Marketplace or install it directly from within Visual Studio Code.
+
+### Install from the Visual Studio Code Marketplace
+To install the Azure AI Foundry for Visual Studio Code extension from the Visual Studio Code Marketplace, follow these steps:
+
+1. Open the [Azure AI Foundry for Visual Studio Code extension page](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.vscode-ai-foundry).
+1. Select the **Install** button.
+1. Follow the prompts to install the extension in Visual Studio Code.
+1. After installation, open Visual Studio Code and verify the extension is installed successfully from the status messages.
+1. The extension should now be visible in the primary navigation bar on the left side of Visual Studio Code.
+
+### Install from within Visual Studio Code
+
+To install the Azure AI Foundry for Visual Studio Code extension in Visual Studio Code, follow these steps:
 
 1. Open Visual Studio Code.
 
@@ -70,7 +83,6 @@ Get started with the Azure AI Foundry extension by using the following steps.
 > For a full list of features available in the extension, use the Command Palette. Select <kbd>F1</kbd> to open the command palette and search **Azure AI Foundry**. The following screenshot shows some of the actions for Azure AI Foundry.
 >     :::image type="content" source="../../media/how-to/get-started-projects-vs-code/visual-studio-command-palette-small.png" alt-text="A screenshot of the Visual Studio Code command palette for Azure AI Foundry." lightbox="../../media/how-to/get-started-projects-vs-code/visual-studio-command-palette-small.png":::
 
-
 ### Sign in to your resources
 
 Sign in to your Azure subscription to access your resources with the following steps:
@@ -101,6 +113,9 @@ The Azure AI Foundry Extension opens in its own view, with the Azure AI Foundry
 - **Resources**: This section contains the resources you have access to in your Azure AI Foundry project. The **Resources** section is the main view for interacting with your Azure AI Foundry Services. It contains the following subsections:
   - **Models**: This section contains the models you can use to build and deploy your AI applications. The **Models** view is where you can find your deployed models in your Azure AI Foundry project.  
   - **Agents**: This section contains your deployed agents in your Azure AI Foundry project.
+  - **Assets**: This section contains the assets you have in your Azure AI Foundry project.
+      - Connections: This subsection contains the connections you have in your Azure AI Foundry project. for example, Bing Grounding connections.
+      - Vector Stores: This subsection contains the vector stores you have in your Azure AI Foundry project.
   - **Threads**: This section contains the threads and runs from a deployed agent in your Azure AI Foundry project.
 
 - **Tools**: This section contains the tools you can use to build and deploy your AI applications. The **Tools** view is where you can find the tools available to deploy and then work with your deployed models and agents. It contains the following subsections:
@@ -112,6 +127,7 @@ The Azure AI Foundry Extension opens in its own view, with the Azure AI Foundry
     - **Documentation**: The link to the Azure AI Foundry Extension documentation.
     - **GitHub**: The link to the Azure AI Foundry extension GitHub repository.
     - **Microsoft Privacy Statement**: The link to the Microsoft Privacy Statement.
+    - **Join the Foundry Community: Discord + Forum**: The link to the Azure AI Foundry community Discord server.
 
 >[!NOTE]
 > To learn more about working with Agents and Threads in the Azure AI Foundry Extension, see the [Work with Azure AI Foundry Agent Service in Visual Studio Code](./vs-code-agents.md) article. 
@@ -130,11 +146,11 @@ You can either create a new resource group or select an existing one.
 - To create a new resource group:
     1. In the top center, select **Create new resource group** and press Enter.
 
-    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/select-resource-group.png" alt-text="Screenshot of the Choose resource group dropdown with the Create new resource group item highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/select-resource-group.png":::  
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/select-resource-group.png" alt-text="Screenshot of the Choose resource group dropdown with the Create new resource group item highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/select-resource-group.png":::
 
-    1. In the top center, enter the Azure Resource Group name to use in the **Enter new resource group** textbox and press Enter.
+    2. In the top center, enter the Azure Resource Group name to use in the **Enter new resource group** textbox and press Enter.
 
-    1. In the top center, select the location you want to use from the list of available locations and press Enter.
+    3. In the top center, select the location you want to use from the list of available locations and press Enter.
 
 - To use an existing resource group:
     1. In the top center, select the resource group you want to use from the list of available resource groups and press Enter.
@@ -213,21 +229,24 @@ Deploy a selected model in the model catalog using the following steps:
 
     :::image type="content" source="../../media/how-to/get-started-projects-vs-code/deploy-from-model-catalog.png" alt-text="Screenshot of the highlighted Deploy in Azure link of the selected model." lightbox="../../media/how-to/get-started-projects-vs-code/deploy-from-model-catalog.png":::
 
-1. In the top center, select the AI service to use in the **Choose an AI service** dropdown and press Enter.
+1. The **Model deployment** page is displayed.
+
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/model-deployment-page.png" alt-text="Screenshot of the **Model deployment** page in VS Code." lightbox="../../media/how-to/get-started-projects-vs-code/model-deployment-page.png":::
 
-    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/choose-ai-service.png" alt-text="Screenshot of the Choose an AI service dropdown." lightbox="../../media/how-to/get-started-projects-vs-code/choose-ai-service.png":::
+1. Enter the model deployment name to use in the **Enter deployment name** textbox and press Enter.
 
-1. In the top center, select the model version to use in the **Choose model version** dropdown and press Enter.
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/enter-deployment-name.png" alt-text="Screenshot of the Enter deployment name textbox." lightbox="../../media/how-to/get-started-projects-vs-code/enter-deployment-name.png":::
+1. Select the deployment type to use in the **Deployment type** dropdown and press Enter.
 
-    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/select-model-version.png" alt-text="Screenshot of the Choose model version dropdown." lightbox="../../media/how-to/get-started-projects-vs-code/select-model-version.png":::
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/select-deployment-type.png" alt-text="Screenshot of the Deployment type dropdown." lightbox="../../media/how-to/get-started-projects-vs-code/select-deployment-type.png":::
 
-1. In the top center, select the deployment type to use in the **Choose deployment type** dropdown and press Enter.
+1. Select the model version to use in the **Model version** dropdown and press Enter.
 
-    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/select-deployment-type.png" alt-text="Screenshot of the Choose deployment type dropdown." lightbox="../../media/how-to/get-started-projects-vs-code/select-deployment-type.png":::
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/select-model-version.png" alt-text="Screenshot of the Model version dropdown." lightbox="../../media/how-to/get-started-projects-vs-code/select-model-version.png":::
 
-1. In the top center, enter the model deployment name to use in the **Enter deployment name** textbox and press Enter.
+1. (Optional) Select the tokens per minute to use in the **Tokens per minute** slider and press Enter.
 
-    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/enter-deployment-name.png" alt-text="Screenshot of the Enter deployment name textbox." lightbox="../../media/how-to/get-started-projects-vs-code/enter-deployment-name.png":::
+1. In the bottom-left corner, select the **Deploy in Azure AI Foundry** button to deploy the model.
 
 1. A confirmation dialog box appears. Select the **Deploy** button to deploy the model to your project.
 
@@ -345,4 +364,4 @@ Delete the connected tool with the following steps:
 
 ##    Next steps
 
-- Learn about [working with the Azure AI Foundry Agent Service](./vs-code-agents.md) using this Visual Studio Code extension.
+- Learn about [working with the Azure AI Foundry Agent Service](./vs-code-agents.md) using this Visual Studio Code extension.

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

@@ -8,7 +8,7 @@ content_well_notification:
   - AI-contribution
 ai-usage: ai-assisted
 ms.topic: how-to
-ms.date: 07/10/2025
+ms.date: 08/05/2025
 ms.reviewer: erichen
 ms.author: johalexander
 author: ms-johnalex
@@ -28,7 +28,7 @@ Azure AI Foundry developers can stay productive by developing, testing, and depl
 
 [!INCLUDE [feature-preview](../../includes/feature-preview.md)]
 
-###    Create and edit Azure AI Agents within the designer view
+## Create and edit Azure AI Agents within the designer view
 
 Follow these steps to create an Azure AI Agent:
 
@@ -62,7 +62,7 @@ After you choose your save location, both the agent .yaml file and the Designer
 
     1. To save the .yaml file, select **File** > **Save** in the VS Code menu bar.
 
-###    Explore the Azure AI Agent YAML definition
+### Explore the Azure AI Agent YAML definition
 
 Your AI Agent .yaml file was opened at the same time the designer was. This file contains the details and setup information for your agent, similar to the following .yaml file example: 
 
@@ -88,80 +88,49 @@ instructions: Instructions for the agent
 tools: []
 ```
 
-### Add tools to the Azure AI Agent
+## Add tools to the Azure AI Agent
 
+Azure AI Agent Service has a set of tools that you can use to interact with your data sources. 
 
-Azure AI Agent Service has a set of knowledge and action tools that you can use to interact with your data sources. 
+#### Available tools for Azure AI Agents in the Azure AI Foundry VS Code extension
 
+The following tools are available in the Azure AI Foundry VS Code extension:
 
-#### Available tools for Azure AI Agents
-
-The following tools are available:
-
-- Knowledge tools:
   - [Grounding with Bing search](/azure/ai-services/agents/how-to/tools/bing-grounding?tabs=python&pivots=overview)
-  - [File search]( /azure/ai-services/agents/how-to/tools/file-search?tabs=python&pivots=overview)
-  - [Azure AI Search](/azure/ai-services/agents/how-to/tools/azure-ai-search?tabs=pythonsdk&pivots=overview)   
-  - [Microsoft Fabric](/azure/ai-services/agents/how-to/tools/fabric?pivots=portal)
-
-- Action tools:
-  - [Azure AI Agents function calling](/azure/ai-services/agents/how-to/tools/function-calling?pivots=python)
-
-Azure AI Foundry Agent Service has a set of knowledge and action tools that you can use to interact with your data sources, such as:
- - [Grounding with Bing search](/azure/ai-services/agents/how-to/tools/bing-grounding?tabs=python&pivots=overview)
- - [Azure AI Search](/azure/ai-services/agents/how-to/tools/azure-ai-search?tabs=pythonsdk&pivots=overview) 
- - [Azure Functions](/azure/ai-services/agents/how-to/tools/azure-functions?tabs=python&pivots=overview) 
- - [File search](/azure/ai-services/agents/how-to/tools/file-search?tabs=python&pivots=overview) 
- - [Code interpreter](/azure/ai-services/agents/how-to/tools/code-interpreter?tabs=python&pivots=overview)
- - [OpenAPI Specified tools](/azure/ai-services/agents/how-to/tools/openapi-spec?tabs=python&pivots=overview)
- - [SharePoint](/azure/ai-services/agents/how-to/tools/sharepoint?tabs=python&pivots=overview)
-
-#### Configure the tools YAML file
-
-The Agent Designer adds tools to an AI Agent via .yaml files. 
-
-Create a tool configuration .yaml file using the following steps:
+  - [File search](/azure/ai-services/agents/how-to/tools/file-search?tabs=python&pivots=overview) 
+  - [Code interpreter](/azure/ai-services/agents/how-to/tools/code-interpreter?tabs=python&pivots=overview)
+  - [OpenAPI Specified tools](/azure/ai-services/agents/how-to/tools/openapi-spec?tabs=python&pivots=overview)
 
-1. Choose a tool from the [available tools for Azure AI Agents](#available-tools-for-azure-ai-agents). Perform any setup steps that might be required. For example, [Grounding with Bing search](/azure/ai-services/agents/how-to/tools/bing-grounding?tabs=python&pivots=overview#setup).
 
-1. Once you complete the setup, create a yaml code file that specifies the tool's configuration. For example, this format for Grounding with Bing Search:
-
-    ```yml
-    type: bing_grounding
-    options:
-      tool_connections:
-        - >-
-          /subscriptions/<Azure Subscription ID>/resourceGroups/<Azure Resource Group name>/providers/Microsoft.MachineLearningServices/workspaces/<Azure AI Foundry Project name>/connections/<Bing connection name>
-    ```
-1. Replace the placeholders in the connection string under the `tool_connections` section with your information: 
-    
-    - Azure Subscription ID
-    - Azure Resource Group name
-    - Azure AI Foundry Project name
-    - Bing connection name
-
-1. To save the .yaml file, select **File** > **Save** in the VS Code menu bar.
-
-#### Connect the tools file to the AI Agent
+#### Add a tool to the AI Agent
 
 Add a tool to the AI Agent with the following steps:
 
 1. Select the **Add tool** button in the top-right corner of the **TOOL** section in the designer to show the dropdown. Choose the tool you want to add.
 
     :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-tool-plus.png" alt-text="Screenshot of the Agent designer TOOL section with the plus icon highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/agent-tool-plus.png":::
 
-1. In the file explorer that appears, select the .yaml tool file to use. Select the **Select a tool file** button to add the tool to the agent.
 
-    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-select-tool-file.png" alt-text="Screenshot of the file explorer with the selected file and the 'Select a tool file' button highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/agent-select-tool-file.png":::
+1. The designer displays the appropriate pane to configure the tool, as in the following images:
 
-1. The tool is displayed in the **TOOL** section. 
+    Code interpreter tool dialog box:
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-ci-tool-dialog.png" alt-text="Screenshot of the Code interpreter tool dialog box." lightbox="../../media/how-to/get-started-projects-vs-code/agent-ci-tool-dialog.png":::
+    
+    File upload tool dialog box:
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-file-search-tool-dialog.png" alt-text="Screenshot of the File upload tool dialog box." lightbox="../../media/how-to/get-started-projects-vs-code/agent-file-search-tool-dialog.png":::
 
-    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-added-tool.png" alt-text="Screenshot of the Agent designer TOOL section with the new tool highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/agent-added-tool.png":::
+    Grounding with Bing Search dialog box:
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-bing-tool-dialog.png" alt-text="Screenshot of the Grounding with Bing Search tool dialog box." lightbox="../../media/how-to/get-started-projects-vs-code/agent-bing-tool-dialog.png":::
 
-1. To save the tool .yaml file, select **File** > **Save** in the VS Code menu bar.
+    OpenAPI 3.0 Specified dialog box:
+    :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-openapi-tool-dialog.png" alt-text="Screenshot of the OpenAPI 3.0 Specified tool dialog box." lightbox="../../media/how-to/get-started-projects-vs-code/agent-openapi-tool-dialog.png":::
 
+1. After entering the required information, select the **Upload and save** button in the bottom-left corner.
+ 
+> [!NOTE]
+> When you add a tool, you can also add any new assets it needs. For example, if you add a File Search tool, you can use an existing vector store asset or make a new asset for your vector store to host your uploaded files.
 
-###    Create Azure AI Agents on the Azure AI Foundry Studio
+### Create Azure AI Agents on the Azure AI Foundry Studio
 
 Create your agent directly on Azure AI Foundry with the following steps: