Merge pull request #40 from mrbullwinkle/mrb_08_28_2024_s_outputs_003

[Azure OpenAI] [Release Branch] JSON Mode

Author: prmerger-automator[bot]

articles/ai-services/openai/how-to/json-mode.md

@@ -6,7 +6,7 @@ services: cognitive-services
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: how-to
-ms.date: 12/05/2023
+ms.date: 08/29/2024
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
@@ -17,6 +17,9 @@ recommendations: false
 
 JSON mode allows you to set the models response format to return a valid JSON object as part of a chat completion. While generating valid JSON was possible previously, there could be issues with response consistency that would lead to invalid JSON objects being generated.
 
+> [!NOTE]
+> While JSON mode is still supported, when possible we recommend using [structured outputs](./structured-outputs.md). Like JSON mode structured outputs generates valid JSON, but with the added benefit that you can constrain the model to use a specific JSON schema.
+
 ## JSON mode support
 
 JSON mode is only currently supported with the following models:
@@ -27,6 +30,8 @@ JSON mode is only currently supported with the following models:
 * `gpt-35-turbo` (0125)
 * `gpt-4` (1106-Preview)
 * `gpt-4` (0125-Preview)
+* `gpt-4o`
+* `gpt-4o-mini`
 
 ### API support
 
@@ -47,7 +52,7 @@ client = AzureOpenAI(
 )
 
 response = client.chat.completions.create(
-  model="gpt-4-0125-Preview", # Model = should match the deployment name you chose for your 0125-Preview model deployment
+  model="YOUR-MODEL_DEPLOYMENT_NAME", # Model = should match the deployment name you chose for your model deployment
   response_format={ "type": "json_object" },
   messages=[
     {"role": "system", "content": "You are a helpful assistant designed to output JSON."},