> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Rilevamento delle entità > **Note** > > **Guida pratica** · Presuppone che tu abbia completato la [guida rapida di Speech to Text ](/docs/it/eleven-api/guides/cookbooks/speech-to-text). ## Panoramica Il rilevamento delle entità è una funzionalità che consente di rilevare parole e frasi specifiche nella trascrizione, fornendone i timestamp esatti. È utile per rilevare numeri di carte di credito, nomi, condizioni mediche o numeri di previdenza sociale, che possono poi essere oscurati. Quando è abilitata, il modello rileva tipi di entità specifici nella trascrizione e ne fornisce i timestamp esatti. Ad esempio, il seguente audio: Genera la seguente trascrizione quando specifichiamo `"pii"` (informazioni personali identificabili) come tipo di entità: ```json maxLines=0 { "language_code": "eng", "language_probability": 0.9869821071624756, "text": "My name is Jill. My date of birth is the 12th of July 1987, and my credit card number is 4242-4242-4242-4242.", "words": [ { "text": "My", "start": 0.099, "end": 0.259, "type": "word", "logprob": 0.0 }, { "text": " ", "start": 0.259, "end": 0.299, "type": "spacing", "logprob": 0.0 }, { "text": "name", "start": 0.299, "end": 0.42, "type": "word", "logprob": 0.0 }, ... ], "transcription_id": "Y2ZX8AxHUzTPCIualYiE", "entities": [ { "text": "Jill", "entity_type": "name", "start_char": 11, "end_char": 15 }, { "text": "12th of July 1987", "entity_type": "dob", "start_char": 41, "end_char": 58 }, { "text": "4242-4242-4242-4242", "entity_type": "credit_card", "start_char": 89, "end_char": 108 } ] } ``` Il risultato mostra le entità PII rilevate nella trascrizione, con i relativi timestamp esatti. ## Integrare il rilevamento delle entità Il rilevamento delle entità viene integrato nell'API Speech to Text passando il parametro `entity_detection` al metodo `convert`. ```python maxLines=0 import os from dotenv import load_dotenv from io import BytesIO import requests from elevenlabs.client import ElevenLabs load_dotenv() elevenlabs = ElevenLabs( api_key=os.getenv("ELEVENLABS_API_KEY"), ) audio_url = ( "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/stt-entity-detection-pii.mp3" ) response = requests.get(audio_url) audio_data = BytesIO(response.content) transcription = elevenlabs.speech_to_text.convert( file=audio_data, model_id="scribe_v2", # Model to use # Entity types to detect, accepts a list of specific entity types or categories. # To detect all entity types, use the "all" category. entity_detection=["pii"], ) print("Entities detected:", transcription.entities) ``` ```typescript maxLines=0 import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; import "dotenv/config"; const elevenlabs = new ElevenLabsClient({ apiKey: process.env.ELEVENLABS_API_KEY, }); const response = await fetch( "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/stt-entity-detection-pii.mp3" ); const audioBlob = new Blob([await response.arrayBuffer()], { type: "audio/mp3" }); const transcription = await elevenlabs.speechToText.convert({ file: audioBlob, modelId: "scribe_v2", // Model to use // Entity types to detect, accepts a list of specific entity types or categories. // To detect all entity types, use the "all" category. entityDetection: ["pii"], }); console.log("Entities detected:", transcription.entities); ``` ## Tipi di entità Sono supportati i seguenti tipi di entità per il rilevamento. Puoi rilevare interi gruppi usando le parole chiave di categoria `pii`, `phi`, `pci`, `other` o `offensive_language`, oppure specificare singoli tipi di entità tramite la relativa etichetta. Per rilevare tutti i tipi di entità, usa la categoria `all`. #### PII (Informazioni di identificazione personale) | Etichetta | Descrizione | Conformità normativa | | --------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | `account_number` | Numero di identificazione dell'account cliente o dell'iscrizione | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `age` | Numeri associati all'età di una persona | GDPR, HIPAA, Quebec Privacy Act, APPI | | `bank_account` | Numeri di conto bancario e relativi equivalenti internazionali, come l'IBAN | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cardinal` | Espressioni numeriche in forma cardinale | | | `credit_card` | Numeri di carta di credito | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Data di scadenza di una carta di credito | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | Codici di verifica della carta di 3 o 4 cifre ed equivalenti | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `date` | Date di calendario specifiche, che possono includere giorni della settimana, date, mesi o anni | HIPAA, Quebec Privacy Act | | `date_interval` | Periodi più ampi, inclusi intervalli di date, mesi, stagioni, anni e decenni | HIPAA | | `dob` | Date di nascita | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `driver_license` | Numeri di patente di guida | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `email_address` | Indirizzi email | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `event` | Nomi di eventi o festività | | | `filename` | Nomi di file del computer, inclusa l'estensione o il filepath | | | `gender` | Termini che indicano l'identità di genere, inclusi termini gergali | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `gender_sexuality` | Alias legacy che comprende sia `gender` sia `sexual_orientation` | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `sexual_orientation` | Termini che indicano l'orientamento sessuale, inclusi termini gergali | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `healthcare_number` | Numeri sanitari e numeri dei beneficiari di piani sanitari | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `ip_address` | Indirizzo IP Internet, inclusi i formati IPv4 e IPv6 | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location` | Metaclasse per qualsiasi riferimento a una località denominata | GDPR, HIPAA, APPI | | `location_address` | Indirizzi postali fisici completi o parziali | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_city` | Nomi di comuni, inclusi villaggi, paesi e città | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_coordinate` | Posizioni geografiche indicate tramite coordinate di latitudine, longitudine e/o altitudine | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_country` | Nomi di paesi | GDPR, APPI | | `location_state` | Nomi di stati, province, territori o prefetture | GDPR, APPI | | `location_zip` | Codici ZIP (incluso ZIP+4), codici postali o codici di avviamento postale | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `money` | Nomi e/o importi di valute | | | `name` | Nomi di persone, esclusi i titoli personali come "Signora" o "Signor" | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_given` | Nomi dati a una persona, di solito alla nascita; spesso nome e secondo nome nelle culture occidentali | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_family` | Nomi che indicano la famiglia o la comunità di una persona; spesso il cognome nelle culture occidentali | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_medical_professional` | Nomi che includono il titolo di un professionista sanitario, come "Dottore" | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `numerical_pii` | PII numerici che non rientrano in altre categorie | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `occupation` | Titoli professionali o professioni | Quebec Privacy Act, APPI | | `ordinal` | Espressioni numeriche in forma ordinale | | | `origin` | Termini che indicano nazionalità, etnia o provenienza | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `passport_number` | Numeri di passaporto, rilasciati da qualsiasi paese | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `password` | Password degli account, PIN, chiavi di accesso o risposte di verifica | CPRA, APPI | | `percent` | Espressioni numeriche come percentuali | | | `phone_number` | Numeri di telefono o fax | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `physical_attribute` | Attributi fisici distintivi, inclusi termini che indicano la razza | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `ssn` | Numeri di previdenza sociale o numeri di identificazione governativa equivalenti internazionali | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `time` | Espressioni che indicano l'orario | | | `url` | Indirizzi Internet | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `username` | Nomi utente, nomi di login o handle | CPRA, GDPR, APPI | | `vehicle_id` | Numeri di identificazione dei veicoli (VIN), numeri di serie dei veicoli e numeri di targa | CPRA, GDPR, HIPAA, APPI | #### PHI (Informazioni sanitarie protette) | Etichetta | Descrizione | Conformità normativa | | ---------------------- | ------------------------------------------------------------------ | ----------------------------------------------------- | | `condition` | Nomi di condizioni mediche, malattie, sindromi, deficit e disturbi | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `drug` | Medicinali, vitamine e integratori | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `injury` | Lesioni fisiche, incluse mutazioni, aborti spontanei e lussazioni | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `blood_type` | Gruppi sanguigni | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `medical_process` | Processi medici, inclusi trattamenti, procedure ed esami | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `clinical_measurement` | Misurazioni cliniche, parametri vitali e risultati di laboratorio | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `statistics` | Alias legacy per `clinical_measurement` | HIPAA, Quebec Privacy Act | #### PCI (Settore delle carte di pagamento) | Etichetta | Descrizione | Conformità normativa | | ------------------------ | ------------------------------------------------------------ | ------------------------------------------- | | `credit_card` | Numeri di carta di credito | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Data di scadenza di una carta di credito | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | Codici di verifica della carta di 3 o 4 cifre ed equivalenti | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | #### Altre entità | Etichetta | Descrizione | Conformità normativa | | ----------------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------- | | `language` | Nomi di lingue naturali | GDPR, GDPR Sensitive, APPI Sensitive | | `marital_status` | Termini che indicano lo stato civile | APPI Sensitive | | `organization` | Nomi di organizzazioni o reparti all'interno di un'organizzazione | Quebec Privacy Act, APPI | | `political_affiliation` | Termini riferiti a un partito politico, movimento o ideologia | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `religion` | Termini che indicano l'affiliazione religiosa | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `routing_number` | Codice di instradamento associato a una banca o istituzione finanziaria | | | `zodiac_sign` | Nomi dei segni zodiacali | | | `product_or_service` | Nomi di prodotti o servizi commerciali | | | `food_or_beverage` | Nomi di alimenti, bevande e piatti | | | `document_reference` | Riferimenti a documenti, numeri di caso o identificatori di file | | | `generic_id` | Identificatori generici che non rientrano in altre categorie di ID | | | `measurement` | Misurazioni fisiche e quantità con unità di misura | | | `time_duration` | Espressioni che indicano una durata o un intervallo di tempo | | #### Linguaggio offensivo | Etichetta | Descrizione | Conformità normativa | | ------------------------- | ------------------------------------------------ | -------------------- | | `very_offensive_language` | Linguaggio fortemente offensivo, inclusi insulti | | | `less_offensive_language` | Linguaggio lievemente offensivo o inappropriato | | ## Oscuramento delle entità Oltre a rilevare le entità, puoi oscurarle nel testo della trascrizione con il parametro `entity_redaction`. Accetta lo stesso formato di `entity_detection`: `all`, una parola chiave di categoria o un elenco di tipi di entità specifici. I tipi da oscurare devono essere un sottoinsieme di quelli rilevati. Quando l'oscuramento è abilitato, il testo dell'entità corrispondente viene sostituito con un marcatore sia nel testo della trascrizione sia nell'output a livello di parola, e il campo `entities` non viene restituito nella risposta. ```python transcription = elevenlabs.speech_to_text.convert( file=audio_file, model_id="scribe_v2", entity_detection=["pii"], entity_redaction=["pii"], entity_redaction_mode="enumerated_entity_type", ) print(transcription.text) # "Hi {NAME_0}, your card ending in {CREDIT_CARD_0} was declined." ``` ```typescript const transcription = await elevenlabs.speechToText.convert({ file: audioBlob, modelId: "scribe_v2", entityDetection: ["pii"], entityRedaction: ["pii"], entityRedactionMode: "enumerated_entity_type", }); console.log(transcription.text); // "Hi {NAME_0}, your card ending in {CREDIT_CARD_0} was declined." ``` Il parametro `entity_redaction_mode` controlla il formato del marcatore: | Modalità | Marcatore | Esempio | | ------------------------ | ------------------------------------------------ | ----------------------------- | | `redacted` | `{REDACTED}` per ogni entità | `Ciao {REDACTED}` | | `entity_type` | Il tipo di entità tra parentesi graffe | `Ciao {NAME}` | | `enumerated_entity_type` | Il tipo di entità più un contatore di occorrenze | `Ciao {NAME_0}` (predefinito) | > **Warning** > > Il rilevamento e l'oscuramento delle entità non sono supportati con lo stile di output multicanale `combined`. ## Passaggi successivi #### [Riferimento API](/docs/it/api-reference/speech-to-text) Riferimento e parametri completi dell'API Speech to Text. #### [Trascrizione multicanale](/docs/it/eleven-api/guides/how-to/speech-to-text/batch/multichannel-transcription) Trascrivi audio multicanale con attribuzione dell'interlocutore per canale.