Snabbstart: Skyddad materialidentifiering för text

Funktionen Skyddat material för text ger en omfattande lösning för att hantera risker som är kopplade till AI-genererat innehåll (endast engelskt innehåll). Genom att identifiera och förhindra visning av skyddat material kan organisationer säkerställa efterlevnad av lagar om immateriella rättigheter, upprätthålla innehållets originalitet och skydda deras rykte. Skyddat material avser innehåll som matchar känd text från upphovsrättsskyddade källor, till exempel sångtexter, artiklar, recept eller annat valt webbinnehåll.

Huvudmålen för funktionen Skyddad materialidentifiering för text för AI-genererat innehåll är:

  • För att identifiera och förhindra visning av skyddat innehåll som genereras av AI-modeller.
  • För att göra det möjligt för organisationer att hantera risker som är associerade med AI-genererat innehåll.
  • För att säkerställa att AI-genererat innehåll följer riktlinjerna för juridiska principer, etiska principer och innehåll.

Mer information om identifiering av skyddat material finns på sidan koncept för skydd av materialidentifiering. För API-indatabegränsningar, se avsnittet Indatakrav i översikten.

Förutsättningar

  • En Azure-prenumeration – Skapa en kostnadsfritt
  • När du har din Azure-prenumeration skapar du en Content Safety-resurs i Azure Portal för att hämta din nyckel och slutpunkt. Ange ett unikt namn för resursen, välj din prenumeration och välj en resursgrupp, region som stöds (se Regiontillgänglighet) och prisnivå som stöds. Välj sedan Skapa.
    • Det tar några minuter att distribuera resursen. När den är klar väljer du Gå till resurs. I den vänstra rutan under Resurshantering väljer du Prenumerationsnyckel och Slutpunkt. Slutpunkten och någon av nycklarna används för att anropa API:er.
  • cURL installerat

Analysera text för identifiering av skyddat material

I följande avsnitt går vi igenom en exempelbegäran med cURL. Klistra in kommandot nedan i en textredigerare och gör följande ändringar.

  1. Ersätt <endpoint> med slutpunkts-URL:en som är associerad med resursen.
  2. Ersätt <your_subscription_key> med en av nycklarna som medföljer resursen.
  3. Du kan också ersätta fältet "text" i brödtexten med din egen text som du vill analysera.

    Dricks

    Se Indatakrav för maximala textlängdsbegränsningar. Skyddad materialidentifiering är avsedd att köras vid LLM-slutföranden, inte användaruppmaningar.

curl --location --request POST '<endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "text": "Kiss me out of the bearded barley Nightly beside the green, green grass Swing, swing, swing the spinning step You wear those shoes and I will wear that dress Oh, kiss me beneath the milky twilight Lead me out on the moonlit floor Lift your open hand Strike up the band and make the fireflies dance Silver moon's sparkling So, kiss me Kiss me down by the broken tree house Swing me upon its hanging tire Bring, bring, bring your flowered hat We'll take the trail marked on your father's map."
}'

Fälten nedan måste inkluderas i URL:en:

Name Obligatoriskt? beskrivning Typ
API-version Obligatoriskt Det här är DEN API-version som ska kontrolleras. Den aktuella versionen är: api-version=2024-09-01. Exempel: <endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01 String

Parametrarna i begärandetexten definieras i den här tabellen:

Name Obligatoriskt? beskrivning Typ
text Obligatoriskt Det här är den råa text som ska kontrolleras. Andra tecken som inte är ascii-tecken kan inkluderas. String

Se följande exempel på begärandetext:

{
  "text": "string"
}

Öppna ett kommandotolksfönster och kör kommandot cURL.

Tolka API-svaret

Du bör se resultaten för identifiering av skyddat material som visas som JSON-data i konsolens utdata. Till exempel:

{
  "protectedMaterialAnalysis": {
    "detected": true
  }
}

JSON-fälten i utdata definieras här:

Name beskrivning Typ
protectedMaterialAnalysis Varje utdataklass som API:et förutsäger. String
Upptäckt Om skyddat material har identifierats eller inte. Booleskt

Rensa resurser

Om du vill rensa och ta bort en Azure AI-tjänstprenumeration kan du ta bort resursen eller resursgruppen. Om du tar bort resursgruppen tas även alla andra resurser som är associerade med den bort.