Merge pull request #3771 from MicrosoftDocs/main

Merge main to live, 4 AM

Author: v-ccolin

articles/ai-services/openai/includes/python.md

@@ -5,7 +5,7 @@ description: Walkthrough on how to get started with Azure OpenAI and make your f
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: include
-ms.date: 01/03/2024
+ms.date: 03/26/2025
 ---
 
 <a href="https://github.com/openai/openai-python" target="_blank">Library source code</a> | <a href="https://pypi.org/project/openai/" target="_blank">Package (PyPi)</a> |
@@ -22,22 +22,10 @@ ms.date: 01/03/2024
 
 Install the OpenAI Python client library with:
 
-# [OpenAI Python 1.x](#tab/python-new)
-
 ```console
 pip install openai
 ```
 
-# [OpenAI Python 0.28.1](#tab/python)
-
-[!INCLUDE [Deprecation](../includes/deprecation.md)]
-
-```console
-pip install openai==0.28.1
-```
-
----
-
 > [!NOTE]
 > This library is maintained by OpenAI. Refer to the [release history](https://github.com/openai/openai-python/releases) to track the latest updates to the library.
 
@@ -64,16 +52,21 @@ Go to your resource in the Azure portal. The **Keys and Endpoint** can be found
 
 2. Replace the contents of quickstart.py with the following code. Modify the code to add your key, endpoint, and deployment name: 
 
-# [OpenAI Python 1.x](#tab/python-new)
+# [Microsoft Entra ID](#tab/entra)
 
 ```python
 import os
 from openai import AzureOpenAI
+from azure.identity import DefaultAzureCredential, get_bearer_token_provider
+
+token_provider = get_bearer_token_provider(
+    DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
+)
 
 client = AzureOpenAI(
-    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
-    api_version="2024-02-01",
-    azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
+    azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT"), 
+    azure_ad_token_provider=token_provider,
+    api_version="2024-10-21"
     )
 
 deployment_name='REPLACE_WITH_YOUR_DEPLOYMENT_NAME' #This will correspond to the custom name you chose for your deployment when you deployed a model. Use a gpt-35-turbo-instruct deployment. 
@@ -85,25 +78,27 @@ response = client.completions.create(model=deployment_name, prompt=start_phrase,
 print(start_phrase+response.choices[0].text)
 ```
 
-# [OpenAI Python 0.28.1](#tab/python)
+# [API Key](#tab/key)
+
+[!INCLUDE [Azure key vault](~/reusable-content/ce-skilling/azure/includes/ai-services/security/azure-key-vault.md)]
 
 ```python
 import os
-import openai
-
-openai.api_key = os.getenv("AZURE_OPENAI_API_KEY")
-openai.api_base = os.getenv("AZURE_OPENAI_ENDPOINT") # your endpoint should look like the following https://YOUR_RESOURCE_NAME.openai.azure.com/
-openai.api_type = 'azure'
-openai.api_version = '2024-02-01' # this might change in the future
-
-deployment_name='REPLACE_WITH_YOUR_DEPLOYMENT_NAME' #This will correspond to the custom name you chose for your deployment when you deployed a model. 
-
+from openai import AzureOpenAI
+    
+client = AzureOpenAI(
+    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
+    api_version="2024-10-21",
+    azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
+    )
+    
+deployment_name='REPLACE_WITH_YOUR_DEPLOYMENT_NAME' #This will correspond to the custom name you chose for your deployment when you deployed a model. Use a gpt-35-turbo-instruct deployment. 
+    
 # Send a completion call to generate an answer
 print('Sending a test completion job')
 start_phrase = 'Write a tagline for an ice cream shop. '
-response = openai.Completion.create(engine=deployment_name, prompt=start_phrase, max_tokens=10)
-text = response['choices'][0]['text'].replace('\n', '').replace(' .', '.').strip()
-print(start_phrase+text)
+response = client.completions.create(model=deployment_name, prompt=start_phrase, max_tokens=10)
+print(start_phrase+response.choices[0].text)
 ```
 
 ---
@@ -128,7 +123,6 @@ Write a tagline for an ice cream shop. The coldest ice cream in town!
 
 Run the code a few more times to see what other types of responses you get as the response won't always be the same.
 
-
 ### Understanding your results
 
 Since our example of `Write a tagline for an ice cream shop.` provides little context, it's normal for the model to not always return expected results. You can adjust the maximum number of tokens if the response seems unexpected or truncated.

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

@@ -5,7 +5,7 @@ description: Walkthrough on how to get started with Azure OpenAI and make your f
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: include
-ms.date: 02/02/2023
+ms.date: 03/26/2025
 ---
 
 ## Prerequisites
@@ -38,14 +38,27 @@ Go to your resource in the Azure portal. The **Endpoint and Keys** can be found
 
 In a bash shell, run the following command. You will need to replace `gpt-35-turbo-instruct` with the deployment name you chose when you deployed the `gpt-35-turbo-instruct` model. Entering the model name will result in an error unless you chose a deployment name that is identical to the underlying model name.
 
+# [Microsoft Entra ID](#tab/entra)
+
 ```bash
-curl $AZURE_OPENAI_ENDPOINT/openai/deployments/gpt-35-turbo-instruct/completions?api-version=2024-02-01 \
+curl $AZURE_OPENAI_ENDPOINT/openai/deployments/gpt-35-turbo-instruct/completions?api-version=2024-10-21 \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $AZURE_OPENAI_AUTH_TOKEN" \
+  -d "{\"prompt\": \"Once upon a time\"}"
+```
+
+# [API Key](#tab/key)
+
+```bash
+curl $AZURE_OPENAI_ENDPOINT/openai/deployments/gpt-35-turbo-instruct/completions?api-version=2024-10-21 \
   -H "Content-Type: application/json" \
   -H "api-key: $AZURE_OPENAI_API_KEY" \
   -d "{\"prompt\": \"Once upon a time\"}"
 ```
 
-The format of your first line of the command with an example endpoint would appear as follows `curl https://docs-test-001.openai.azure.com/openai/deployments/{YOUR-DEPLOYMENT_NAME_HERE}/completions?api-version=2024-02-01 \`. If you encounter an error double check to make sure that you don't have a doubling of the `/` at the separation between your endpoint and `/openai/deployments`.
+---
+
+The format of your first line of the command with an example endpoint would appear as follows `curl https://docs-test-001.openai.azure.com/openai/deployments/{YOUR-DEPLOYMENT_NAME_HERE}/completions?api-version=2024-10-21 \`. If you encounter an error double check to make sure that you don't have a doubling of the `/` at the separation between your endpoint and `/openai/deployments`.
 
 If you want to run this command in a normal Windows command prompt you would need to alter the text to remove the `\` and line breaks.
 

articles/ai-services/openai/includes/studio.md

@@ -5,7 +5,7 @@ description: Walkthrough on how to get started with Azure OpenAI and make your f
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: include
-ms.date: 09/19/2023
+ms.date: 03/26/2025
 ---
 
 ## Prerequisites

articles/ai-services/openai/quickstart.md

@@ -8,7 +8,7 @@ ms.custom: devx-track-dotnet, devx-track-python, devx-track-extended-java, devx-
 ms.topic: quickstart
 author: mrbullwinkle
 ms.author: mbullwin
-ms.date: 09/05/2024
+ms.date: 03/26/2025
 zone_pivot_groups: openai-quickstart-new
 recommendations: false
 ---

articles/machine-learning/concept-data-privacy.md

@@ -7,7 +7,7 @@ ms.service: azure-ai-foundry
 ms.custom:
   - ignite-2023
 ms.topic: how-to
-ms.date: 5/22/2024
+ms.date: 03/27/2025
 ms.reviewer: jcioffi
 ms.author: ssalgado
 author: ssalgadodev

articles/machine-learning/how-to-setup-vs-code.md

@@ -8,7 +8,7 @@ author: ssalgadodev
 ms.author: ssalgado
 ms.service: azure-machine-learning
 ms.subservice: core
-ms.date: 01/16/2024
+ms.date: 03/25/2025
 ms.topic: how-to
 ms.custom: devplatv2, build-2023
 monikerRange: 'azureml-api-1 || azureml-api-2'