Minor format adjustments

Author: gerbermarco

articles/ai-services/openai/includes/get-key-endpoint.md

@@ -20,6 +20,6 @@ To successfully make a call against Azure OpenAI, you need an **endpoint** and a
 | `ENDPOINT`               | This value can be found in the **Keys & Endpoint** section when examining your resource from the Azure portal. Alternatively, you can find the value in the **Azure OpenAI Studio** > **Playground** > **Code View**. An example endpoint is: `https://docs-test-001.openai.azure.com/`.|
 | `API-KEY` | This value can be found in the **Keys & Endpoint** section when examining your resource from the Azure portal. You can use either `KEY1` or `KEY2`.|
 
-Go to your resource in the Azure portal. The **Endpoint and Keys** can be found in the **Resource Management** section. Copy your endpoint and access key as you'll need both for authenticating your API calls. You can use either `KEY1` or `KEY2`. Always having two keys allows you to securely rotate and regenerate keys without causing a service disruption.
+Go to your resource in the Azure portal. The **Keys & Endpoint** section can be found in the **Resource Management** section. Copy your endpoint and access key as you'll need both for authenticating your API calls. You can use either `KEY1` or `KEY2`. Always having two keys allows you to securely rotate and regenerate keys without causing a service disruption.
 
 :::image type="content" source="../media/quickstarts/endpoint.png" alt-text="Screenshot of the overview UI for an Azure OpenAI resource in the Azure portal with the endpoint and access keys location circled in red." lightbox="../media/quickstarts/endpoint.png":::

articles/ai-services/openai/tutorials/fine-tune.md

@@ -29,7 +29,7 @@ In this tutorial you learn how to:
 
 ## Prerequisites
 
-* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services?azure-portal=true).
+- An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services?azure-portal=true).
 - Access granted to Azure OpenAI in the desired Azure subscription Currently, access to this service is granted only by application. You can apply for access to Azure OpenAI by completing the form at https://aka.ms/oai/access.
 - Python 3.8 or later version
 - The following Python libraries: `json`, `requests`, `os`, `tiktoken`, `time`, `openai`, `numpy`.
@@ -159,6 +159,8 @@ Create the files in the same directory that you're running the Jupyter Notebook,
 Now you need to run some preliminary checks on our training and validation files.
 
 ```python
+# Run preliminary checks
+
 import json
 
 # Load the training set
@@ -203,6 +205,8 @@ In this case we only have 10 training and 10 validation examples so while this w
 Now you can then run some additional code from OpenAI using the tiktoken library to validate the token counts. Individual examples need to remain under the `gpt-35-turbo-0613` model's input token limit of 4096 tokens.
 
 ```python
+# Validate token counts
+
 import json
 import tiktoken
 import numpy as np
@@ -295,8 +299,8 @@ from openai import AzureOpenAI
 
 client = AzureOpenAI(
   azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT"),
-  api_key=os.getenv("AZURE_OPENAI_API_KEY"),
-  api_version="2024-02-01"  # This API version or later is required to access fine-tuning for turbo/babbage-002/davinci-002
+  api_key = os.getenv("AZURE_OPENAI_API_KEY"),
+  api_version = "2024-02-01"  # This API version or later is required to access fine-tuning for turbo/babbage-002/davinci-002
 )
 
 training_file_name = 'training_set.jsonl'
@@ -305,12 +309,12 @@ validation_file_name = 'validation_set.jsonl'
 # Upload the training and validation dataset files to Azure OpenAI with the SDK.
 
 training_response = client.files.create(
-    file=open(training_file_name, "rb"), purpose="fine-tune"
+    file = open(training_file_name, "rb"), purpose="fine-tune"
 )
 training_file_id = training_response.id
 
 validation_response = client.files.create(
-    file=open(validation_file_name, "rb"), purpose="fine-tune"
+    file = open(validation_file_name, "rb"), purpose="fine-tune"
 )
 validation_file_id = validation_response.id
 
@@ -322,6 +326,7 @@ print("Validation file ID:", validation_file_id)
 
 ```Python
 # Upload fine-tuning files
+
 import openai
 import os
 
@@ -336,12 +341,12 @@ validation_file_name = 'validation_set.jsonl'
 # Upload the training and validation dataset files to Azure OpenAI with the SDK.
 
 training_response = openai.File.create(
-    file=open(training_file_name, "rb"), purpose="fine-tune", user_provided_filename="training_set.jsonl"
+    file = open(training_file_name, "rb"), purpose="fine-tune", user_provided_filename="training_set.jsonl"
 )
 training_file_id = training_response["id"]
 
 validation_response = openai.File.create(
-    file=open(validation_file_name, "rb"), purpose="fine-tune", user_provided_filename="validation_set.jsonl"
+    file = open(validation_file_name, "rb"), purpose="fine-tune", user_provided_filename="validation_set.jsonl"
 )
 validation_file_id = validation_response["id"]
 
@@ -365,10 +370,12 @@ Now that the fine-tuning files have been successfully uploaded you can submit yo
 # [OpenAI Python 1.x](#tab/python-new)
 
 ```python
+# Submit fine-tuning training job
+
 response = client.fine_tuning.jobs.create(
-    training_file=training_file_id,
-    validation_file=validation_file_id,
-    model="gpt-35-turbo-0613", # Enter base model name. Note that in Azure OpenAI the model name contains dashes and cannot contain dot/period characters.
+    training_file = training_file_id,
+    validation_file = validation_file_id,
+    model = "gpt-35-turbo-0613", # Enter base model name. Note that in Azure OpenAI the model name contains dashes and cannot contain dot/period characters.
 )
 
 job_id = response.id
@@ -385,10 +392,12 @@ print(response.model_dump_json(indent=2))
 # [OpenAI Python 0.28.1](#tab/python)
 
 ```python
+# Submit fine-tuning training job
+
 response = openai.FineTuningJob.create(
-    training_file=training_file_id,
-    validation_file=validation_file_id,
-    model="gpt-35-turbo-0613",
+    training_file = training_file_id,
+    validation_file = validation_file_id,
+    model = "gpt-35-turbo-0613",
 )
 
 job_id = response["id"]
@@ -531,7 +540,7 @@ To get the full results, run the following:
 # [OpenAI Python 1.x](#tab/python-new)
 
 ```python
-#Retrieve fine_tuned_model name
+# Retrieve fine_tuned_model name
 
 response = client.fine_tuning.jobs.retrieve(job_id)
 
@@ -542,7 +551,7 @@ fine_tuned_model = response.fine_tuned_model
 # [OpenAI Python 0.28.1](#tab/python)
 
 ```python
-#Retrieve fine_tuned_model name
+# Retrieve fine_tuned_model name
 
 response = openai.FineTuningJob.retrieve(job_id)
 
@@ -571,14 +580,16 @@ Alternatively, you can deploy your fine-tuned model using any of the other commo
 [!INCLUDE [Fine-tuning deletion](../includes/fine-tune.md)]
 
 ```python
+# Deploy fine-tuned model
+
 import json
 import requests
 
-token= os.getenv("TEMP_AUTH_TOKEN")
+token = os.getenv("TEMP_AUTH_TOKEN")
 subscription = "<YOUR_SUBSCRIPTION_ID>"
 resource_group = "<YOUR_RESOURCE_GROUP_NAME>"
 resource_name = "<YOUR_AZURE_OPENAI_RESOURCE_NAME>"
-model_deployment_name ="YOUR_CUSTOM_MODEL_DEPLOYMENT_NAME"
+model_deployment_name = "YOUR_CUSTOM_MODEL_DEPLOYMENT_NAME"
 
 deploy_params = {'api-version': "2023-05-01"}
 deploy_headers = {'Authorization': 'Bearer {}'.format(token), 'Content-Type': 'application/json'}
@@ -619,18 +630,20 @@ After your fine-tuned model is deployed, you can use it like any other deployed
 # [OpenAI Python 1.x](#tab/python-new)
 
 ```python
+# Use the deployed customized model
+
 import os
 from openai import AzureOpenAI
 
 client = AzureOpenAI(
   azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT"),
-  api_key=os.getenv("AZURE_OPENAI_API_KEY"),
-  api_version="2024-02-01"
+  api_key = os.getenv("AZURE_OPENAI_API_KEY"),
+  api_version = "2024-02-01"
 )
 
 response = client.chat.completions.create(
-    model="gpt-35-turbo-ft", # model = "Custom deployment name you chose for your fine-tuning model"
-    messages=[
+    model = "gpt-35-turbo-ft", # model = "Custom deployment name you chose for your fine-tuning model"
+    messages = [
         {"role": "system", "content": "You are a helpful assistant."},
         {"role": "user", "content": "Does Azure OpenAI support customer managed keys?"},
         {"role": "assistant", "content": "Yes, customer managed keys are supported by Azure OpenAI."},
@@ -644,16 +657,19 @@ print(response.choices[0].message.content)
 # [OpenAI Python 0.28.1](#tab/python)
 
 ```python
+# Use the deployed customized model
+
 import os
 import openai
+
 openai.api_type = "azure"
 openai.api_base = os.getenv("AZURE_OPENAI_ENDPOINT")
 openai.api_version = "2024-02-01"
 openai.api_key = os.getenv("AZURE_OPENAI_API_KEY")
 
 response = openai.ChatCompletion.create(
-    engine="gpt-35-turbo-ft", # engine = "Custom deployment name you chose for your fine-tuning model"
-    messages=[
+    engine = "gpt-35-turbo-ft", # engine = "Custom deployment name you chose for your fine-tuning model"
+    messages = [
         {"role": "system", "content": "You are a helpful assistant."},
         {"role": "user", "content": "Does Azure OpenAI support customer managed keys?"},
         {"role": "assistant", "content": "Yes, customer managed keys are supported by Azure OpenAI."},