consaf freshness

Author: PatrickFarley

articles/ai-services/content-safety/concepts/custom-categories.md

@@ -8,17 +8,17 @@ manager: nitinme
 ms.service: azure-ai-content-safety
 ms.custom: build-2024
 ms.topic: conceptual
-ms.date: 07/05/2024
+ms.date: 01/22/2025
 ms.author: pafarley
 ---
 
 # Custom categories (preview)
 
-Azure AI Content Safety lets you create and manage your own content moderation categories for enhanced moderation and filtering that matches your specific policies or use cases.
+Azure AI Content Safety lets you create and manage your own content categories for enhanced moderation and filtering that matches your specific policies or use cases.
 
 ## Types of customization
 
-There are multiple ways to define and use custom categories, which are detailed and compared in this section.
+There are multiple methods for defining and using custom categories, detailed and compared in this section.
 
 | API        | Functionality   |
 | :--------- | :------------ |
@@ -39,19 +39,19 @@ The Custom categories (rapid) API is designed to be quicker and more flexible th
 
 An incident may involve a set of emerging content patterns (text, image, or other modalities) that violate Microsoft community guidelines or the customers' own policies and expectations. These incidents need to be mitigated quickly and accurately to avoid potential live site issues or harm to users and communities. 
 
-This implementation works on text content and image content.
+This implementation works on both text content and image content.
 
 > [!TIP]
-> One way to deal with emerging content incidents is to use [Blocklists](/azure/ai-services/content-safety/how-to/use-blocklist), but that only allows exact text matching and no image matching. The Custom categories (rapid) API offers the following advanced capabilities:
-- semantic text matching using embedding search with a lightweight classifier
-- image matching with a lightweight object-tracking model and embedding search.
+> Another to deal with emerging content incidents is to use [Blocklists](/azure/ai-services/content-safety/how-to/use-blocklist), but that only allows exact text matching and no image matching. The Custom categories (rapid) API offers the following advanced capabilities:
+> - semantic text matching using embedding search with a lightweight classifier
+> - image matching with a lightweight object-tracking model and embedding search.
 
 
 ## How it works
 
 ### [Custom categories (standard) API](#tab/standard)
 
-The Azure AI Content Safety custom categories feature uses a multi-step process for creating, training, and using custom content classification models. Here's a look at the workflow:
+The Azure AI Content Safety custom categories feature uses a multi-step process for creating, training, and using custom content classification models. Here's the workflow:
 
 ### Step 1: Definition and setup
 
@@ -63,7 +63,7 @@ Then, you collect a balanced dataset with **positive** and (optionally) **negati
 
 After you prepare your dataset and define categories, the Azure AI Content Safety service trains a new machine learning model. This model uses your definitions and uploaded dataset to perform data augmentation using a large language model. As a result, the training dataset is made larger and of higher quality. During training, the AI model analyzes the data and learns to differentiate between content that aligns with the specified category and content that does not.
 
-### Step 3: Model inferencing
+### Step 3: Model evaluation
 
 After training, you need to evaluate the model to ensure it meets your accuracy requirements. Test the model with new content that it hasn't received before. The evaluation phase helps you identify any potential adjustments you need to make deploying the model into a production environment.
 
@@ -118,12 +118,14 @@ See the following table for the input limitations of the custom categories (rapi
 | Maximum number of text or image incidents per resource| 100 |  
 | Supported Image formats | BMP, GIF, JPEG, PNG, TIF, WEBP |
 
+---
+
 ### Region availability
 
 To use these APIs, you must create your Azure AI Content Safety resource in one of the supported regions. See [Region availability](../overview.md#region-availability).
 
 
-## Next steps
+## Next step
 
 Follow a how-to guide to use the Azure AI Content Safety APIs to create custom categories.
 

articles/ai-services/content-safety/concepts/protected-material.md

@@ -7,14 +7,16 @@ author: PatrickFarley
 manager: nitinme
 ms.service: azure-ai-content-safety
 ms.topic: conceptual
-ms.date: 06/24/2024
+ms.date: 01/22/2025
 ms.author: pafarley
 keywords: 
 ---
 
 
 # Protected material detection
 
+The Protected material detection APIs scan the output of large language models to identify and flag known protected material. The APIs are designed to help organizations prevent the generation of content that closely matches copyrighted text or code.
+
 The [Protected material text API](../quickstart-protected-material.md) flags known text content (for example, song lyrics, articles, recipes, and selected web content) that might be output by large language models.
 
 The [Protected material code API](../quickstart-protected-material-code.md) flags protected code content (from known GitHub repositories, including software libraries, source code, algorithms, and other proprietary programming content) that might be output by large language models.
@@ -107,7 +109,7 @@ Refer to this table for details of the major categories of protected material te
 | Lyrics      | Only focuses on issues of copyrighted content around Songs.     <br><br> Other harmful or sensitive text is out of scope for this task, unless it intersects Songs IP Copyright harm. | <ul><li>Links to web pages that contain information about songs such as:<ul><li>Lyrics of the songs</li><li>Chords or tabs of the associated music</li><li>Analysis or reviews of the song/music</li></ul></li><li>Links to authorized web pages that contain embedded audio/video players as long as:<ul><li>They have legitimate permissions</li><li>They have licensed music</li><li>They are authorized streaming platforms</li><li>They are official YouTube channels</li></ul></li><li>Short excerpts or snippets from lyrics of the songs as long as:<ul><li>They are relevant to the user's query</li><li>They are not a substantial part of the lyrics</li><li>They are not the entire lyrics</li><li>They are not more than 11 words long</li></ul></li><li>Short excerpts or snippets from chords/tabs of the songs as long as:<ul><li>They are relevant to the user's query</li><li>They are not a substantial part of the chords/tabs</li><li>They are not the entire chords/tabs</li></ul></li><li>Any content from songs that have no IP/Copyright protections:<ul><li>Songs/Lyrics/Chords/Tabs that are in the public domain</li><li>Songs/Lyrics/Chords/Tabs for which Copyright protection has elapsed, been surrendered, or never existed</li></ul></li><li>Rejection or refusal to provide copyrighted content:<ul><li>Changing topic to avoid sharing copyrighted content</li><li>Refusal to share copyrighted content</li><li>Providing nonresponsive information</li></ul></li></ul>         | <ul><li>Lyrics of a song<ul><li>Entire lyrics</li><li>Substantial part of the lyrics</li><li>Part of lyrics that contain more than 11 words</li></ul></li><li>Chords or Tabs of a song<ul><li>Entire chords/tabs</li><li>Substantial part of the chords/tabs</li></ul></li><li>Links to webpages that contain embedded audio/video players that:<ul><li>Do not have legitimate permissions</li><li>Do not have licensed music</li><li>Are not authorized streaming platforms</li><li>Are not official YouTube channels</li></ul></li><li>Methods to access copyrighted content:<ul><li>Steps to download songs from an unauthorized website</li><li>Ways to bypass paywalls or DRM protections to access copyrighted songs or videos</li></ul></li></ul>   |
 
 
-## Next steps
+## Next step
 
 Follow the quickstart to get started using Azure AI Content Safety to detect protected material.
 

articles/ai-services/content-safety/concepts/response-codes.md

@@ -1,32 +1,32 @@
 ---
 title: "Content Safety error codes"
 titleSuffix: Azure AI services
-description: See the possible error codes for the Azure AI Content Safety APIs.
+description: See the possible error codes and their corresponding suggestions for the Azure AI Content Safety APIs.
 #services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 ms.service: azure-ai-content-safety
 ms.custom: build-2023
 ms.topic: conceptual
-ms.date: 03/07/2024
+ms.date: 01/22/2025
 ms.author: pafarley
 ---
 
 # Azure AI Content Safety error codes 
 
-The content APIs may return the following error codes:
+The content APIs might return the following error codes:
 
 | Error Code    | Possible reasons   | Suggestions           |
 | ---------- | ------- | -------------------- |
-| InvalidRequestBody  | One or more fields in the request body do not match the API definition. | Check the API version you specified in the API call. <br/>Check the corresponding API definition for the API version you selected. |
-| InvalidResourceName | The resource name you specified in the URL does not meet the requirements, like the blocklist name, blocklist term ID, etc. | Check the API version you specified in the API call.  <br/>Check whether the given name has invalid characters according to the API definition. |
-| ResourceNotFound    | The resource you specified in the URL may not exist, like the blocklist name. | Check the API version you specified in the API call. <br/>Double check the existence of the resource specified in the URL. |
-| InternalError       | Some unexpected situations on the server side have been triggered. | You might want to retry a few times after a small period and see it the issue happens again.  <br/>             Contact Azure Support if this issue persists. |
+| InvalidRequestBody  | One or more fields in the request body don't match the API definition. | Check the API version you specified in the API call. <br/>Check the corresponding API definition for the API version you selected. |
+| InvalidResourceName | The resource name you specified in the URL doesn't meet the requirements, like the blocklist name, blocklist term ID, etc. | Check the API version you specified in the API call.  <br/>Check whether the given name has invalid characters according to the API definition. |
+| ResourceNotFound    | The resource you specified in the URL might not exist, like the blocklist name. | Check the API version you specified in the API call. <br/>Double check the existence of the resource specified in the URL. |
+| InternalError       | Some unexpected situations on the server side were triggered. | You might want to retry a few times after a small period and see it the issue happens again.  <br/>             Contact Azure Support if this issue persists. |
 | ServerBusy          | The server side cannot process the request temporarily.      | You might want to retry a few times after a small period and see it the issue happens again.  <br/>Contact Azure Support if this issue persists. |
-| TooManyRequests     | The current RPS has exceeded the quota for your current SKU. | Check the pricing table to understand the RPS quota.   <br/>Contact Azure Support if you need more QPS. |
+| TooManyRequests     | The current requests-per-second has exceeded the quota for your current tier. | Check the pricing table to understand the RPS quota.   <br/>Contact Azure Support if you need more QPS. |
 
 
 ## Azure AI Foundry error messages
 
-If you encounter the error **Your account does not have access to this resource, please contact your resource owner to get access**, please ensure your account is assigned the role of `Cognitive Services User` for the Content Safety resource or Azure AI Services resource you are using.
+If you encounter the error `Your account does not have access to this resource, please contact your resource owner to get access`, ensure your account is assigned the role of `Cognitive Services User` for the Content Safety resource or Azure AI Services resource you're using.
 

articles/ai-services/content-safety/how-to/use-blocklist.md

@@ -8,8 +8,9 @@ manager: nitinme
 ms.service: azure-ai-content-safety
 ms.custom: build-2023
 ms.topic: how-to
-ms.date: 06/01/2024
+ms.date: 01/22/2025
 ms.author: pafarley
+#customer intent: As a developer, I want to use blocklists for text moderation so that I can customize content filtering.
 ---
 
 

articles/ai-services/content-safety/quickstart-image.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: azure-ai-content-safety
 ms.custom: build-2023, devx-track-python, devx-track-dotnet, devx-track-extended-java, devx-track-js
 ms.topic: quickstart
-ms.date: 03/06/2024
+ms.date: 01/22/2025
 ms.author: pafarley
 zone_pivot_groups: programming-languages-content-safety
 ---
@@ -19,7 +19,7 @@ Get started with the Content Studio, REST API, or client SDKs to do basic image
 
 For more information on image moderation, see the [Harm categories concept page](./concepts/harm-categories.md). For API input limits, see the [Input requirements](./overview.md#input-requirements) section of the Overview. 
 
-> [!NOTE]
+> [!CAUTION]
 > 
 > The sample data and code may contain offensive content. User discretion is advised.
 

articles/ai-services/content-safety/quickstart-text.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: azure-ai-content-safety
 ms.custom: build-2023, devx-track-python, devx-track-dotnet, devx-track-extended-java, devx-track-js
 ms.topic: quickstart
-ms.date: 06/01/2024
+ms.date: 01/22/2025
 ms.author: pafarley
 zone_pivot_groups: programming-languages-content-safety
 ---
@@ -20,7 +20,7 @@ Get started with the Content Safety Studio, REST API, or client SDKs to do basic
 For more information on text moderation, see the [Harm categories concept page](./concepts/harm-categories.md). For API input limits, see the [Input requirements](./overview.md#input-requirements) section of the Overview. 
 
 
-> [!NOTE]
+> [!CAUTION]
 > 
 > The sample data and code may contain offensive content. User discretion is advised.