Rilevamento delle entità
Questa guida mostra come usare il rilevamento delle entità con l’API Speech to Text.
Guida pratica · Presuppone che tu abbia completato il quickstart di Speech to Text .
Panoramica
Il rilevamento delle entità è una funzionalità che ti consente di identificare parole e frasi specifiche nella trascrizione, fornendo i relativi 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 specifici tipi di entità nella trascrizione e ne fornisce i timestamp esatti.
Ad esempio, il seguente audio:
Produce la seguente trascrizione quando specifichiamo "pii" (informazioni di identificazione personale) come tipo di entità:
Il risultato mostra le entità PII rilevate nella trascrizione, con i relativi timestamp esatti.
Integrare il rilevamento delle entità
Il rilevamento delle entità si integra nell’API Speech to Text passando il parametro entity_detection al metodo convert.
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)
PHI (Informazioni sanitarie protette)
PCI (Settore delle carte di pagamento)
Altre entità
Linguaggio offensivo
Redazione delle entità
Oltre a rilevare le entità, puoi rimuoverle dal 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 rimossi devono essere un sottoinsieme
dei tipi rilevati.
Quando la redazione è attivata, 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.
Il parametro entity_redaction_mode controlla il formato del marcatore:
Il rilevamento e la redazione delle entità non sono supportati con lo stile di output multicanale combined.
La redazione delle entità funziona anche con Scribe v2 Realtime: passa entity_redaction e
entity_redaction_mode come parametri di query, nello stesso formato indicato sopra. A ogni trascrizione confermata
segue quindi un evento redacted_transcript che contiene il text originale e il
redacted_text. Consulta il riferimento degli eventi in
tempo reale.