Merge pull request #277079 from PatrickFarley/content-safety-updates

[Azure AI Svcs] Content safety updates

Author: Stacyrch140

articles/ai-services/content-safety/language-support.md

@@ -14,7 +14,8 @@ ms.author: pafarley
 
 # Language support for Azure AI Content Safety
 
-Some capabilities of Azure AI Content Safety support multiple languages; any capabilities not listed here only support English.
+> [!IMPORTANT]
+> Azure AI Content Safety features not listed in this article, such as Prompt Shields, Protected material detection, Groundedness detection, and Custom categories (rapid) only support English.
 
 ## Text moderation
 

articles/ai-services/content-safety/overview.md

@@ -45,12 +45,13 @@ There are different types of analysis available from this service. The following
 
 | Type                        | Functionality           |
 | :-------------------------- | :---------------------- |
-| [Analyze text](/rest/api/cognitiveservices/contentsafety/text-operations/analyze-text) API          | Scans text for sexual content, violence, hate, and self harm with multi-severity levels. |
-| [Analyze image](/rest/api/cognitiveservices/contentsafety/image-operations/analyze-image) API         | Scans images for sexual content, violence, hate, and self harm with multi-severity levels. |
 | [Prompt Shields](/rest/api/cognitiveservices/contentsafety/text-operations/detect-text-jailbreak) (preview) | Scans text for the risk of a [User input attack](./concepts/jailbreak-detection.md) on a Large Language Model. [Quickstart](./quickstart-jailbreak.md) |
 | [Groundedness detection](/rest/api/cognitiveservices/contentsafety/text-groundedness-detection-operations/detect-groundedness-options) (preview) | Detects whether the text responses of large language models (LLMs) are grounded in the source materials provided by the users. [Quickstart](./quickstart-groundedness.md) |
 | [Protected material text detection](/rest/api/cognitiveservices/contentsafety/text-operations/detect-text-protected-material) (preview) | Scans AI-generated text for known text content (for example, song lyrics, articles, recipes, selected web content). [Quickstart](./quickstart-protected-material.md)|
 | Custom categories (rapid) API (preview) | Lets you define [emerging harmful content patterns](./concepts/custom-categories-rapid.md) and scan text and images for matches. [How-to guide](./how-to/custom-categories-rapid.md) |
+| [Analyze text](/rest/api/cognitiveservices/contentsafety/text-operations/analyze-text) API          | Scans text for sexual content, violence, hate, and self harm with multi-severity levels. |
+| [Analyze image](/rest/api/cognitiveservices/contentsafety/image-operations/analyze-image) API         | Scans images for sexual content, violence, hate, and self harm with multi-severity levels. |
+
 
 ## Content Safety Studio
 
@@ -98,9 +99,29 @@ Currently, Azure AI Content Safety has an **F0 and S0** pricing tier. See the Az
 
 ### Input requirements
 
-The default maximum length for text submissions is 10K characters. If you need to analyze longer blocks of text, you can split the input text (for example, by punctuation or spacing) across multiple related submissions.
+See the following list for the input requirements for each feature.
+
+<!--
+|  | Analyze text API | Analyze image API |  Prompt Shields<br>(preview) | Groundedness<br>detection (preview) | Protected material<br>detection (preview) |
+|-------|---|----------|----------|-----|-----|
+| Input requirements:   | Default maximum length: 10K characters (split longer texts as needed). | Maximum image file size: 4 MB<br>Dimensions between 50x50 and 2048x2048 pixels.<br>Images can be in JPEG, PNG, GIF, BMP, TIFF, or WEBP formats. | Maximum prompt length: 10K characters.<br>Up to five documents with a total of 10D characters. | Maximum 55,000 characters for grounding sources per API call.<br>Maximum text and query length: 7,500 characters. | Default maximum: 1K characters.<br>Minimum: 111 characters (for scanning LLM completions, not user prompts). | -->
+
+- **Analyze text API**: 
+  - Default maximum length: 10K characters (split longer texts as needed).
+- **Analyze image API**: 
+  - Maximum image file size: 4 MB
+  - Dimensions between 50 x 50 and 2048 x 2048 pixels.
+  - Images can be in JPEG, PNG, GIF, BMP, TIFF, or WEBP formats.
+- **Prompt Shields (preview)**: 
+  - Maximum prompt length: 10K characters.
+  - Up to five documents with a total of 10K characters.
+- **Groundedness detection (preview)**: 
+  - Maximum length for grounding sources: 55,000 characters (per API call).
+  - Maximum text and query length: 7,500 characters.
+- **Protected material detection (preview)**: 
+  - Default maximum length: 1K characters.
+  - Minimum length: 111 characters (for scanning LLM completions, not user prompts).
 
-The maximum size for image submissions is 4 MB, and image dimensions must be between 50 x 50 pixels and 2,048 x 2,048 pixels. Images can be in JPEG, PNG, GIF, BMP, TIFF, or WEBP formats.
 
 ### Language support
 
@@ -112,7 +133,7 @@ For more information, see [Language support](/azure/ai-services/content-safety/l
 
 To use the Content Safety APIs, you must create your Azure AI Content Safety resource in the supported regions. Currently, the Content Safety features are available in the following Azure regions: 
 
-|Region | Moderation APIs | Prompt Shields |  Protected material<br>detection | Groundedness<br>detection | Incident response | Blocklists |
+|Region | Moderation APIs | Prompt Shields<br>(preview) |  Protected material<br>detection (preview) | Groundedness<br>detection (preview) | Custom categories<br>(rapid) (preview) | Blocklists |
 |---|---|---|---|---|---|---|
 | East US | ✅ | ✅| ✅ |✅ |✅ |✅ |
 | East US 2 | ✅ | | | ✅ | | ✅|
@@ -134,26 +155,12 @@ Feel free to [contact us](mailto:[email protected]) if you need
 
 ### Query rates
 
-#### Moderation APIs
-
-| Pricing Tier | Requests per 10 seconds  |
-| :----------- | :--------------------- |
-| F0           | 1000                     |
-| S0           | 1000                     |
-
-
-#### Prompt Shields
-| Pricing Tier | Requests per 10 seconds |
-| :----------- | :---------------------------- |
-| F0           | 1000         |
-| S0           | 1000         |
-
-#### Groundedness detection
-| Pricing Tier | Requests per 10 seconds |
-| :----------- | :--------------------------- |
-| F0           | 50                           |
-| S0           | 50                           |
+Content Safety features have query rate limits in requests-per-10-seconds. See the following table for the rate limits for each feature.
 
+|Pricing tier | Moderation APIs | Prompt Shields<br>(preview) |  Protected material<br>detection (preview) | Groundedness<br>detection (preview) | Custom categories<br>(rapid) (preview) | 
+|--------|---------|-------------|---------|---------|---------|
+| F0    | 1000     | 1000        | 1000     | 50      | 1000 |
+| S0    | 1000     | 1000        | 1000     | 50      | 1000 |
 
 If you need a faster rate, please [contact us](mailto:[email protected]) to request.
 

articles/ai-services/content-safety/toc.yml

@@ -17,19 +17,18 @@ items:
     href: faq.yml
 - name: Quickstarts
   items:
-  - name: Content Safety Studio
-    href: studio-quickstart.md
-  - name: Text moderation
-    href: quickstart-text.md
-  - name: Image moderation
-    href: quickstart-image.md
   - name: Prompt Shields (preview)
     href: quickstart-jailbreak.md
   - name: Groundedness detection (preview)
     href: quickstart-groundedness.md
   - name: Protected material detection (preview)
     href: quickstart-protected-material.md
-
+  - name: Content Safety Studio
+    href: studio-quickstart.md
+  - name: Text moderation
+    href: quickstart-text.md
+  - name: Image moderation
+    href: quickstart-image.md
 - name: Samples 
   items: 
   - name: Azure AI Content Safety Python samples
@@ -58,14 +57,14 @@ items:
         href: ../cognitive-services-virtual-networks.md?context=/azure/ai-services/content-safety/context/context
 - name: Concepts
   items:
-  - name: Harm categories
-    href: concepts/harm-categories.md
   - name: Prompt Shields
     href: concepts/jailbreak-detection.md
   - name: Groundedness detection
     href: concepts/groundedness.md
   - name: Custom categories (rapid)
     href: concepts/custom-categories-rapid.md
+  - name: Harm categories
+    href: concepts/harm-categories.md
 - name: Reference
   items:
   - name: Azure AI Content Safety REST API