Merge branch 'main' into upd-aif-ext-042925

Author: ms-johnalex

articles/ai-foundry/how-to/develop/ai-template-get-started.md

@@ -7,7 +7,7 @@ ms.service: azure-ai-foundry
 ms.custom:
   - ignite-2024
 ms.topic: how-to
-ms.date: 02/20/2025
+ms.date: 04/28/2025
 ms.reviewer: varundua
 ms.author: sgilley
 author: sdgilley
@@ -38,7 +38,6 @@ Available templates include:
 1. On the left pane, select **Templates** (preview).
 1. Find the solution template you want to use.
 1. Select **Open in Github** to view the entire sample application.
-1. Or, clone the repository to your local machine with the provided command.
 1. In some cases, you can also view a step-by-step tutorial that explains the AI code.
 
 ## Explore the sample application
@@ -56,13 +55,6 @@ Instructions vary by sample, but most include how to:
 
 The README also includes information about the application, such as the use case, architecture, and pricing information.
 
-> [!TIP]
-> Discover more templates in our curated [AZD templates collection](https://azure.github.io/ai-app-templates). Deploy them with a single command ```azd up``` using the [Azure Developer CLI](/azure/developer/azure-developer-cli/).
-
-
-
-
 ## Related content
 
 - [Get started building a chat app using the Azure AI Foundry SDK](../../quickstarts/get-started-code.md)
-- [Develop AI apps using Azure AI services](/azure/developer/ai/)

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

@@ -7,7 +7,7 @@ ms.service: azure-ai-foundry
 content_well_notification: 
   - AI-contribution
 ms.topic: how-to
-ms.date: 04/21/2025
+ms.date: 04/28/2025
 ms.reviewer: erichen
 ms.author: johalexander
 author: ms-johnalex
@@ -122,7 +122,7 @@ When you open a project in the Azure AI Foundry Extension, that project is set a
 
 Switch your default project by following these steps:
 
-1. Right-click on your deployed model and select the **Switch Default Project in Azure Extension** option. 
+1. Right-click on the Azure AI Foundry Project and select the **Switch Default Project in Azure Extension** option. 
 
 1. In the top center, select the Azure AI Foundry Project you want to use from the list of available projects and press Enter.
 

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

@@ -13,7 +13,7 @@ ms.author: johalexander
 author: ms-johnalex
 ---
 
-# Work with Azure AI Agent Service in Visual Studio Code
+# Work with Azure AI Agent Service in Visual Studio Code (Preview)
 
 After you [get started with the AI Foundry the VS Code extension](./get-started-projects-vs-code.md), you can work with [Azure AI Agent Service](/azure/ai-services/agents/overview). Agents are "smart" microservices that:
 
@@ -25,6 +25,8 @@ Agents combine AI models with tools to access and interact with your data.
 
 Azure AI Foundry developers can stay productive by developing, testing, and deploying agents in the familiar and powerful environment of VS Code.
 
+[!INCLUDE [feature-preview](../../includes/feature-preview.md)]
+
 ###	Create and edit Azure AI Agents within the designer view
 
 Follow these steps to create an Azure AI Agent:

articles/ai-foundry/model-inference/how-to/use-structured-outputs.md

@@ -0,0 +1,54 @@
+---
+title: How to use structured outputs for chat models
+titleSuffix: Azure AI Foundry
+description: Learn how to use structure outputs with chat completions with Azure AI model inference
+manager: scottpolly
+author: msakande
+reviewer: santiagxf
+ms.service: azure-ai-model-inference
+ms.topic: how-to
+ms.date: 4/29/2025
+ms.author: mopeakande
+ms.reviewer: fasantia
+ms.custom: references_regions
+zone_pivot_groups: azure-ai-inference-samples
+---
+
+# How to use structured outputs for chat models
+
+
+::: zone pivot="programming-language-python"
+
+[!INCLUDE [python](../includes/use-structured-outputs/python.md)]
+::: zone-end
+
+
+::: zone pivot="programming-language-javascript"
+
+[!INCLUDE [javascript](../includes/use-structured-outputs/javascript.md)]
+::: zone-end
+
+
+::: zone pivot="programming-language-java"
+
+[!INCLUDE [java](../includes/use-structured-outputs/java.md)]
+::: zone-end
+
+
+::: zone pivot="programming-language-csharp"
+
+[!INCLUDE [csharp](../includes/use-structured-outputs/csharp.md)]
+::: zone-end
+
+
+::: zone pivot="programming-language-rest"
+
+[!INCLUDE [rest](../includes/use-structured-outputs/rest.md)]
+::: zone-end
+
+## Related content
+
+* [Use embeddings models](use-embeddings.md)
+* [Use image embeddings models](use-image-embeddings.md)
+* [Use reasoning models](use-chat-reasoning.md)
+* [Azure AI Model Inference API](.././reference/reference-model-inference-api.md)

articles/ai-foundry/model-inference/includes/use-structured-outputs/csharp.md

@@ -0,0 +1,17 @@
+---
+title: How to use structured outputs for chat models with Azure AI model inference
+titleSuffix: Azure AI Foundry
+description: Learn how to use structured outputs with chat completions with Azure AI model inference
+manager: scottpolly
+author: msakande
+reviewer: santiagxf
+ms.service: azure-ai-model-inference
+ms.topic: how-to
+ms.date: 1/21/2025
+ms.author: mopeakande
+ms.reviewer: fasantia
+zone_pivot_groups: azure-ai-inference-samples
+---
+
+> [!NOTE]
+> This example is not available in the selected language.

articles/ai-foundry/model-inference/includes/use-structured-outputs/intro.md

@@ -0,0 +1,32 @@
+---
+manager: nitinme
+ms.service: azure-ai-model-inference
+ms.topic: include
+ms.date: 1/31/2025
+ms.author: fasantia
+author: santiagxf
+---
+
+[!INCLUDE [Feature preview](~/reusable-content/ce-skilling/azure/includes/ai-studio/includes/feature-preview.md)]
+
+When working with software, it's more challenging to parse free-form text outputs coming from language models. Structured outputs, like JSON, provide a clear format that software routines can read and process. This article explains how to use structured outputs to generate specific JSON schemas with the chat completions API with models deployed to Azure AI model inference in Azure AI services.
+
+Typical scenarios of structured outputs include:
+
+> [!div class="checklist"]
+> * You need to extract specific information from a prompt and such information can be described as an schema with specific keys and types.
+> * You need to parse information contained in the prompts.
+> * You are using the model to control a workflow in your application where you can benefit from more rigid structures.
+> * You are using the model as a zero-shot or few-shot learner.
+
+## Prerequisites
+
+To use structured outputs with chat completions models in your application, you need:
+
+[!INCLUDE [how-to-prerequisites](../how-to-prerequisites.md)]
+
+* A chat completions model deployment with JSON and structured outputs support. If you don't have one read [Add and configure models to Azure AI services](../../how-to/create-model-deployments.md).
+
+    * You can check which models support structured outputs by checking the column **Response format** in the [Models](../../concepts/models.md) article.
+
+    * This article uses `gpt-4o`.

articles/ai-foundry/model-inference/includes/use-structured-outputs/java.md

@@ -0,0 +1,17 @@
+---
+title: How to use structured outputs for chat models with Azure AI model inference
+titleSuffix: Azure AI Foundry
+description: Learn how to use structured outputs with chat completions with Azure AI model inference
+manager: scottpolly
+author: msakande
+reviewer: santiagxf
+ms.service: azure-ai-model-inference
+ms.topic: how-to
+ms.date: 1/21/2025
+ms.author: mopeakande
+ms.reviewer: fasantia
+zone_pivot_groups: azure-ai-inference-samples
+---
+
+> [!NOTE]
+> This example is not available in the selected language.