Merge branch 'main' into synapse-freshness-july-2024

Author: whhender

.openpublishing.redirection.app-service.json

@@ -1850,6 +1850,16 @@
             "redirect_url": "/azure/app-service/scripts/powershell-scale-manual",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/app-service/get-resource-events.md",
+            "redirect_url": "/azure/app-service/monitor-app-service",
+            "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/app-service/overview-monitoring.md",
+            "redirect_url": "/azure/app-service/monitor-app-service",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/app-service/app-service-security-attributes.md",
             "redirect_url": "/azure/app-service/security-baseline",

.openpublishing.redirection.defender-for-cloud.json

@@ -980,6 +980,11 @@
             "redirect_url": "/azure/defender-for-cloud/view-and-remediate-vulnerability-registry-images",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/defender-for-cloud/management-groups-roles.md",
+            "redirect_url": "/azure/governance/management-groups/overview",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/defender-for-cloud/how-to-migrate-to-built-in.md",
             "redirect_url": "/azure/defender-for-cloud/how-to-transition-to-built-in",

.openpublishing.redirection.json

@@ -4498,6 +4498,11 @@
             "redirect_url": "/azure/orbital/overview",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/update-manager/pre-post-events-common-scenarios.md",
+            "redirect_url": "/azure/update-manager/manage-pre-post-events",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/update-manager/whats-upcoming.md",
             "redirect_url": "/azure/update-manager/whats-new",

articles/ai-services/document-intelligence/concept-custom.md

@@ -54,7 +54,7 @@ To create a custom extraction model, label a dataset of documents with the value
 > Starting with version 4.0 (2024-02-29-preview) API, custom neural models now support **overlapping fields** and **table, row and cell level confidence**.
 >
 
-The custom neural (custom document) model uses deep learning models and  base model trained on a large collection of documents. This model is then fine-tuned or adapted to your data when you train the model with a labeled dataset. Custom neural models support structured, semi-structured, and unstructured documents to extract fields. Custom neural models currently support English-language documents. When you're choosing between the two model types, start with a neural model to determine if it meets your functional needs. See [neural models](concept-custom-neural.md) to learn more about custom document models.
+The custom neural (custom document) model uses deep learning models and  base model trained on a large collection of documents. This model is then fine-tuned or adapted to your data when you train the model with a labeled dataset. Custom neural models support structured, semi-structured, and unstructured documents to extract fields. When you're choosing between the two model types, start with a neural model to determine if it meets your functional needs. See [neural models](concept-custom-neural.md) to learn more about custom document models.
 
 ### Custom template model
 
@@ -131,7 +131,7 @@ The `build custom model` operation adds support for the *template* and *neural*
 
 * Template models only accept documents that have the same basic page structure—a uniform visual appearance—or the same relative positioning of elements within the document.
 
-* Neural models support documents that have the same information, but different page structures. Examples of these documents include United States W2 forms, which share the same information, but vary in appearance across companies. Neural models currently only support English text.
+* Neural models support documents that have the same information, but different page structures. Examples of these documents include United States W2 forms, which share the same information, but vary in appearance across companies.
 
 This table provides links to the build mode programming language SDK references and code samples on GitHub:
 

articles/ai-services/language-support.md

@@ -7,7 +7,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-services
 ms.topic: conceptual
-ms.date: 07/18/2023
+ms.date: 07/08/2024
 ms.author: lajanuar
 ---
 
@@ -25,7 +25,7 @@ The following table provides links to language support reference articles by sup
 |![Document Intelligence icon](~/reusable-content/ce-skilling/azure/media/ai-services/document-intelligence.svg)</br>[Document Intelligence](./document-intelligence/language-support.md) | Turn documents into intelligent data-driven solutions. |
 |![Immersive Reader icon](media/service-icons/immersive-reader.svg)</br>[Immersive Reader](./immersive-reader/language-support.md) | Help users read and comprehend text. |
 |![Language icon](~/reusable-content/ce-skilling/azure/media/ai-services/language.svg)</br>[Language service](./language-service/concepts/language-support.md) | Build apps with industry-leading natural language understanding capabilities. |
-|![Language Understanding icon](media/service-icons/luis.svg)</br>[Language Understanding (LUIS)](./luis/luis-language-support.md) (retired) | Understand natural language in your apps. |
+|![Language Understanding icon](media/service-icons/luis.svg)</br>[Language Understanding (`LUIS`)](./luis/luis-language-support.md) (retired) | Understand natural language in your apps. |
 |![QnA Maker icon](media/service-icons/luis.svg)</br>[QnA Maker](./qnamaker/overview/language-support.md) (retired) | Distill information into easy-to-navigate questions and answers. |
 |![Speech icon](~/reusable-content/ce-skilling/azure/media/ai-services/speech.svg)</br>[Speech Service](./speech-service/language-support.md)| Configure speech-to-text, text-to-speech, translation, and speaker recognition applications. |
 |![Translator icon](~/reusable-content/ce-skilling/azure/media/ai-services/translator.svg)</br>[Translator](./translator/language-support.md) |  Translate more than 100 in-use, at-risk, and endangered languages and dialects.|
@@ -46,4 +46,4 @@ These Azure AI services are language agnostic and don't have limitations based o
 ## See also
 
 * [What are Azure AI services?](./what-are-ai-services.md)
-* [Create an account](multi-service-resource.md?pivots=azportal)
+* [How to create an account](multi-service-resource.md?pivots=azportal)

articles/ai-services/openai/concepts/model-retirements.md

@@ -4,7 +4,7 @@ titleSuffix: Azure OpenAI
 description: Learn about the model deprecations and retirements in Azure OpenAI.
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 06/19/2024
+ms.date: 07/10/2024
 ms.custom: 
 manager: nitinme
 author: mrbullwinkle
@@ -25,16 +25,43 @@ Azure OpenAI Service models are continually refreshed with newer and more capabl
 * Deprecation
 	* When a model is deprecated, it's no longer available for new customers. It continues to be available for use by customers with existing deployments until the model is retired.
 
-## Preretirement notification
+## Notifications
 
 Azure OpenAI notifies customers of active Azure OpenAI Service deployments for models with upcoming retirements. We notify customers of upcoming retirements as follows for each deployment:
 
-* At least 60 days before retirement 
-* At least 30 days before retirement 
-* At retirement
+1. At model launch, we programmatically designate a "not sooner than" retirement date (typically six months to one year out).
+2. At least 60 days notice before model retirement for Generally Available (GA) models.
+3. At least 14 days notice before preview model version upgrades.  
 
 Retirements are done on a rolling basis, region by region.
 
+## Model availability
+
+1. At least one year of model availability for GA models after the release date of a model in at least one region worldwide
+2. For global deployments, all future model versions starting with `gpt-4o` and `gpt-4 0409` will be available with their (`N`) next succeeding model (`N+1`) for comparison together. 
+1. Customers have 60 days to try out a new GA model in at least one global, or standard region, before any upgrades happen to a newer GA model.  
+
+### Considerations for the Azure public cloud
+
+Be aware of the following: 
+
+1. All model version combinations will **not** be available in all regions.
+2. Model version `N` and `N+1` might not always be available in the same region. 
+3. GA model version `N` might upgrade to a future model version `N+X` in some regions based on capacity limitations, and without the new model version `N+X` separately being available to test in the same region. The new model version will be available to test in other regions before any upgrades are scheduled.   
+4. Preview model versions and GA versions of the same model won't always be available to test together in the same region. There will be preview and GA versions available to test in different regions. 
+5.	We reserve the right to limit future customers using a particular region to balance service quality for existing customers.
+6.	As always at Microsoft, security is of the utmost importance. If a model or model version is found to have compliance or security issues, we reserve the right to invoke the need to do emergency retirements. See the terms of service for more information.
+
+### Special considerations for Azure Government clouds
+
+1.	Global standard deployments won't be available in government clouds.
+2.	Not all models or model versions available in commercial / public cloud will be available in government clouds.
+3.	In the Azure Government clouds, we intend to support only one version of a given model at a time.
+    1. For example only one version of `gpt-35-turbo 0125` and `gpt-4o (2024-05-13)`.
+4.	There will however be a 30 day overlap between new model versions, where more than two will be available.
+    1. For example if `gpt-35-turbo 0125` or `gpt-4o (2024-05-13)` is updated to a future version, or
+    2. for model family changes beyond version updates, such as when moving from `gpt-4 1106-preview` to `gpt-4o (2024-05-13)`. 
+
 ### Who is notified of upcoming retirements
 
 Azure OpenAI notifies those who are members of the following roles for each subscription with a deployment of a model with an upcoming retirement.

articles/ai-services/openai/includes/chatgpt-dotnet.md

@@ -50,26 +50,22 @@ using static System.Environment;
 string endpoint = GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT");
 string key = GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
 
-OpenAIClient client = new(new Uri(endpoint), new AzureKeyCredential(key));
-
-var chatCompletionsOptions = new ChatCompletionsOptions()
-{
-    DeploymentName = "gpt-35-turbo", //This must match the custom deployment name you chose for your model
-    Messages =
-    {
-        new ChatRequestSystemMessage("You are a helpful assistant."),
-        new ChatRequestUserMessage("Does Azure OpenAI support customer managed keys?"),
-        new ChatRequestAssistantMessage("Yes, customer managed keys are supported by Azure OpenAI."),
-        new ChatRequestUserMessage("Do other Azure AI services support this too?"),
-    },
-    MaxTokens = 100
-};
-
-Response<ChatCompletions> response = client.GetChatCompletions(chatCompletionsOptions);
-
-Console.WriteLine(response.Value.Choices[0].Message.Content);
-
-Console.WriteLine();
+AzureOpenAIClient azureClient = new(
+    new Uri(endpoint),
+    new AzureKeyCredential(key));
+
+// This must match the custom deployment name you chose for your model
+ChatClient chatClient = azureClient.GetChatClient("gpt-35-turbo");
+
+ChatCompletion completion = chatClient.CompleteChat(
+    [
+        new SystemChatMessage("You are a helpful assistant that talks like a pirate."),
+        new UserChatMessage("Does Azure OpenAI support customer managed keys?"),
+        new AssistantChatMessage("Yes, customer managed keys are supported by Azure OpenAI"),
+        new UserChatMessage("Do other Azure AI services support this too?")
+    ]);
+
+Console.WriteLine($"{completion.Role}: {completion.Content[0].Text}");
 ```
 
 > [!IMPORTANT]
@@ -82,7 +78,7 @@ dotnet run program.cs
 ## Output
 
 ```output
-Yes, many of the Azure AI services support customer managed keys. Some examples include Text Analytics, Speech Services, and Translator. However, it's important to note that not all services support customer managed keys, so it's best to check the documentation for each individual service to see if it is supported.
+Assistant : Yes, many other Azure AI services also support customer managed keys, including Azure Cognitive Services, Azure Machine Learning, and Azure Databricks. By using customer managed keys, you can retain complete control over your encryption keys and provide an additional layer of security for your AI assets.
 ```
 
 This will wait until the model has generated its entire response before printing the results. Alternatively, if you want to asynchronously stream the response and print the results, you can replace the contents of *program.cs* with the code in the next example.
@@ -92,35 +88,37 @@ This will wait until the model has generated its entire response before printing
 ```csharp
 using Azure;
 using Azure.AI.OpenAI;
+using OpenAI.Chat;
 using static System.Environment;
 
 string endpoint = GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT");
 string key = GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
 
-OpenAIClient client = new(new Uri(endpoint), new AzureKeyCredential(key));
+AzureOpenAIClient azureClient = new(
+    new Uri(endpoint),
+    new AzureKeyCredential(key));
 
-var chatCompletionsOptions = new ChatCompletionsOptions()
-{
-    DeploymentName= "gpt-35-turbo", //This must match the custom deployment name you chose for your model
-    Messages =
-    {
-        new ChatRequestSystemMessage("You are a helpful assistant."),
-        new ChatRequestUserMessage("Does Azure OpenAI support customer managed keys?"),
-        new ChatRequestAssistantMessage("Yes, customer managed keys are supported by Azure OpenAI."),
-        new ChatRequestUserMessage("Do other Azure AI services support this too?"),
-    },
-    MaxTokens = 100
-};
-
-await foreach (StreamingChatCompletionsUpdate chatUpdate in client.GetChatCompletionsStreaming(chatCompletionsOptions))
+// This must match the custom deployment name you chose for your model
+ChatClient chatClient = azureClient.GetChatClient("gpt-35-turbo");
+
+var chatUpdates = chatClient.CompleteChatStreamingAsync(
+    [
+        new SystemChatMessage("You are a helpful assistant that talks like a pirate."),
+        new UserChatMessage("Does Azure OpenAI support customer managed keys?"),
+        new AssistantChatMessage("Yes, customer managed keys are supported by Azure OpenAI"),
+        new UserChatMessage("Do other Azure AI services support this too?")
+    ]);
+
+await foreach(var chatUpdate in chatUpdates)
 {
     if (chatUpdate.Role.HasValue)
     {
-        Console.Write($"{chatUpdate.Role.Value.ToString().ToUpperInvariant()}: ");
+        Console.Write($"{chatUpdate.Role} : ");
     }
-    if (!string.IsNullOrEmpty(chatUpdate.ContentUpdate))
+    
+    foreach(var contentPart in chatUpdate.ContentUpdate)
     {
-        Console.Write(chatUpdate.ContentUpdate);
+        Console.Write(contentPart.Text);
     }
 }
 ```

articles/ai-services/openai/includes/dall-e-dotnet.md

@@ -70,38 +70,30 @@ dotnet add package Azure.AI.OpenAI --version 1.0.0-beta.6
 From the project directory, open the *program.cs* file and replace the contents with the following code:
 
 ```csharp
-using System;
-using System.IO;
-using System.Threading.Tasks;
+using Azure;
 using Azure.AI.OpenAI;
+using OpenAI.Images;
+using static System.Environment;
 
-namespace Azure.AI.OpenAI.Tests.Samples
-{
-    public partial class GenerateImages
-    {
-        // add an async Main method:
-        public static async Task Main(string[] args)
+string endpoint = GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT");
+string key = GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
+
+AzureOpenAIClient azureClient = new(
+    new Uri(endpoint),
+    new AzureKeyCredential(key));
+
+// This must match the custom deployment name you chose for your model
+ImageClient chatClient = azureClient.GetImageClient("dalle-3");
+
+var imageGeneration = await chatClient.GenerateImageAsync(
+        "a happy monkey sitting in a tree, in watercolor",
+        new ImageGenerationOptions()
         {
-            string endpoint = GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT");
-            string key = GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-
-            OpenAIClient client = new(new Uri(endpoint), new AzureKeyCredential(key));
-
-            Response<ImageGenerations> imageGenerations = await client.GetImageGenerationsAsync(
-                new ImageGenerationOptions()
-                {
-                    Prompt = "a happy monkey eating a banana, in watercolor",
-                    Size = ImageSize.Size256x256,
-                });
-
-            // Image Generations responses provide URLs you can use to retrieve requested images
-            Uri imageUri = imageGenerations.Value.Data[0].Url;
-            
-            // Print the image URI to console:
-            Console.WriteLine(imageUri);
+            Size = GeneratedImageSize.W1024xH1024
         }
-    }
-}
+    );
+
+Console.WriteLine(imageGeneration.Value.ImageUri);
 ```
 
 Build and run the application from your application directory with these commands:
@@ -116,7 +108,7 @@ dotnet run
 The URL of the generated image is printed to the console.
 
 ```console
-https://dalleproduse.blob.core.windows.net/private/images/552c5522-af4a-4877-a19c-400fac04a422/generated_00.png?se=2023-08-17T16%3A54%3A40Z&sig=XGCIx9r0WvWTJ0LL%2FJGymo2WYp4FDbSQNNrGRUnnUzI%3D&ske=2023-08-19T01%3A10%3A14Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2023-08-12T01%3A10%3A14Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02
+https://dalleproduse.blob.core.windows.net/private/images/b7ac5e55-f1f8-497a-8d0e-8f51446bf538/generated_00.png?se=2024-07-12T13%3A47%3A56Z&sig=Zri37iYVTVtc52qzTFBOqPgSHvXwEhcO86Smv2ojB%2FE%3D&ske=2024-07-17T12%3A15%3A44Z&skoid=09ba021e-c417-441c-b203-c81e5dcd7b7f&sks=b&skt=2024-07-10T12%3A15%3A44Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02
 ```
 
 > [!NOTE]