Tutorial sull'analisi del sentiment

Pubblico

Questo tutorial è progettato per consentirti di iniziare rapidamente a esplorare e sviluppare applicazioni con l'API Google Cloud Natural Language. È pensato per persone che hanno familiarità con la programmazione di base, ma anche senza molte conoscenze di programmazione, dovresti essere in grado di seguire. Dopo aver seguito questo tutorial, dovresti essere in grado di utilizzare la documentazione di riferimento per creare le tue applicazioni di base.

Questo tutorial illustra un'applicazione API Natural Language utilizzando il codice Python. Lo scopo non è spiegare le librerie client Python, ma come effettuare chiamate all'API Natural Language. Le applicazioni in Java e Node.js sono essenzialmente simili. Consulta gli esempi dell'API Natural Language per esempi in altre lingue (incluso questo esempio all'interno del tutorial).

Prerequisiti

Questo tutorial prevede diversi prerequisiti:

• Hai un account Google Cloud . Se non conosci la piattaforma, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
• Hai configurato un progetto API Cloud Natural Language nella console Google Cloud .
• Hai configurato il tuo ambiente utilizzando le Credenziali predefinite dell'applicazione.
• Hai una conoscenza di base della programmazione in Python.
• Hai configurato l'ambiente di sviluppo Python. Ti consigliamo di installare sul sistema l'ultima versione di Python, pip e virtualenv. Per le istruzioni, consulta la Guida alla configurazione dell'ambiente di sviluppo Python per Google Cloud Platform.
• Hai installato la libreria client Google Cloud per Python.

Analisi del sentiment del documento

Questo tutorial illustra un'applicazione API Natural Language di base, utilizzando una richiesta analyzeSentiment, che esegue l'analisi del sentiment sul testo. L'analisi del sentiment tenta di determinare l'atteggiamento generale (positivo o negativo) ed è rappresentata da valori numerici score e magnitude. Per ulteriori informazioni su questi concetti, consulta Nozioni di base su Natural Language.

Mostreremo prima l'intero codice. Tieni presente che abbiamo rimosso la maggior parte dei commenti da questo codice per mostrarti quanto è breve. Forniremo altri commenti mentre esaminiamo il codice.

Nota :per copiare il codice negli appunti, fai clic sul widget di copia visualizzato in alto a destra dello snippet di codice quando passi il mouse sopra lo snippet. Copia questo codice in un file sentiment_analysis.py all'interno della directory di sviluppo.

Per ulteriori informazioni sull'installazione e l'utilizzo della libreria client di Google Cloud Natural Language per Python, consulta Librerie client dell'API Natural Language.

"""Demonstrates how to make a simple call to the Natural Language API."""

import argparse

from google.cloud import language_v1



def print_result(annotations):
    score = annotations.document_sentiment.score
    magnitude = annotations.document_sentiment.magnitude

    for index, sentence in enumerate(annotations.sentences):
        sentence_sentiment = sentence.sentiment.score
        print(f"Sentence {index} has a sentiment score of {sentence_sentiment}")

    print(f"Overall Sentiment: score of {score} with magnitude of {magnitude}")
    return 0




def analyze(movie_review_filename):
    """Run a sentiment analysis request on text within a passed filename."""
    client = language_v1.LanguageServiceClient()

    with open(movie_review_filename) as review_file:
        # Instantiates a plain text document.
        content = review_file.read()

    document = language_v1.Document(
        content=content, type_=language_v1.Document.Type.PLAIN_TEXT
    )
    annotations = client.analyze_sentiment(request={"document": document})

    # Print the results
    print_result(annotations)




if __name__ == "__main__":
    parser = argparse.ArgumentParser(
        description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter
    )
    parser.add_argument(
        "movie_review_filename",
        help="The filename of the movie review you'd like to analyze.",
    )
    args = parser.parse_args()

    analyze(args.movie_review_filename)

Questa semplice applicazione esegue le seguenti attività:

• Importa le librerie necessarie per eseguire l'applicazione
• Prende un file di testo e lo passa alla funzione main()
• Legge il file di testo ed effettua una richiesta al servizio
• Analizza la risposta del servizio e la mostra all'utente

Esamineremo questi passaggi in modo più dettagliato di seguito.

Importazione di librerie

Per ulteriori informazioni sull'installazione e l'utilizzo della libreria client di Google Cloud Natural Language per Python, consulta Librerie client dell'API Natural Language.

import argparse

from google.cloud import language_v1

Importiamo argparse, una libreria standard, per consentire all'applicazione di accettare i nomi dei file di input come argomenti.

Per utilizzare l'API Cloud Natural Language, dovremo anche importare il modulo language dalla libreria google-cloud-language. Il modulo types contiene le classi necessarie per creare le richieste.

Esecuzione dell'applicazione

if __name__ == "__main__":
    parser = argparse.ArgumentParser(
        description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter
    )
    parser.add_argument(
        "movie_review_filename",
        help="The filename of the movie review you'd like to analyze.",
    )
    args = parser.parse_args()

    analyze(args.movie_review_filename)

Qui analizziamo semplicemente l'argomento passato per il nome file di testo e lo passiamo alla funzione analyze().

Autenticazione nell'API

Prima di comunicare con il servizio API Natural Language, devi autenticare il servizio utilizzando le credenziali acquisite in precedenza. All'interno di un'applicazione, il modo più semplice per ottenere le credenziali è utilizzare le Credenziali predefinite dell'applicazione (ADC). Per impostazione predefinita, ADC tenterà di ottenere le credenziali dal file di ambiente GOOGLE_APPLICATION_CREDENTIALS, che deve essere impostato in modo da puntare al file della chiave JSON dell'account di servizio. Dovresti aver configurato l'account di servizio e l'ambiente per utilizzare ADC nella guida rapida. Per maggiori informazioni, vedi Configurazione di un service account.

La libreria client Google Cloud per Python utilizza automaticamente le credenziali predefinite dell'applicazione.

Effettuare la richiesta

Ora che il nostro servizio API Natural Language è pronto, possiamo accedervi chiamando il metodo analyze_sentiment dell'istanza LanguageServiceClient.

La libreria client incapsula i dettagli per le richieste e le risposte all'API. Consulta la documentazione di riferimento dell'API Natural Language per informazioni complete sulla struttura specifica di una richiesta di questo tipo.

Per ulteriori informazioni sull'installazione e l'utilizzo della libreria client di Google Cloud Natural Language per Python, consulta Librerie client dell'API Natural Language.

def analyze(movie_review_filename):
    """Run a sentiment analysis request on text within a passed filename."""
    client = language_v1.LanguageServiceClient()

    with open(movie_review_filename) as review_file:
        # Instantiates a plain text document.
        content = review_file.read()

    document = language_v1.Document(
        content=content, type_=language_v1.Document.Type.PLAIN_TEXT
    )
    annotations = client.analyze_sentiment(request={"document": document})

    # Print the results
    print_result(annotations)

Questo snippet di codice esegue le seguenti attività:

1. Crea un'istanza di LanguageServiceClient come client.
2. Legge il nome del file contenente i dati di testo in una variabile.
3. Crea un'istanza di un oggetto Document con i contenuti del file.
4. Chiama il metodo analyze_sentiment del client.

Analisi della risposta

def print_result(annotations):
    score = annotations.document_sentiment.score
    magnitude = annotations.document_sentiment.magnitude

    for index, sentence in enumerate(annotations.sentences):
        sentence_sentiment = sentence.sentiment.score
        print(f"Sentence {index} has a sentiment score of {sentence_sentiment}")

    print(f"Overall Sentiment: score of {score} with magnitude of {magnitude}")
    return 0

Analizziamo la risposta per estrarre i valori del sentiment score per ogni frase e i valori complessivi di score e magnitude per l'intera recensione e li mostriamo all'utente.

Esegui il campione

Per eseguire il nostro esempio, lo testeremo su un insieme di recensioni cinematografiche (false) per il film "Blade Runner".

1. Scarica i campioni da Google Cloud Storage:

   gcloud storage cp gs://cloud-samples-tests/natural-language/sentiment-samples.tgz .
   

   Per installare l'ultima versione di Google Cloud CLI, consulta la documentazione di gcloud CLI.

2. Decomprimi questi campioni, che creeranno una cartella "reviews":

   gunzip sentiment-samples.tgz
   tar -xvf sentiment-samples.tar
   

3. Esegui la nostra analisi del sentiment su uno dei file specificati:

   python sentiment_analysis.py reviews/bladerunner-pos.txt
   Sentence 0 has a sentiment score of 0.8
   Sentence 1 has a sentiment score of 0.9
   Sentence 2 has a sentiment score of 0.8
   Sentence 3 has a sentiment score of 0.2
   Sentence 4 has a sentiment score of 0.1
   Sentence 5 has a sentiment score of 0.4
   Sentence 6 has a sentiment score of 0.3
   Sentence 7 has a sentiment score of 0.4
   Sentence 8 has a sentiment score of 0.2
   Sentence 9 has a sentiment score of 0.9
   Overall Sentiment: score of 0.5 with magnitude of 5.5
   

L'esempio precedente indica una recensione relativamente positiva (punteggio di 0.5) e relativamente emotiva (magnitudo di 5.5).

L'analisi degli altri esempi dovrebbe produrre valori simili a quelli mostrati di seguito:

python sentiment_analysis.py reviews/bladerunner-neg.txt
...
Overall Sentiment: score of -0.6 with magnitude of 3.3

python sentiment_analysis.py reviews/bladerunner-mixed.txt
...
Overall Sentiment: score of 0 with magnitude of 4.7

python sentiment_analysis.py reviews/bladerunner-neutral.txt
...
Overall Sentiment: score of -0.1 with magnitude of 1.8

Tieni presente che le magnitudo sono tutte simili (a indicare una quantità relativamente uguale di sentiment emotivamente significativo), ad eccezione del caso "neutro", che indica una recensione con un sentiment emotivo non molto forte, né positivo né negativo. Per ulteriori informazioni sui punteggi di sentiment e sulla magnitudo, nonché su come interpretare questi valori, consulta Interpretazione dei valori dell'analisi del sentiment.

Se vuoi esplorare l'analisi del sentiment con più dati, Stanford fornisce un set di dati di recensioni di film di IMDB. Per recuperare queste recensioni di film:

1. Scarica il set di dati Large Movie Review.
2. Decomprimi il file nella directory di lavoro. Le recensioni dei film sono suddivise nelle directory pos e neg all'interno delle directory di dati train e test, con ogni file di testo contenente una recensione di un film.
3. Esegui lo strumento sentiment_analysis.py su uno qualsiasi dei file di testo delle recensioni cinematografiche.

Complimenti! Hai eseguito le tue prime attività di inferenza utilizzando l'API Google Cloud Natural Language.