Panoramica
Puoi utilizzare la funzionalità di adattamento del modello per aiutare Speech-to-Text a riconoscere parole o frasi specifiche più spesso rispetto ad altre opzioni che altrimenti potrebbero essere suggerite. Ad esempio, supponiamo che i tuoi dati audio includano spesso la parola "meteo". Quando Speech-to-Text rileva la parola "tempo", vuoi che la trascriva come "tempo" più spesso di "tempi". In questo caso, potresti utilizzare l'adattamento del modello per indirizzare Speech-to-Text a riconoscere "weather".
L'adattamento del modello è particolarmente utile nei seguenti casi d'uso:
Migliorare l'accuratezza di parole e frasi che si verificano frequentemente nei dati audio. Ad esempio, puoi avvisare il modello di riconoscimento dei comandi vocali che vengono in genere pronunciati dagli utenti.
Espandere il vocabolario di parole riconosciute da Speech-to-Text. Speech-to-Text include un vocabolario molto ampio. Tuttavia, se i tuoi dati audio contengono spesso parole rare nell'uso generale della lingua (come nomi propri o parole specifiche del dominio), puoi aggiungerle utilizzando l'adattamento del modello.
Migliorare l'accuratezza della trascrizione vocale quando l'audio fornito contiene rumore o non è molto chiaro.
Se vuoi, puoi ottimizzare la distorsione del modello di riconoscimento utilizzando la funzionalità di potenziamento dell'adattamento del modello.
Migliorare il riconoscimento di parole e frasi
Per aumentare la probabilità che la funzionalità di Speech-to-Text riconosca la parola "meteo" durante la trascrizione dei dati audio, puoi trasmettere la singola parola "meteo" nell'oggetto PhraseSet in una risorsa SpeechAdaptation.
Quando fornisci una frase composta da più parole, Speech-to-Text ha maggiori probabilità di riconoscere le parole in sequenza. Fornire una frase aumenta anche la probabilità di riconoscere parti della frase, incluse singole parole. Consulta la pagina Limiti dei contenuti per i limiti relativi al numero e alle dimensioni di queste frasi.
Migliorare il riconoscimento utilizzando le classi
Le classi rappresentano concetti comuni che si verificano nel linguaggio naturale, come unità monetarie e date del calendario. Una classe ti aiuta a migliorare l'accuratezza della trascrizione per grandi gruppi di parole che corrispondono a un concetto comune, ma che non includono sempre parole o frasi identiche.
Ad esempio, supponiamo che i tuoi dati audio includano registrazioni di persone che dicono
il loro indirizzo. Potresti avere una registrazione audio di qualcuno che dice: "La mia
casa è al civico 123 di Main Street, la quarta casa a sinistra". In questo caso, vuoi che
la funzionalità Speech-to-Text riconosca la prima sequenza di numeri ("123") come
indirizzo anziché come numero ordinale ("centoventitreesimo"). Tuttavia, non tutte le persone vivono al numero 123 di Main Street. È poco pratico elencare ogni possibile indirizzo
in una risorsa PhraseSet. Puoi invece utilizzare una classe per indicare che
un numero civico deve essere riconosciuto indipendentemente dal numero effettivo. In
questo esempio, Speech-to-Text potrebbe trascrivere con maggiore precisione
frasi come "123 Main Street" e "987 Grand Boulevard" perché entrambi
vengono riconosciuti come numeri di indirizzo.
Token di classe
Per utilizzare una classe nell'adattamento del modello, includi un token di classe nel campo phrases
di una risorsa PhraseSet. Consulta l'elenco dei token di classe supportati per vedere quali sono disponibili nella tua lingua. Ad esempio, per migliorare la trascrizione dei numeri civici dall'audio sorgente, fornisci il valore $ADDRESSNUM all'interno di una frase in un PhraseSet.
Puoi utilizzare le classi come elementi autonomi nell'array phrases o incorporare uno o più token di classe in frasi più lunghe composte da più parole. Ad esempio, puoi indicare un
numero di indirizzo in una frase più lunga includendo il token di classe in una stringa:
["my address is $ADDRESSNUM"]. Tuttavia, questa frase non sarà utile nei casi in cui l'audio contiene una frase simile ma non identica, ad esempio "Mi trovo in
via Principale 123". Per facilitare il riconoscimento di frasi simili, è importante
includere anche il token di classe da solo: ["my address is $ADDRESSNUM",
"$ADDRESSNUM"]. Se utilizzi un token di classe non valido o malformato,
Speech-to-Text ignora il token senza attivare un errore, ma utilizza comunque
il resto della frase per il contesto.
Classi personalizzate
Puoi anche creare un CustomClass, una classe composta dal tuo elenco personalizzato di elementi o valori correlati. Ad esempio, vuoi trascrivere dati audio
che probabilmente includono il nome di uno dei centinaia di ristoranti
regionali. I nomi dei ristoranti sono relativamente rari nel linguaggio comune e
quindi è meno probabile che vengano scelti come risposta "corretta" dal modello di
riconoscimento. Puoi influenzare il modello di riconoscimento in modo da identificare correttamente questi
nomi quando compaiono nell'audio utilizzando una classe personalizzata.
Per utilizzare una classe personalizzata, crea una risorsa CustomClass
che includa il nome di ogni ristorante come ClassItem. Le classi personalizzate
funzionano allo stesso modo dei token di classe predefiniti.
Un phrase può includere sia token di classe predefiniti sia classi personalizzate.
Perfeziona i risultati della trascrizione utilizzando il boost
Per impostazione predefinita, l'adattamento del modello produce un effetto relativamente limitato, in particolare per le frasi di una sola parola. La funzionalità di miglioramento dell'adattamento del modello consente di aumentare la distorsione del modello di riconoscimento assegnando un peso maggiore ad alcune frasi rispetto ad altre. Ti consigliamo di implementare l'ottimizzazione se si verificano tutte le seguenti condizioni:
- Hai già implementato l'adattamento del modello.
- Vuoi regolare ulteriormente l'intensità degli effetti di adattamento del modello sui risultati della trascrizione. Per verificare se la funzionalità di potenziamento è disponibile nella tua lingua, consulta la pagina delle lingue supportate.
Ad esempio, hai molte registrazioni di persone che chiedono informazioni sulla "tariffa per entrare
alla fiera della contea", con la parola "fiera" che si verifica più frequentemente di
"tariffa". In questo caso, puoi utilizzare l'adattamento del modello per aumentare la probabilità
che il modello riconosca sia "fair" che "fare" aggiungendoli come phrases in una risorsa
PhraseSet. In questo modo, Speech-to-Text riconoscerà "fair" e "fare" più spesso di, ad esempio, "hare" o "lair".
Tuttavia, "fair" dovrebbe essere riconosciuto più spesso di "fare" a causa della sua maggiore frequenza nell'audio. Potresti aver già trascritto l'audio utilizzando l'API Speech-to-Text e aver riscontrato un numero elevato di errori nel riconoscimento della parola corretta ("fiera"). In questo caso, ti consigliamo di utilizzare la funzionalità Incremento per assegnare un valore di incremento più alto a "fair" rispetto a "fare". Il valore ponderato più alto assegnato a "fair" fa sì che l'API Speech-to-Text scelga "fair" più spesso di "fare". Senza valori di boost, il modello di riconoscimento riconoscerà "fair" e "fare" con uguale probabilità.
Nozioni di base sul boost
Quando utilizzi il boost, assegni un valore ponderato agli elementi phrase in una risorsa PhraseSet. Speech-to-Text fa riferimento a questo valore ponderato quando
seleziona una possibile trascrizione per le parole nei dati audio. Maggiore è il
valore, maggiore è la probabilità che Speech-to-Text scelga quella parola o
frase tra le alternative possibili.
Se assegni un valore boost a una frase composta da più parole, il boost viene applicato all'intera frase e solo all'intera frase. Ad esempio, vuoi assegnare un
valore di boost alla frase "La mia mostra preferita all'American Museum of Natural
History è la balenottera azzurra". Se aggiungi questa frase a un oggetto phrase e
assegni un valore di incremento, il modello di riconoscimento avrà maggiori probabilità di riconoscere
la frase nella sua interezza, parola per parola.
Se non ottieni i risultati che cerchi aumentando l'offerta per una frase composta da più parole,
ti consigliamo di aggiungere tutti i bigrammi (2 parole, in ordine) che compongono la frase
come elementi phrase aggiuntivi e assegnare valori di aumento dell'offerta a ciascuno. Continuando con l'esempio precedente, potresti valutare l'aggiunta di bigrammi ed endgrammi aggiuntivi (più di due parole), ad esempio "il mio preferito", "la mia mostra preferita", "mostra preferita", "la mia mostra preferita al Museo americano di storia naturale", "Museo americano di storia naturale" e "balenottera azzurra". Il modello di riconoscimento
STT ha quindi maggiori probabilità di riconoscere frasi correlate nell'audio che
contengono parti della frase potenziata originale, ma non corrispondono parola per parola.
Impostare i valori di boost
I valori di boost devono essere un numero in virgola mobile maggiore di 0. Il limite massimo pratico per i valori di incremento è 20. Per ottenere risultati ottimali, prova a modificare i risultati della trascrizione aumentando o diminuendo i valori di boost finché non ottieni risultati di trascrizione accurati.
Valori di boost più elevati possono comportare un minor numero di falsi negativi, ovvero casi in cui la parola o la frase è presente nell'audio, ma non è stata riconosciuta correttamente dalla funzionalità di Speech-to-Text. Tuttavia, l'incremento può anche aumentare la probabilità di falsi positivi, ovvero casi in cui la parola o la frase appare nella trascrizione anche se non è presente nell'audio.
Esempio di caso d'uso che utilizza l'adattamento del modello
L'esempio seguente illustra la procedura di utilizzo dell'adattamento del modello per trascrivere una registrazione audio di una persona che dice "La parola è tariffa". In questo caso, senza l'adattamento vocale, Speech-to-Text identifica la parola "fiera". Grazie all'adattamento vocale, Speech-to-Text può identificare la parola "tariffa".
Prima di iniziare
- Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Speech-to-Text APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
Make sure that you have the following role or roles on the project: Cloud Speech Administrator
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
- For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
- Click Grant access.
-
In the New principals field, enter your user identifier. This is typically the email address for a Google Account.
- Click Select a role, then search for the role.
- To grant additional roles, click Add another role and add each additional role.
- Click Save.
-
-
Installa Google Cloud CLI.
-
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
-
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Speech-to-Text APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
Make sure that you have the following role or roles on the project: Cloud Speech Administrator
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
- For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
- Click Grant access.
-
In the New principals field, enter your user identifier. This is typically the email address for a Google Account.
- Click Select a role, then search for the role.
- To grant additional roles, click Add another role and add each additional role.
- Click Save.
-
-
Installa Google Cloud CLI.
-
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
-
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init -
Se utilizzi una shell locale, crea le credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Non è necessario eseguire questa operazione se utilizzi Cloud Shell.
Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.
Le librerie client possono utilizzare Credenziali predefinite dell'applicazione per autenticarsi facilmente con le API di Google e inviare richieste a queste API. Con Credenziali predefinite dell'applicazionee, puoi testare l'applicazione localmente ed eseguirne il deployment senza modificare il codice sottostante. Per saperne di più, vedi Autenticati per usare le librerie client.
Assicurati inoltre di aver installato la libreria client.
Migliorare la trascrizione utilizzando un PhraseSet
- Il seguente esempio crea un
PhraseSetcon la frase "tariffa" e lo aggiunge comeinline_phrase_setin una richiesta di riconoscimento:
Python
- Questo esempio crea una risorsa
PhraseSetcon la stessa frase e poi la fa riferimento in una richiesta di riconoscimento:
Python
Migliorare i risultati della trascrizione utilizzando un CustomClass
- L'esempio seguente crea un
CustomClasscon un elemento "tariffa" e il nome "tariffa". Quindi, fa riferimento aCustomClassall'interno di uninline_phrase_setin una richiesta di riconoscimento:
Python
- Questo esempio crea una risorsa
CustomClasscon lo stesso elemento. Poi crea una risorsaPhraseSetcon una frase che fa riferimento al nome della risorsaCustomClass. Fa quindi riferimento alla risorsaPhraseSetin una richiesta di riconoscimento:
Python
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.
-
(Facoltativo) Revoca le credenziali di autenticazione che hai creato ed elimina il file delle credenziali locali.
gcloud auth application-default revoke
-
(Facoltativo) Revoca le credenziali da gcloud CLI.
gcloud auth revoke
Console
gcloud
Elimina un progetto Google Cloud :
gcloud projects delete PROJECT_ID
Passaggi successivi
- Consulta l'elenco dei token di classe supportati.
- Scopri come trascrivere file audio corti.
- Scopri come trascrivere l'audio in streaming.
- Scopri come trascrivere file audio lunghi.