Merge pull request #600 from cdpark/refresh-sept-patrickfarley-3

Feature 308280: Q&M: AI Services freshness for 180d target - Batch 3

Author: Stacyrch140

articles/ai-services/content-safety/media/analyze-image.png

@@ -1,39 +1,39 @@
 ---
 title: "Quickstart: Content Safety Studio"
 titleSuffix: "Azure AI services"
-description: In this quickstart, get started with the Content Safety service using Content Safety Studio in your browser.
+description: Learn how to get started with the Content Safety service using Content Safety Studio in your browser.
 #services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 ms.service: azure-ai-content-safety
 ms.custom: build-2023, build-2023-dataai
 ms.topic: quickstart
-ms.date: 02/14/2024
+ms.date: 10/01/2024
 ms.author: pafarley
 ---
 
 # QuickStart: Azure AI Content Safety Studio
 
-In this quickstart, get started with the Azure AI Content Safety service using Content Safety Studio in your browser. 
+This article explains how you can get started with the Azure AI Content Safety service using Content Safety Studio in your browser.
 
 > [!CAUTION]
-> Some of the sample content provided by Content Safety Studio may be offensive. Sample images are blurred by default. User discretion is advised.
+> Some of the sample content provided by Content Safety Studio might be offensive. Sample images are blurred by default. User discretion is advised.
 
 ## Prerequisites
 
-* An active Azure account. If you don't have one, you can [create one for free](https://azure.microsoft.com/free/cognitive-services/).
+* An Azure account. If you don't have one, you can [create one for free](https://azure.microsoft.com/pricing/purchase-options/azure-account?icid=ai-services).
 * A [Content Safety](https://aka.ms/acs-create) Azure resource.
-* Assign `Cognitive Services User` role to your account. Go to the [Azure Portal](https://portal.azure.com/), navigate to your Content Safety resource or Azure AI Services resource, and select **Access Control** in the left navigation bar, then select **+ Add role assignment**, choose the `Cognitive Services User` role and select the member of your account that you need to assign this role to, then review and assign. It might take few minutes for the assignment to take effect.
-* Sign in to [Content Safety Studio](https://contentsafety.cognitive.azure.com) with your Azure subscription and Content Safety resource. 
+* Assign the *Cognitive Services User* role to your account. Go to the [Azure portal](https://portal.azure.com), navigate to your Content Safety resource or Azure AI Services resource, and select **Access Control** in the left navigation bar, then select **+ Add role assignment**, choose the *Cognitive Services User* role, and select the member of your account that you need to assign this role to, then review and assign. It might take a few minutes for the assignment to take effect.
+* Sign in to [Content Safety Studio](https://contentsafety.cognitive.azure.com) with your Azure subscription and Content Safety resource.
 
 > [!IMPORTANT]
-> * You must assign the `Cognitive Services User` role to your Azure account to use the studio experience. Go to the [Azure Portal](https://portal.azure.com/), navigate to your Content Safety resource or Azure AI Services resource, and select **Access Control** in the left navigation bar, then select **+ Add role assignment**, choose the `Cognitive Services User` role and select the member of your account that you need to assign this role to, then review and assign. It might take few minutes for the assignment to take effect.
-
+> You must assign the *Cognitive Services User* role to your Azure account to use the studio experience. Go to the [Azure portal](https://portal.azure.com), navigate to your Content Safety resource or Azure AI Services resource, and select **Access Control** in the left navigation bar, then select **+ Add role assignment**, choose the *Cognitive Services User* role, and select the member of your account that you need to assign this role to, then review and assign. It might take few minutes for the assignment to take effect.
 
 ## Analyze text content
-The [Moderate text content](https://contentsafety.cognitive.azure.com/text) page provides capability for you to quickly try out text moderation.
 
-:::image type="content" source="media/analyzetext.png" alt-text="Screenshot of Analyze Text panel.":::
+The [Moderate text content](https://contentsafety.cognitive.azure.com/text) page provides the capability for you to quickly try out text moderation.
+
+:::image type="content" source="media/analyze-text.png" alt-text="Screenshot of Analyze Text panel.":::
 
 1. Select the **Moderate text content** panel.
 1. Add text to the input field, or select sample text from the panels on the page.
@@ -43,15 +43,15 @@ The [Moderate text content](https://contentsafety.cognitive.azure.com/text) page
     > See [Input requirements](./overview.md#input-requirements) for maximum text length limitations.
 1. Select **Run test**.
 
-The service returns all the categories that were detected, with the severity level for each(0-Safe, 2-Low, 4-Medium, 6-High). It also returns a binary **Accepted**/**Rejected** result, based on the filters you configure. Use the matrix in the **Configure filters** tab on the right to set your allowed/prohibited severity levels for each category. Then you can run the text again to see how the filter works.
+The service returns all the categories that were detected, with the severity level for each: 0-Safe, 2-Low, 4-Medium, 6-High. It also returns a binary **Accepted**/**Rejected** result, based on the filters you configure. Use the matrix in the **Configure filters** tab to set your allowed/prohibited severity levels for each category. Then you can run the text again to see how the filter works.
 
-The **Use blocklist** tab on the right lets you create, edit, and add a blocklist to the moderation workflow. If you have a blocklist enabled when you run the test, you get a **Blocklist detection** panel under **Results**. It reports any matches with the blocklist.
+The **Use blocklist** tab lets you create, edit, and add a blocklist to the moderation workflow. If you have a blocklist enabled when you run the test, you get a **Blocklist detection** panel under **Results**. It reports any matches with the blocklist.
 
 ## Detect user input attacks
 
 The **Prompt Shields** panel lets you try out user input risk detection. Detect User Prompts designed to provoke the Generative AI model into exhibiting behaviors it was trained to avoid or break the rules set in the System Message. These attacks can vary from intricate role-play to subtle subversion of the safety objective.
 
-:::image type="content" source="media/jailbreak-panel.png" alt-text="Screenshot of content safety studio with user input risk detection panel selected.":::
+:::image type="content" source="media/prompt-shields.png" alt-text="Screenshot of content safety studio with Prompt Shields panel selected.":::
 
 1. Select the **Prompt Shields** panel.
 1. Select a sample text on the page, or input your own content for testing. You can also upload a CSV file to do a batch test.
@@ -62,25 +62,26 @@ The service returns the risk flag and type for each sample.
 For more information, see the [Prompt Shields conceptual guide](./concepts/jailbreak-detection.md).
 
 ## Analyze image content
+
 The [Moderate image content](https://contentsafety.cognitive.azure.com/image) page provides capability for you to quickly try out image moderation.
 
-:::image type="content" source="media/analyzeimage.png" alt-text="Screenshot of Analyze Image panel.":::
+:::image type="content" source="media/analyze-image.png" alt-text="Screenshot of Analyze Image panel.":::
 
 1. Select the **Moderate image content** panel.
 1. Select a sample image from the panels on the page, or upload your own image. 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.
 1. Select **Run test**.
 
-The service returns all the categories that were detected, with the severity level for each(0-Safe, 2-Low, 4-Medium, 6-High). It also returns a binary **Accepted**/**Rejected** result, based on the filters you configure. Use the matrix in the **Configure filters** tab on the right to set your allowed/prohibited severity levels for each category. Then you can run the text again to see how the filter works.
+The service returns all the categories that were detected, with the severity level for each: 0-Safe, 2-Low, 4-Medium, 6-High. It also returns a binary **Accepted**/**Rejected** result, based on the filters you configure. Use the matrix in the **Configure filters** tab on the right to set your allowed/prohibited severity levels for each category. Then you can run the text again to see how the filter works.
 
 ## View and export code
-You can use the **View Code** feature in both *Analyze text content* or *Analyze image content* page to view and copy the sample code, which includes configuration for severity filtering, blocklists, and moderation functions. You can then deploy the code on your end.
 
-:::image type="content" source="media/viewcode.png" alt-text="Screenshot of the View code.":::
+You can use the **View Code** feature in either the *Analyze text content* or *Analyze image content* pages to view and copy the sample code, which includes configuration for severity filtering, blocklists, and moderation functions. You can then deploy the code on your end.
 
+:::image type="content" source="media/view-code.png" alt-text="Screenshot of the View code window.":::
 
 ## Monitor online activity
 
-The [Monitor online activity](https://contentsafety.cognitive.azure.com/monitor) page lets you view your API usage and trends. 
+The [Monitor online activity](https://contentsafety.cognitive.azure.com/monitor) panel lets you view your API usage and trends.
 
 :::image type="content" source="media/monitor.png" alt-text="Screenshot of Monitoring panel.":::
 
@@ -93,6 +94,7 @@ In the **Reject rate per category** chart, you can also adjust the severity thre
 You can also edit blocklists if you want to change some terms, based on the **Top 10 blocked terms** chart.
 
 ## Manage your resource
+
 To view resource details such as name and pricing tier, select the **Settings** icon in the top-right corner of the Content Safety Studio home page and select the **Resource** tab. If you have other resources, you can switch resources here as well.
 
 :::image type="content" source="media/manage-resource.png" alt-text="Screenshot of Manage Resource.":::
@@ -104,9 +106,9 @@ If you want to clean up and remove an Azure AI services resource, you can delete
 - [Azure portal](../multi-service-resource.md?pivots=azportal#clean-up-resources)
 - [Azure CLI](../multi-service-resource.md?pivots=azcli#clean-up-resources)
 
-## Next steps
+## Next step
 
 Next, get started using Azure AI Content Safety through the REST APIs or a client SDK, so you can seamlessly integrate the service into your application.
 
 > [!div class="nextstepaction"]
-> [Quickstart: REST API and client SDKs](./quickstart-text.md)
+> [Quickstart: Analyze text content](./quickstart-text.md)

articles/ai-services/content-safety/media/analyze-text.png

@@ -84,7 +84,7 @@ To upload another set of images, return to the top of this section and repeat th
 
 To train the detector model, select the **Train** button. The detector uses all of the current images and their tags to create a model that identifies each tagged object. This process can take several minutes.
 
-![The train button in the top right of the web page's header toolbar](./media/getting-started-build-a-classifier/train01.png)
+![The train button in the top right of the web page's header toolbar](./media/getting-started-build-a-classifier/train-1.png)
 
 The training process should only take a few minutes. During this time, information about the training process is displayed in the **Performance** tab.