Merge branch 'main' into release-preview-eval-redteaming

Author: v-alje

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/abuse-monitoring.md

@@ -6,7 +6,7 @@ author: mrbullwinkle
 ms.author: mbullwin
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 09/20/2024
+ms.date: 03/27/2025
 ms.custom: template-concept, ignite-2024
 manager: nitinme
 ---
@@ -29,7 +29,7 @@ There are several components to abuse monitoring:
 
 ## Modified abuse monitoring 
 
-Some customers may want to use the Azure OpenAI Service for a use case that involves the processing of highly sensitive or highly confidential data, or otherwise may conclude that they don't want or don't have the right to permit Microsoft to store and conduct human review on their prompts and completions for abuse detection. To address these concerns, Microsoft allows customers who meet additional Limited Access eligibility criteria to apply to modify abuse monitoring by completing [this ](https://customervoice.microsoft.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR7en2Ais5pxKtso_Pz4b1_xUOE9MUTFMUlpBNk5IQlZWWkcyUEpWWEhGOCQlQCN0PWcu)form. Learn more about applying for modified abuse monitoring at [Limited access to Azure OpenAI Service](/legal/cognitive-services/openai/limited-access?context=%2Fazure%2Fai-services%2Fopenai%2Fcontext%2Fcontext), and about the impact of modified abuse monitoring on data processing at [Data, privacy, and security for Azure OpenAI Service](/legal/cognitive-services/openai/data-privacy?context=%2Fazure%2Fai-services%2Fopenai%2Fcontext%2Fcontext&tabs=azure-portal).    
+Some customers may want to use the Azure OpenAI Service for a use case that involves the processing of highly sensitive or highly confidential data, or otherwise may conclude that they don't want or don't have the right to permit Microsoft to store and conduct human review on their prompts and completions for abuse detection. To address these concerns, Microsoft allows customers who meet additional Limited Access eligibility criteria to apply to modify abuse monitoring by completing [this](https://customervoice.microsoft.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR7en2Ais5pxKtso_Pz4b1_xUOE9MUTFMUlpBNk5IQlZWWkcyUEpWWEhGOCQlQCN0PWcu)form. Learn more about applying for modified abuse monitoring at [Limited access to Azure OpenAI Service](/legal/cognitive-services/openai/limited-access?context=%2Fazure%2Fai-services%2Fopenai%2Fcontext%2Fcontext), and about the impact of modified abuse monitoring on data processing at [Data, privacy, and security for Azure OpenAI Service](/legal/cognitive-services/openai/data-privacy?context=%2Fazure%2Fai-services%2Fopenai%2Fcontext%2Fcontext&tabs=azure-portal).    
 
 > [!NOTE]
 > When abuse monitoring is modified and human review is not performed, detection of potential abuse may be less accurate. Customers are notified of potential abuse detection as described above, and should be prepared to respond to such notification to avoid service interruption if possible.  

articles/ai-services/openai/concepts/advanced-prompt-engineering.md

@@ -1,12 +1,12 @@
 ---
 title: Design system messages with Azure OpenAI
 titleSuffix: Azure OpenAI Service
-description: Learn about system message design with GPT-3, GPT-35-Turbo, and GPT-4 models.
+description: Learn about system message design
 author: mrbullwinkle
 ms.author: mbullwin 
 ms.service: azure-ai-openai
 ms.topic: conceptual 
-ms.date: 09/05/2024
+ms.date: 03/26/2025
 manager: nitinme
 keywords: ChatGPT, GPT-4, meta prompts, chain of thought
 ---
@@ -17,9 +17,9 @@ This guide will walk you through some techniques in system message design.
 
 
 
-## What is a system message? 
+## What is a system message?
 
-A system message is a feature-specific set of instructions or contextual frameworks given to a generative AI model (e.g. GPT4-o, GPT3.5 Turbo, etc.) to direct and improve the quality and safety of a model’s output. This is particularly helpful in situations that need certain degrees of formality, technical language, or industry-specific terms.  
+A system message is a feature-specific set of instructions or contextual frameworks given to a generative AI model (e.g. GPT-4o, GPT-3.5 Turbo, etc.) to direct and improve the quality and safety of a model’s output. This is particularly helpful in situations that need certain degrees of formality, technical language, or industry-specific terms.  
 
 
 There is no prescribed length. A system message can be one short sentence:  

articles/ai-services/openai/concepts/customizing-llms.md

@@ -3,7 +3,7 @@ title: Azure OpenAI Service getting started with customizing a large language mo
 titleSuffix: Azure OpenAI Service
 description: Learn more about the concepts behind customizing an LLM with Azure OpenAI.
 ms.topic: conceptual
-ms.date: 09/20/2024
+ms.date: 03/27/2025
 ms.service: azure-ai-openai
 manager: nitinme
 author: mrbullwinkle

articles/ai-services/openai/concepts/fine-tuning-considerations.md

@@ -4,7 +4,7 @@ description: Learn more about what you should take into consideration before fin
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: conceptual 
-ms.date: 08/29/2024
+ms.date: 03/26/2025
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false

articles/ai-services/openai/concepts/prompt-engineering.md

@@ -4,7 +4,7 @@ titleSuffix: Azure OpenAI
 description: Learn how to use prompt engineering to optimize your work with Azure OpenAI Service.
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 08/29/2024
+ms.date: 03/26/2025
 ms.custom: references_regions, build-2023, build-2023-dataai
 manager: nitinme
 author: mrbullwinkle
@@ -14,7 +14,7 @@ recommendations: false
 
 # Prompt engineering techniques
 
-GPT-3, GPT-3.5, GPT-4, and GPT-4o models from OpenAI are prompt-based. With prompt-based models, the user interacts with the model by entering a text prompt, to which the model responds with a text completion. This completion is the model’s continuation of the input text.
+GPT-3, GPT-3.5, GPT-4, and GPT-4o models from OpenAI are prompt-based. With prompt-based models, the user interacts with the model by entering a text prompt, to which the model responds with a text completion. This completion is the model’s continuation of the input text. These techniques are note recommended for o-series models.
 
 While these models are extremely powerful, their behavior is also very sensitive to the prompt. This makes prompt construction an important skill to develop.
 

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/concepts/provisioned-throughput.md

@@ -3,7 +3,7 @@ title: Azure OpenAI Service provisioned throughput
 description: Learn about provisioned throughput and Azure OpenAI.
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 08/07/2024
+ms.date: 03/26/2025
 manager: nitinme
 author: mrbullwinkle #ChrisHMSFT
 ms.author: mbullwin #chrhoder