Condividi tramite


Guida introduttiva: Rilevamento del materiale protetto per il testo

La funzionalità Materiale protetto per il testo offre una soluzione completa per la gestione dei rischi associati al contenuto generato dall'intelligenza artificiale (solo contenuto in lingua inglese). Rilevando e impedendo la visualizzazione di materiale protetto, le organizzazioni possono garantire la conformità alle leggi sulla proprietà intellettuale, mantenere l'originalità dei contenuti e proteggere la loro reputazione. Il materiale protetto fa riferimento a contenuti che corrispondono a testo noto da fonti protette da copyright, ad esempio testi di canzoni, articoli, ricette o altro contenuto Web selezionato.

Gli obiettivi principali della funzionalità Rilevamento di materiale protetto per il testo generato dall'intelligenza artificiale sono:

  • Rilevare e impedire la visualizzazione di contenuto protetto generato dai modelli di intelligenza artificiale.
  • Consentire alle organizzazioni di gestire i rischi associati al contenuto generato dall'intelligenza artificiale.
  • Garantire che il contenuto generato dall'intelligenza artificiale sia conforme alle linee guida legali, etiche e dei criteri per i contenuti.

Per altre informazioni sul Rilevamento di materiale protetto, vedere la Pagina di concetto di Rilevamento di materiale protetto. Per i limiti di input dell'API, vedere la sezione Requisiti di input della panoramica.

Prerequisiti

  • Una sottoscrizione di Azure: creare un account gratuitamente
  • Dopo aver creato la sottoscrizione di Azure, Creare una risorsa di Sicurezza dei contenuti nel portale di Azure per ottenere la chiave e l'endpoint. Immettere un nome univoco per la risorsa, selezionare la sottoscrizione, quindi selezionare un gruppo di risorse, un'area supportata (vedere Disponibilità di aree) e un piano tariffario supportato. Selezionare Crea.
    • La distribuzione della risorsa richiede alcuni minuti. Al termine, selezionare Vai alla risorsa. Nel riquadro a sinistra, in Gestione risorse selezionare Chiave di sottoscrizione ed endpoint. L'endpoint e una delle chiavi vengono usati per chiamare le API.
  • cURL installato

Analizzare il testo per il rilevamento del materiale protetto

La sezione seguente illustra una richiesta di esempio con cURL. Incollare il comando qui di seguito in un editor di testo e apportare le modifiche seguenti.

  1. Sostituire <endpoint> con l'URL dell'endpoint associato alla risorsa.
  2. Sostituire <your_subscription_key> con una delle chiavi fornite con la risorsa.
  3. Facoltativamente, sostituire il campo "text" nel corpo con il testo che si desidera analizzare.

    Suggerimento

    Vedere Requisiti di input per le limitazioni massime della lunghezza del testo. Il rilevamento del materiale protetto deve essere eseguito sui completamenti LLM, non sulle richieste degli utenti.

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."
}'

I campi seguenti devono essere inclusi nell'URL:

Nome Obbligatorio? Descrizione Tipo
Versione dell'API Richiesto La versione dell'API da controllare. La versione corrente è: api-version=2024-09-01. Esempio: <endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01 String

I parametri nel corpo della richiesta sono definiti in questa tabella:

Nome Obbligatorio? Descrizione Tipo
Testo Richiesto Si tratta del testo non elaborato da controllare. È possibile includere altri caratteri non ascii. String

Vedere il corpo della richiesta di esempio seguente:

{
  "text": "string"
}

Aprire una finestra del prompt dei comandi ed eseguire il comando cURL.

Interpretare la risposta dell'API

I risultati del rilevamento di materiale protetto verranno visualizzati come dati JSON nell'output della console. Ad esempio:

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

I campi JSON nell'output sono definiti di seguito:

Nome Descrizione Tipo
protectedMaterialAnalysis Ogni classe di output stimata dall'API. String
detected Indica è stato rilevato o meno materiale protetto. Booleano

Pulire le risorse

Se si vuole pulire e rimuovere una sottoscrizione a Servizi di Azure AI, è possibile eliminare la risorsa o il gruppo di risorse. L'eliminazione del gruppo di risorse comporta anche l'eliminazione di tutte le altre risorse associate.