Merge pull request #271729 from MicrosoftDocs/main

Publish to live, Tuesday 4 AM PST, 4/10

Author: ttorble

articles/ai-services/language-service/named-entity-recognition/concepts/entity-resolutions.md

@@ -16,11 +16,15 @@ ms.custom: language-service-ner
 
 A resolution is a standard format for an entity. Entities can be expressed in various forms and resolutions provide standard predictable formats for common quantifiable types. For example, "eighty" and "80" should both resolve to the integer `80`.
 
-You can use NER resolutions to implement actions or retrieve further information. For example, your service can extract datetime entities to extract dates and times that will be provided to a meeting scheduling system. 
+You can use NER resolutions to implement actions or retrieve further information. For example, your service can extract datetime entities to extract dates and times that will be provided to a meeting scheduling system.
+
+> [!IMPORTANT]
+> Starting from version 2023-04-15-preview, the entity resolution feature is replaced by [entity metadata](entity-metadata.md)
 
 > [!NOTE]
 > Entity resolution responses are only supported starting from **_api-version=2022-10-01-preview_** and **_"modelVersion": "2022-10-01-preview"_**.
 
+
 This article documents the resolution objects returned for each entity category or subcategory.
 
 ## Age

articles/ai-services/language-service/named-entity-recognition/concepts/ga-preview-mapping.md

@@ -14,7 +14,7 @@ ms.custom: language-service-ner
 
 # Preview API changes
 
-Use this article to get an overview of the new API changes starting from `2023-04-15-preview` version. This API change mainly introduces two new concepts (`entity types` and `entity tags`) replacing the `category` and `subcategory` fields in the current Generally Available API.
+Use this article to get an overview of the new API changes starting from `2023-04-15-preview` version. This API change mainly introduces two new concepts (`entity types` and `entity tags`) replacing the `category` and `subcategory` fields in the current Generally Available API. A detailed overview of each API parameter and the supported API versions it corresponds to can be found on the [Skill Parameters][../how-to/skill-parameters.md] page
 
 ## Entity types
 Entity types represent the lowest (or finest) granularity at which the entity has been detected and can be considered to be the base class that has been detected.
@@ -23,8 +23,16 @@ Entity types represent the lowest (or finest) granularity at which the entity ha
 Entity tags are used to further identify an entity where a detected entity is tagged by the entity type and additional tags to differentiate the identified entity. The entity tags list could be considered to include categories, subcategories, sub-subcategories, and so on.
 
 ## Changes from generally available API to preview API
-The changes introduce better flexibility for named entity recognition, including:
-* More granular entity recognition through introducing the tags list where an entity could be tagged by more than one entity tag.
+The changes introduce better flexibility for the named entity recognition service, including:
+
+Updates to the structure of input formats:
+•	InclusionList
+•	ExclusionList
+•	Overlap policy
+
+Updates to the handling of output formats:
+
+* More granular entity recognition outputs through introducing the tags list where an entity could be tagged by more than one entity tag.
 * Overlapping entities where entities could be recognized as more than one entity type and if so, this entity would be returned twice. If an entity was recognized to belong to two entity tags under the same entity type, both entity tags are returned in the tags list.
 * Filtering entities using entity tags, you can learn more about this by navigating to [this article](../how-to-call.md#select-which-entities-to-be-returned-preview-api-only).
 * Metadata Objects which contain additional information about the entity but currently only act as a wrapper for the existing entity resolution feature. You can learn more about this new feature [here](entity-metadata.md).
@@ -54,23 +62,24 @@ You can see a comparison between the structure of the entity categories/types in
 | Age            | Numeric, Age                           |
 | Currency       | Numeric, Currency                      |
 | Number         | Numeric, Number                        |
+| PhoneNumber    | PhoneNumber                            |
 | NumberRange    | Numeric, NumberRange                   |
 | Percentage     | Numeric, Percentage                    |
 | Ordinal        | Numeric, Ordinal                       |
-| Temperature    | Numeric, Dimension, Temperature         |
-| Speed          | Numeric, Dimension, Speed               |
-| Weight         | Numeric, Dimension, Weight              |
-| Height         | Numeric, Dimension, Height              |
-| Length         | Numeric, Dimension, Length              |
-| Volume         | Numeric, Dimension, Volume              |
-| Area           | Numeric, Dimension, Area                |
-| Information    | Numeric, Dimension, Information         |
+| Temperature    | Numeric, Dimension, Temperature        |
+| Speed          | Numeric, Dimension, Speed              |
+| Weight         | Numeric, Dimension, Weight             |
+| Height         | Numeric, Dimension, Height             |
+| Length         | Numeric, Dimension, Length             |
+| Volume         | Numeric, Dimension, Volume             |
+| Area           | Numeric, Dimension, Area               |
+| Information    | Numeric, Dimension, Information        |
 | Address        | Address                                |
 | Person         | Person                                 |
 | PersonType     | PersonType                             |
 | Organization   | Organization                           |
 | Product        | Product                                |
-| ComputingProduct | Product, ComputingProduct             |
+| ComputingProduct | Product, ComputingProduct            |
 | IP             | IP                                     |
 | Email          | Email                                  |
 | URL            | URL                                    |

articles/ai-services/language-service/named-entity-recognition/how-to/skill-parameters.md

@@ -0,0 +1,49 @@
+---
+title: Named entity recognition skill parameters
+titleSuffix: Azure AI services
+description: Learn about skill parameters for named entity recognition.
+#services: cognitive-services
+author: jboback
+manager: nitinme
+ms.service: azure-ai-language
+ms.custom:
+ms.topic: how-to
+ms.date: 03/21/2024
+ms.author: jboback
+---
+
+# Learn about named entity recognition skill parameters
+
+Use this article to get an overview of the different API parameters used to adjust the input to a NER API call.
+
+## InclusionList parameter
+
+The “inclusionList” parameter allows for you to specify which of the NER entity tags, listed here [link to Preview API table], you would like included in the entity list output in your inference JSON listing out all words and categorizations recognized by the NER service. By default, all recognized entities will be listed.
+
+## ExclusionList parameter
+
+The “exclusionList” parameter allows for you to specify which of the NER entity tags, listed here [link to Preview API table], you would like excluded in the entity list output in your inference JSON listing out all words and categorizations recognized by the NER service. By default, all recognized entities will be listed.
+
+## Example
+
+To do: work with Bidisha & Mikael to update with a good example
+
+## overlapPolicy parameter
+
+The “overlapPolicy” parameter allows for you to specify how you like the NER service to respond to recognized words/phrases that fall into more than one category. 
+
+By default, the overlapPolicy parameter will be set to “matchLongest”. This option will categorize the extracted word/phrase under the entity category that can encompass the longest span of the extracted word/phrase (longest defined by the most number of characters included).
+
+The alternative option for this parameter is “allowOverlap”, where all possible entity categories will be listed. 
+Parameters by supported API version
+
+|Parameter                                                   |API versions which support            |
+|------------------------------------------------------------|--------------------------------------|
+|inclusionList                                               |2023-04-15-preview, 2023-11-15-preview|
+|exclusionList                                               |2023-04-15-preview, 2023-11-15-preview|
+|Overlap policy                                              |2023-04-15-preview, 2023-11-15-preview|
+|[Entity resolution](link to archived Entity Resolution page)|2022-10-01-preview                    |
+
+## Next steps
+
+* See [Configure containers](../../concepts/configure-containers.md) for configuration settings.

articles/ai-services/language-service/named-entity-recognition/overview.md

@@ -14,14 +14,16 @@ ms.custom: language-service-ner
 
 # What is Named Entity Recognition (NER) in Azure AI Language?
 
-Named Entity Recognition (NER) is one of the features offered by [Azure AI Language](../overview.md), a collection of machine learning and AI algorithms in the cloud for developing intelligent applications that involve written language. The NER feature can identify and categorize entities in unstructured text. For example: people, places, organizations, and quantities.
+Named Entity Recognition (NER) is one of the features offered by [Azure AI Language](../overview.md), a collection of machine learning and AI algorithms in the cloud for developing intelligent applications that involve written language. The NER feature can identify and categorize entities in unstructured text. For example: people, places, organizations, and quantities. The prebuilt NER feature has a pre-set list of [recognized entities](concepts/named-entity-categories.md). The custom NER feature allows you to train the model to recognize specialized entities specific to your use case.
 
 * [**Quickstarts**](quickstart.md) are getting-started instructions to guide you through making requests to the service.
 * [**How-to guides**](how-to-call.md) contain instructions for using the service in more specific or customized ways.
 * The [**conceptual articles**](concepts/named-entity-categories.md) provide in-depth explanations of the service's functionality and features.
 
-[!INCLUDE [Typical workflow for pre-configured language features](../includes/overview-typical-workflow.md)]
+> [!NOTE]
+> [Entity Resolution](concepts/entity-resolutions.md) was upgraded to the [Entity Metadata](concepts/entity-metadata.md) starting in API version 2023-04-15-preview. If you are calling the preview version of the API equal or newer than 2023-04-15-preview, please check out the [Entity Metadata](concepts/entity-metadata.md) article to use the resolution feature.
 
+[!INCLUDE [Typical workflow for pre-configured language features](../includes/overview-typical-workflow.md)]
 
 ## Get started with named entity recognition
 

articles/ai-services/language-service/toc.yml

@@ -249,23 +249,25 @@ items:
       href: named-entity-recognition/quickstart.md
     - name: NER language support
       href: named-entity-recognition/language-support.md
+    - name: Responsible use of AI
+      items:
+      - name: Transparency note for NER
+        href: /legal/cognitive-services/language-service/transparency-note-named-entity-recognition?context=/azure/ai-services/language-service/context/context
+        displayName: Transparency note for NER, Named Entity Recognition transparency, Responsible AI, Responsible use of AI
+      - name: Integration and responsible use
+        href: /legal/cognitive-services/language-service/guidance-integration-responsible-use?context=/azure/ai-services/language-service/context/context
+        displayName: Responsible deployment, Responsible use, Responsible integration, AI deployment, AI use
+      - name: Data, privacy, and security
+        href: /legal/cognitive-services/language-service/data-privacy?context=/azure/ai-services/language-service/context/context
+        displayName: Data privacy, logging, data retention
     - name: Prebuilt
       items:
-      - name: Responsible use of AI
-        items:
-        - name: Transparency note for NER
-          href: /legal/cognitive-services/language-service/transparency-note-named-entity-recognition?context=/azure/ai-services/language-service/context/context
-          displayName: Transparency note for NER, Named Entity Recognition transparency, Responsible AI, Responsible use of AI
-        - name: Integration and responsible use
-          href: /legal/cognitive-services/language-service/guidance-integration-responsible-use?context=/azure/ai-services/language-service/context/context
-          displayName: Responsible deployment, Responsible use, Responsible integration, AI deployment, AI use
-        - name: Data, privacy, and security
-          href: /legal/cognitive-services/language-service/data-privacy?context=/azure/ai-services/language-service/context/context
-          displayName: Data privacy, logging, data retention
       - name: How-to guides
         items:
         - name: Call NER
           href: named-entity-recognition/how-to-call.md
+        - name: Use skill parameters
+          href: named-entity-recognition/how-to/skill-parameters.md
         - name: Use containers
           items:
           - name: Use Docker containers
@@ -282,8 +284,6 @@ items:
         items:
         - name: Recognized entity categories
           href: named-entity-recognition/concepts/named-entity-categories.md
-        - name: Entity resolution
-          href: named-entity-recognition/concepts/entity-resolutions.md
         - name: Entity Metadata
           href: named-entity-recognition/concepts/entity-metadata.md
         - name: Preview API overview
@@ -302,20 +302,6 @@ items:
         href: custom-named-entity-recognition/language-support.md
       - name: Custom NER FAQ
         href: custom-named-entity-recognition/faq.md
-      - name: Responsible use of AI
-        items:
-        - name: Transparency note for custom NER
-          href: /legal/cognitive-services/language-service/cner-transparency-note?context=/azure/ai-services/language-service/context/context
-          displayName: Transparency note for Custom NER, Custom NER Transparency, Responsible AI, Responsible use of AI
-        - name: Integration and responsible use
-          href: /legal/cognitive-services/language-service/cner-guidance-integration-responsible-use?context=/azure/ai-services/language-service/context/context
-          displayName: Responsible deployment, Responsible use, Responsible integration, AI deployment, AI use
-        - name: Characteristics and limitations
-          href: /legal/cognitive-services/language-service/cner-characteristics-and-limitations?context=/azure/ai-services/language-service/context/context
-          displayName: Custom NER characteristics, Custom NER limitations
-        - name: Data, privacy, and security
-          href: /legal/cognitive-services/language-service/cner-data-privacy-security?context=/azure/ai-services/language-service/context/context
-          displayName: Data privacy, logging, data retention
       - name: How-to guides
         items:
         - name: Create projects

articles/azure-monitor/agents/azure-monitor-agent-windows-client.md

@@ -109,7 +109,7 @@ Since MO is a tenant level resource, the scope of the permission would be higher
 
 ### Using REST APIs
 
-#### 1. Assign the Monitored Object Contributor role to the operator
+#### 1. Assign the Monitored Objects Contributor role to the operator
 
 This step grants the ability to create and link a monitored object to a user or group.
 

articles/defender-for-iot/index.yml

@@ -8,9 +8,9 @@ metadata:
   description: Learn how Microsoft Defender for IoT, an Azure-based, cloud security service provides comprehensive IoT device threat protection.
   ms.service: defender-for-iot
   ms.topic: landing-page
-  author: batamig
+  author: limwainstein
   manager: raynew
-  ms.date: 07/10/2022
+  ms.date: 04/10/2024
 
 highlightedContent:
 # itemType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | whats-new

articles/defender-for-iot/organizations/overview.md

@@ -2,7 +2,7 @@
 title: Overview - Microsoft Defender for IoT for organizations
 description: Learn about Microsoft Defender for IoT's features for end-user organizations and comprehensive IoT security for OT and Enterprise IoT networks.
 ms.topic: overview
-ms.date: 12/25/2022
+ms.date: 04/10/2024
 ms.custom: enterprise-iot
 ---
 
@@ -74,12 +74,6 @@ Enterprise IoT devices can include devices such as printers, smart TVs, and conf
 
 For more information, see [Securing IoT devices in the enterprise](concept-enterprise.md).
 
-## Defender for IoT for device builders
-
-Defender for IoT also provides a lightweight security micro-agent that you can use to build security straight into your new IoT innovations.
-
-For more information, see the [Microsoft Defender for IoT for device builders documentation](../device-builders/overview.md).
-
 ## Supported service regions
 
 Defender for IoT routes all traffic from all European regions to the *West Europe* regional datacenter. It routes traffic from all remaining regions to the *East US* regional datacenter.

articles/iot-operations/get-started/media/quickstart-deploy/uninstall-extensions.png

@@ -296,19 +296,19 @@ In this quickstart, you configured your Arc-enabled Kubernetes cluster so that i
 
 If you're continuing on to the next quickstart, keep all of your resources.
 
-If you want to delete the Azure IoT Operations deployment but plan on reinstalling it on your cluster, be sure to keep the secrets provider on your cluster. 
+If you want to delete the Azure IoT Operations deployment but plan on reinstalling it on your cluster, be sure to keep the secrets provider on your cluster.
 
 1. In your resource group in the Azure portal, select your cluster.
 1. On your cluster resource page, select **Extensions**.
-1. Select all of the extensions of type **microsoft.iotoperations.x** and **microsoft.deviceregistry.assets**, then select **Uninstall**. 
+1. Select all of the extensions of type **microsoft.iotoperations.x** and **microsoft.deviceregistry.assets**, then select **Uninstall**. You don't need to uninstall the secrets provider extension:
 
-   Keep the secrets provider extension on your cluster.
+    :::image type="content" source="media/quickstart-deploy/uninstall-extensions.png" alt-text="Screenshot that shows the extensions to uninstall.":::
 
 1. Return to your resource group and select the custom location resource, then select **Delete**.
 
 If you want to delete all of the resources you created for this quickstart, delete the Kubernetes cluster that you deployed Azure IoT Operations to and remove the Azure resource group that contained the cluster.
 
-## Next steps
+## Next step
 
 > [!div class="nextstepaction"]
 > [Quickstart: Add OPC UA assets to your Azure IoT Operations Preview cluster](quickstart-add-assets.md)