Merge pull request #3777 from MicrosoftDocs/main

3/27/2025 AM Publish

Author: Taojunshen

articles/ai-foundry/how-to/autoscale.md

@@ -8,7 +8,7 @@ ms.custom:
   - ignite-2023
   - build-2024
 ms.topic: how-to
-ms.date: 12/09/2024
+ms.date: 03/27/2025
 ms.reviewer: siarora
 ms.author: larryfr
 author: Blackmist

articles/ai-foundry/how-to/develop/sdk-overview.md

@@ -7,8 +7,8 @@ ms.service: azure-ai-foundry
 ms.custom:
   - build-2024
   - ignite-2024
-ms.topic: overview
-ms.date: 02/27/2025
+ms.topic: how-to
+ms.date: 03/27/2025
 ms.reviewer: dantaylo
 ms.author: sgilley
 author: sdgilley
@@ -31,18 +31,75 @@ If you want to jump right in and start building an app, check out:
 - [Create a chat app](../../quickstarts/get-started-code.md)
 - [Create a custom RAG app](../../tutorials/copilot-sdk-create-resources.md)
 
-## Get started with Projects
+## Prerequisites
 
-The best way to get started using the Azure AI Foundry SDK is by using a project. AI projects connect together different data, assets, and services you need to build AI applications. The AI project client allows you to easily access these project components from your code by using a single connection string.
+* An Azure subscription. If you don't have one, create a [free account](https://azure.microsoft.com/free/).
+* [Create a project](../create-projects.md) if you don't have one already.
+* Sign in with the Azure CLI using the same account that you use to access your AI Project:
 
-First follow steps to [create an AI Project](../create-projects.md) if you don't have one already.
+    ```bash
+    az login
+    ```
 
-Sign in with the Azure CLI using the same account that you use to access your AI Project:
+## Install everything
 
-```bash
-az login
+Install all the Azure AI Foundry SDK packages as shown here, or install only the packages you need in the following sections.
+
+::: zone pivot="programming-language-python"
+
+1. Create a file named **requirements.txt**. Add the following packages to the file:
+
+    ```txt
+    azure-ai-projects 
+    azure-identity 
+    openai 
+    azure-ai-inference 
+    azure-search-documents 
+    azure-ai-evaluation 
+    azure-monitor-opentelemetry
+    ```
+
+1. Install the packages:
+
+    ```bash
+    pip install -r requirements.txt
+    ```
+
+---
+
+::: zone-end
+
+::: zone pivot="programming-language-csharp"
+
+```dotnet
+dotnet add package Azure.AI.Projects
+dotnet add package Azure.Identity
+dotnet add package Azure.AI.OpenAI
+dotnet add package Azure.AI.Inference
+dotnet add package Azure.Search.Documents
 ```
 
+Add using statements:
+
+```csharp
+using Azure.Identity;
+using Azure.AI.Projects;
+using OpenAI.Chat;
+using Azure.AI.OpenAI;
+using Azure.AI.Inference;
+using Azure.Search.Documents;
+using Azure.Search.Documents.Models;
+```
+
+---
+
+::: zone-end
+
+
+## Get started with projects
+
+The best way to get started using the Azure AI Foundry SDK is by using a project. AI projects connect together different data, assets, and services you need to build AI applications. The AI project client allows you to easily access these project components from your code by using a single connection string.
+
 Install the Azure AI projects client library:
 
 ::: zone pivot="programming-language-python"

articles/ai-foundry/how-to/disaster-recovery.md

@@ -10,7 +10,7 @@ ms.topic: how-to
 ms.author: larryfr
 author: Blackmist
 ms.reviewer: andyaviles
-ms.date: 12/05/2024
+ms.date: 03/26/2025
 ---
 
 # Customer enabled disaster recovery

articles/ai-services/openai/concepts/provisioned-migration.md

@@ -7,7 +7,7 @@ ms.service: azure-ai-openai
 ms.custom:
   - ignite-2024
 ms.topic: how-to
-ms.date: 03/10/2025
+ms.date: 03/26/2025
 author: aahill
 ms.author: aahi
 recommendations: false
@@ -120,7 +120,7 @@ In addition to the updates for the hourly payment model, in December 2024 new [A
 |gpt-4| 0613, 1106-Preview, 0125-Preview|
 |gpt-4-turbo| 2024-04-09|
 |gpt-4-32k| 0613|
-|gpt-4o| 2042-05-13, 2024-08-06|
+|gpt-4o| 2024-05-13, 2024-08-06|
 |gpt-4o-mini| 2024-07-18|
 
 

articles/ai-services/openai/faq.yml

@@ -7,7 +7,7 @@ metadata:
   manager: nitinme
   ms.service: azure-ai-openai
   ms.topic: faq
-  ms.date: 08/13/2024
+  ms.date: 03/27/2025
   ms.author: mbullwin
   author: mrbullwinkle
 title: Azure OpenAI Service frequently asked questions

articles/ai-services/openai/how-to/fine-tuning.md

@@ -6,7 +6,7 @@ manager: nitinme
 ms.service: azure-ai-openai
 ms.custom: build-2023, build-2023-dataai, devx-track-python, references_regions
 ms.topic: how-to
-ms.date: 02/27/2025
+ms.date: 03/27/2025
 author: mrbullwinkle
 ms.author: mbullwin
 zone_pivot_groups: openai-fine-tuning

articles/ai-services/openai/how-to/switching-endpoints.yml

@@ -7,7 +7,7 @@ metadata:
   author: mrbullwinkle
   ms.author: mbullwin
   manager: nitinme
-  ms.date: 08/29/2024
+  ms.date: 03/27/2025
   ms.service: azure-ai-openai
   ms.topic: how-to
   ms.custom:

articles/ai-services/openai/includes/batch/batch-rest.md

@@ -240,7 +240,7 @@ curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/files/{output_file_id}/c
 Cancels an in-progress batch. The batch will be in status `cancelling` for up to 10 minutes, before changing to `cancelled`, where it will have partial results (if any) available in the output file.
 
 ```http
-curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/batches/{batch_id}/cancel?api-version=2024-10-21 \
+curl -X POST https://YOUR_RESOURCE_NAME.openai.azure.com/openai/batches/{batch_id}/cancel?api-version=2024-10-21 \
   -H "api-key: $AZURE_OPENAI_API_KEY" 
 ```
 

articles/ai-services/openai/index.yml

@@ -1,17 +1,17 @@
 ### YamlMime:Landing
 
 title: Azure OpenAI Service documentation # < 60 chars
-summary: Azure OpenAI Service provides access to OpenAI's models including the GPT-4o, GPT-4o mini, GPT-4, GPT-4 Turbo with Vision, GPT-3.5-Turbo, DALLE-3 and Embeddings model series with the security and enterprise capabilities of Azure. 
+summary: Azure OpenAI Service provides access to OpenAI's models including o-series, GPT-4o, GPT-4o mini, GPT-4, GPT-4 Turbo with Vision, GPT-3.5-Turbo, DALLE-3 and Embeddings model series with the security and enterprise capabilities of Azure. 
 
 metadata:
   title: Azure OpenAI Service documentation - Quickstarts, Tutorials, API Reference - Azure AI services | Microsoft Docs
-  description: Learn how to use Azure OpenAI's powerful models including the GPT-4o, GPT-4o mini, GPT-4, GPT-4 Turbo with Vision, GPT-3.5-Turbo, DALL-E 3 and Embeddings model series
+  description: Learn how to use Azure OpenAI's powerful models including o-series, GPT-4o, GPT-4o mini, GPT-4, GPT-4 Turbo with Vision, GPT-3.5-Turbo, DALL-E 3 and Embeddings model series
   ms.service: azure-ai-openai
   ms.custom:
   ms.topic: landing-page
   author: mrbullwinkle
   ms.author: mbullwin
-  ms.date: 09/18/2024
+  ms.date: 03/27/2025
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
 # Limits: https://review.learn.microsoft.com/help/contribute/contribute-how-to-write-landing-page?branch=main#limits
@@ -86,17 +86,17 @@ landingContent:
      linkLists:
          - linkListType: get-started
            links:
-             - text: Migrate to OpenAI Python 1.x
-               url: ./how-to/migration.md
-             - text: Manage models
-               url: ./how-to/working-with-models.md
+             - text: Responses API & computer-use-preview
+               url: ./how-to/responses.md
+             - text: Reasoning models
+               url: ./how-to/reasoning.md
              - text: OpenAI versus Azure OpenAI (Python)
                url: ./how-to/switching-endpoints.yml
              - text: Global batch
                url: ./how-to/batch.md
-             - text: Role-based access control (Azure RBAC)
-               url: ./how-to/role-based-access-control.md 
-             - text: GPT-3.5 Turbo & GPT-4
+             - text: Structured outputs
+               url: ./how-to/structured-outputs.md
+             - text: Chat completion models
                url:  ./how-to/chatgpt.md
              - text: Vision-enabled models
                url:  ./how-to/gpt-with-vision.md