Merge pull request #258882 from MicrosoftDocs/main

11/17 11:00 AM IST Publish

Author: Saisang

.openpublishing.redirection.azure-kubernetes-service.json

@@ -10,6 +10,11 @@
             "redirect_url": "/azure/aks/azure-cni-powered-by-cilium",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/aks/app-routing-configuration.md",
+            "redirect_url": "/azure/aks/app-routing-dns-ssl",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/aks/web-app-routing.md",
             "redirect_url": "/azure/aks/app-routing",

articles/ai-services/language-service/summarization/how-to/document-summarization.md

@@ -115,14 +115,14 @@ curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-text/
       "kind": "AbstractiveSummarization",
       "taskName": "Document Abstractive Summarization Task 1",
       "parameters": {
-        "sentenceCount": 1
+        "summaryLength": short
       }
     }
   ]
 }
 '
 ```
-If you don't specify `sentenceCount`, the model determines the summary length. Note that `sentenceCount` is the approximation of the sentence count of the output summary, range 1 to 20.
+If you don't specify `sentenceCount`, the model determines the summary length. Note that `sentenceCount` is the approximation of the sentence count of the output summary, range 1 to 20. Using sentenceCount is not recommended for abstractive summarization.
 
 2. Make the following changes in the command where needed:
     - Replace the value `your-language-resource-key` with your key.
@@ -203,11 +203,11 @@ curl -X GET https://<your-language-resource-endpoint>/language/analyze-text/jobs
 
 The following cURL commands are executed from a BASH shell. Edit these commands with your own resource name, resource key, and JSON values.
 
-## Query based extractive summarization
+## Query based summarization
 
-The query-based extractive summarization API is an extension to the existing document summarization API.
+The query-based document summarization API is an extension to the existing document summarization API.
 
-The biggest difference is a new `query` field in the request body (under `tasks` > `parameters` > `query`). Additionally, there's a new way to specify the preferred `summaryLength` in "buckets" of short/medium/long, which we recommend using instead of `sentenceCount`. Below is an example request:
+The biggest difference is a new `query` field in the request body (under `tasks` > `parameters` > `query`). Additionally, there's a new way to specify the preferred `summaryLength` in "buckets" of short/medium/long, which we recommend using instead of `sentenceCount`, especially when using abstractive. Below is an example request:
 
 ```bash
 curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-text/jobs?api-version=2023-11-15-preview \
@@ -232,50 +232,14 @@ curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-text/
       "taskName": "Document Extractive Summarization Task 1",
       "parameters": {
         "query": "XYZ-code",
-        "sentenceCount": 1
+        "summaryLength": short
       }
     }
   ]
 }
 '
 ```
 
-## Query based abstractive summarization
-
-The query-based abstractive summarization API is an extension to the existing document summarization API.
-
-The biggest difference is a new `query` field in the request body (under `tasks` > `parameters` > `query`). Additionally, there's a new way to specify the preferred `summaryLength` in "buckets" of short/medium/long, which we recommend using instead of `sentenceCount`. Below is an example request:
-
-```bash
-curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-text/jobs?api-version=2023-11-15-preview \
--H "Content-Type: application/json" \
--H "Ocp-Apim-Subscription-Key: <your-language-resource-key>" \
--d \
-' 
-{
-  "displayName": "Document Abstractive Summarization Task Example",
-  "analysisInput": {
-    "documents": [
-      {
-        "id": "1",
-        "language": "en",
-        "text": "At Microsoft, we have been on a quest to advance AI beyond existing techniques, by taking a more holistic, human-centric approach to learning and understanding. As Chief Technology Officer of Azure AI services, I have been working with a team of amazing scientists and engineers to turn this quest into a reality. In my role, I enjoy a unique perspective in viewing the relationship among three attributes of human cognition: monolingual text (X), audio or visual sensory signals, (Y) and multilingual (Z). At the intersection of all three, there’s magic—what we call XYZ-code as illustrated in Figure 1—a joint representation to create more powerful AI that can speak, hear, see, and understand humans better. We believe XYZ-code enables us to fulfill our long-term vision: cross-domain transfer learning, spanning modalities and languages. The goal is to have pretrained models that can jointly learn representations to support a broad range of downstream AI tasks, much in the way humans do today. Over the past five years, we have achieved human performance on benchmarks in conversational speech recognition, machine translation, conversational question answering, machine reading comprehension, and image captioning. These five breakthroughs provided us with strong signals toward our more ambitious aspiration to produce a leap in AI capabilities, achieving multi-sensory and multilingual learning that is closer in line with how humans learn and understand. I believe the joint XYZ-code is a foundational component of this aspiration, if grounded with external knowledge sources in the downstream AI tasks."
-      }
-    ]
-  },
-  "tasks": [
-    {
-      "kind": "AbstractiveSummarization",
-      "taskName": "Document Abstractive Summarization Task 1",
-      "parameters": {
-        "query": "XYZ-code",
-        "summaryLength": "short"
-      }
-    }
-  ]
-}
-'
-```
 ### Using the summaryParameter
 For the `summaryLength` parameter, three values are accepted:
 * short: Generates a summary of mostly 2-3 sentences, with around 120 tokens.

articles/ai-services/language-service/summarization/includes/regional-availability.md

@@ -13,6 +13,8 @@ ms.custom:
 ---
 
 > [!IMPORTANT]
+> One preview region, Sweden Central, showcases our latest and continually evolving LLM fine tuning techniques, where all summarization capabilities are available. We welcome customers to join our early adopter community by filling out the [access request form](https://aka.ms/applyforgatedsummarizationfeatures).
+. Your valuable feedback is vital to our continuous enhancement.
 > Conversation summarization is only available using:
 >  - REST API
 >  - Python

articles/ai-services/language-service/summarization/region-support.md

@@ -18,14 +18,14 @@ Some summarization features are only available in limited regions. More regions
 
 ## Regional availability table
 
-|Region            |Document abstractive summarization|Conversation issue and resolution summarization|Conversation narrative summarization with chapters|Custom summarization|
-|------------------|----------------------------------|-----------------------------------------------|--------------------------------------------------|--------------------|
-|Azure Gov Virginia|✅                           |✅                                        |✅                                           |❌            |
-|North Europe      |✅                           |✅                                        |✅                                           |❌            |
-|East US           |✅                           |✅                                        |✅                                           |✅             |
-|UK South          |✅                           |✅                                        |✅                                           |❌            |
-|Southeast Asia    |✅                           |✅                                        |✅                                           |❌            |
-|Central Sweden    |✅                           |❌                                       |❌                                          |❌            |
+|Region            |Document abstractive summarization|Conversation summarization                     |Custom summarization|
+|------------------|----------------------------------|-----------------------------------------------|--------------------|
+|Azure Gov Virginia|✅                           |✅                                        |❌            |
+|North Europe      |✅                           |✅                                        |❌            |
+|East US           |✅                           |✅                                        |✅             |
+|South UK          |✅                           |✅                                        |❌            |
+|Southeast Asia    |✅                           |✅                                        |❌            |
+|Central Sweden    |✅                           |✅                                        |❌            |
 
 ## Next steps
 

articles/ai-services/speech-service/pronunciation-assessment-tool.md

@@ -35,7 +35,7 @@ At the bottom of the Assessment result, two overall scores are displayed: Pronun
 **Content Score**: This score provides an aggregated assessment of the content of the speech and includes three sub-aspects. This score is only available in the speaking tab for an unscripted assessment.
 
 > [!NOTE]
-> Content score is currently available on the following regions: `westcentralus`, `eastasia`, `eastus`, `northeurope`, `westeurope`, and `westus2`. All other regions will have Content score available starting from Nov 30, 2023.  
+> Content score is currently available on the following regions in Speech Studio: `westcentralus`, `eastasia`, `eastus`, `northeurope`, `westeurope`, and `westus2`. All other regions will have Content score available starting from Nov 30, 2023.  
 
 - **Vocabulary score**: Evaluates the speaker's effective usage of words and their appropriateness within the given context to express ideas accurately, as well as the level of lexical complexity.
 - **Grammar score**: Evaluates the correctness of grammar usage and variety of sentence patterns. It considers lexical accuracy, grammatical accuracy, and diversity of sentence structures, providing a more comprehensive evaluation of language proficiency.

articles/ai-studio/how-to/configure-managed-network.md

@@ -37,7 +37,7 @@ There are three different configuration modes for outbound traffic from the mana
 | ----- | ----- | ----- |
 | Allow internet outbound | Allow all internet outbound traffic from the managed VNet. | You want unrestricted access to machine learning resources on the internet, such as python packages or pretrained models.<sup>1</sup> |
 | Allow only approved outbound | Outbound traffic is allowed by specifying service tags. | * You want to minimize the risk of data exfiltration, but you need to prepare all required machine learning artifacts in your private environment.</br>* You want to configure outbound access to an approved list of services, service tags, or FQDNs. |
-| Disabled | Inbound and outbound traffic isn't restricted or you're using your own Azure Virtual Network to protect resources. | You want public inbound and outbound from the Azure AI, or you're handling network isolation with your own Azure VNet. |
+| Disabled | Inbound and outbound traffic isn't restricted. | You want public inbound and outbound from the Azure AI. |
 
 <sup>1</sup> You can use outbound rules with _allow only approved outbound_ mode to achieve the same result as using allow internet outbound. The differences are:
 

articles/aks/TOC.yml

@@ -523,8 +523,8 @@
               items:
                 - name: Application routing add-on overview
                   href: app-routing.md
-                - name: Application routing add-on advanced configurations
-                  href: app-routing-configuration.md
+                - name: Custom hostname and secure ingress configuration
+                  href: app-routing-dns-ssl.md
                 - name: Monitor using Prometheus and Grafana
                   href: app-routing-nginx-prometheus.md
                 - name: Migrate from HTTP application routing to the application routing add-on