You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/ai-services/content-safety/how-to/custom-categories-rapid.md
+4-2Lines changed: 4 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,17 @@
1
1
---
2
2
title: "Use the custom categories (rapid) API (preview)"
3
3
titleSuffix: Azure AI services
4
-
description: Learn how to use the custom categories (rapid) API to mitigate harmful content incidents quickly.
4
+
description: Learn how to use the custom categories (rapid) API to mitigate harmful content incidents quickly and flexibly.
5
5
#services: cognitive-services
6
6
author: PatrickFarley
7
7
manager: nitinme
8
8
ms.service: azure-ai-content-safety
9
9
ms.custom: build-2024
10
10
ms.topic: how-to
11
-
ms.date: 04/11/2024
11
+
ms.date: 01/29/2025
12
12
ms.author: pafarley
13
+
#customer intent: As a developer, I want to use the custom categories (rapid) API so that I can mitigate harmful content incidents quickly and flexibly.
Copy file name to clipboardExpand all lines: articles/ai-services/content-safety/how-to/encrypt-data-at-rest.md
+7-5Lines changed: 7 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ manager: nitinme
7
7
ms.service: azure-ai-content-safety
8
8
ms.custom: build-2023
9
9
ms.topic: conceptual
10
-
ms.date: 06/01/2024
10
+
ms.date: 01/29/2025
11
11
ms.author: pafarley
12
12
---
13
13
@@ -133,13 +133,15 @@ When you disable customer-managed keys, your Azure AI services resource is then
133
133
1. Go to your Azure AI services resource, and then select **Encryption**.
134
134
1. Select **Microsoft Managed Keys** > **Save**.
135
135
136
-
When you previously enabled customer managed keys this also enabled a system assigned managed identity, a feature of Microsoft Entra ID. Once the system assigned managed identity is enabled, this resource will be registered with Microsoft Entra ID. After being registered, the managed identity will be given access to the Key Vault selected during customer managed key setup. You can learn more about [Managed Identities](/azure/active-directory/managed-identities-azure-resources/overview).
136
+
When you previously enabled customer managed keys this also enabled a system assigned managed identity, a feature of Microsoft Entra ID. Once the system assigned managed identity is enabled, this resource is registered with Microsoft Entra ID. After being registered, the managed identity will be given access to the Key Vault selected during customer managed key setup. You can learn more about [Managed Identities](/azure/active-directory/managed-identities-azure-resources/overview).
137
137
138
138
> [!IMPORTANT]
139
139
> If you disable system assigned managed identities, access to the key vault will be removed and any data encrypted with the customer keys will no longer be accessible. Any features depended on this data will stop working.
140
140
141
141
> [!IMPORTANT]
142
-
> Managed identities do not currently support cross-directory scenarios. When you configure customer-managed keys in the Azure portal, a managed identity is automatically assigned under the covers. If you subsequently move the subscription, resource group, or resource from one Microsoft Entra directory to another, the managed identity associated with the resource is not transferred to the new tenant, so customer-managed keys may no longer work. For more information, see **Transferring a subscription between Microsoft Entra directories** in [FAQs and known issues with managed identities for Azure resources](/azure/active-directory/managed-identities-azure-resources/known-issues#transferring-a-subscription-between-azure-ad-directories).
142
+
> Managed identities do not currently support cross-directory scenarios. When you configure customer-managed keys in the Azure portal, a managed identity is automatically assigned under the covers. If you later move the subscription, resource group, or resource from one Microsoft Entra directory to another, the managed identity associated with the resource is not transferred to the new tenant, so customer-managed keys may no longer work. For more information, see **Transferring a subscription between Microsoft Entra directories** in [FAQs and known issues with managed identities for Azure resources](/azure/active-directory/managed-identities-azure-resources/known-issues#transferring-a-subscription-between-azure-ad-directories).
Follow this guide to use Azure AI Content Safety Custom categories (standard) REST API to create your own content categories for your use case and train Azure AI Content Safety to detect them in new text content.
18
+
Follow this guide to use Azure AI Content Safety Custom categories (standard) REST API to create your own content categories for your use case and train Azure AI Content Safety to detect them in new text content.
18
19
19
20
For more information on Custom categories, see the [Custom categories concept page](./concepts/custom-categories.md). For API input limits, see the [Input requirements](./overview.md#input-requirements) section of the Overview.
20
21
@@ -45,7 +46,7 @@ To train a custom category, you need example text data that represents the categ
45
46
> For tips on creating your own data set, see the [How-to guide](./how-to/custom-categories.md#prepare-your-training-data).
46
47
47
48
1. Download the [sample text data file](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/ContentSafety/survival-advice.jsonl) from the GitHub repository.
48
-
2. Upload the _.jsonl_ file to your Azure Storage account blob container. Then copy the blob URL to a temporary location for later use.
49
+
1. Upload the _.jsonl_ file to your Azure Storage account blob container. Then copy the blob URL to a temporary location for later use.
49
50
50
51
> [!IMPORTANT]
51
52
> **The user's storage account is set up as a hierarchical namespace account, which cannot be supported by Custom Categories. Please try using a regular storage account instead.**
@@ -77,36 +78,30 @@ curl -X PUT "<your_endpoint>/contentsafety/text/categories/<your_category_name>?
77
78
> Every time you change your category name, definition or samples,a new version will be created. You can use the version number to trace back to previous versions. Please remember this version number, as it will be required in the URL for the next step- training custom categories.
|`categoryName`| The name of the category or topic the response relates to. | survival-advice|
98
-
|`definition`| A brief description of the content type for the category. | text prompts about survival advice in camping/wilderness situations |
93
+
| Field | Description | Example Value |
94
+
|------------------------|---|---------|
95
+
|`categoryName`| The name of the category or topic the response relates to. | survival-advice |
96
+
|`definition`| A brief description of the content type for the category. | text prompts about survival advice in camping/wilderness situations |
99
97
|`sampleBlobUrl`| URL to access a sample JSONL file containing data examples for the category. | Link |
100
98
|`sampleBlobSnapshotUrl`| Snapshot URL of the sample JSONL file, which provides access to a specific version of the data. | Snapshot URL |
101
-
|`version`| The version number of the category data. | 1 |
102
-
|`createdTime`| Timestamp when the category data was created. | 2024-10-28T22:06:59.4626988Z |
103
-
|`status`| Current status of the category data processing. | Succeeded |
104
-
105
-
106
-
99
+
|`version`| The version number of the category data. | 1 |
100
+
|`createdTime`| Timestamp when the category data was created. | 2024-10-28T22:06:59.4626988Z |
101
+
|`status`| Current status of the category data processing. | Succeeded |
107
102
108
103
109
-
### Start the category build process:
104
+
### Start the category build process
110
105
111
106
Replace <your_api_key> and <your_endpoint> with your own values, and also **append the version number in the url you obtained from the last step.** Allow enough time for model training: the end-to-end execution of custom category training can take from around five hours to ten hours. Plan your moderation pipeline accordingly. After you receive the response, store the operation ID (referred to as `id`) in a temporary location. This ID will be necessary for retrieving the build status using the **Get status** API in the next section.
112
107
@@ -124,7 +119,7 @@ curl -X POST "<your_endpoint>/contentsafety/text/categories/survival-advice:buil
124
119
|`status`| Current status of the request | Succeeded |
125
120
126
121
127
-
### Get the category build status:
122
+
### Get the category build status
128
123
129
124
To retrieve the status, utilize the `id` obtained from the previous API response and place it in the path of the API below.
130
125
@@ -133,6 +128,7 @@ curl -X GET "<your_endpoint>/contentsafety/text/categories/operations/<id>?api-v
133
128
-H "Ocp-Apim-Subscription-Key: <your_api_key>" \
134
129
-H "Content-Type: application/json"
135
130
```
131
+
136
132
#### API Response
137
133
138
134
| Field | Description | Example Value |
@@ -154,6 +150,7 @@ curl -X POST "<your_endpoint>/contentsafety/text:analyzeCustomCategory?api-versi
Remember to replace the placeholders below with your actual values for the API key, endpoint, and specific content (category name, definition, and so on). These examples help you to manage the customized categories in your account.
Copy file name to clipboardExpand all lines: articles/ai-services/content-safety/quickstart-protected-material.md
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,8 +7,10 @@ author: PatrickFarley
7
7
manager: nitinme
8
8
ms.service: azure-ai-content-safety
9
9
ms.topic: quickstart
10
-
ms.date: 10/30/2023
10
+
ms.date: 01/29/2025
11
11
ms.author: pafarley
12
+
#customer intent: As a developer, I want to detect protected material in AI-generated text so that I can ensure compliance with intellectual property laws.
13
+
12
14
---
13
15
14
16
# Quickstart: Protected material detection for text
@@ -24,7 +26,6 @@ The key objectives of the Protected Material Detection for Text feature for AI-g
24
26
For more information about protected material detection, see the [Protected material detection concept page](./concepts/protected-material.md). For API input limits, see the [Input requirements](./overview.md#input-requirements) section of the Overview.
25
27
26
28
27
-
28
29
## Prerequisites
29
30
30
31
* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
0 commit comments