Eseguire l'analisi del sentiment utilizzando lo strumento gcloud

Eseguire l'analisi del sentiment utilizzando lo strumento gcloud

Questa pagina mostra come iniziare a utilizzare l'API Cloud Natural Language utilizzando Google Cloud SDK.

---

Per indicazioni dettagliate su questa attività direttamente in Google Cloud Console, fai clic su Guida:

Procedura guidata

---

Nelle sezioni seguenti puoi seguire la stessa procedura utilizzata per fare clic su Procedura guidata.

Prima di iniziare

1. 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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.

   Nota: se non hai intenzione di conservare le risorse che crei in questa procedura, crea un progetto anziché selezionarne uno esistente. Al termine di questi passaggi, puoi eliminare il progetto rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.

4. Attiva l'API Cloud Natural Language.

   Abilita l'API

5. Crea un account di servizio:

   1. In Cloud Console, vai alla pagina Crea account di servizio.

      Vai a Crea account di servizio
   2. Seleziona il progetto.

   3. Inserisci un nome nel campo Nome account di servizio. Cloud Console compila il campo ID account di servizio in base a questo nome.

      Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

   4. Fai clic su Crea e continua.

   5. Fai clic su Fine per completare la creazione dell'account di servizio.

      Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.

6. Crea una chiave dell'account di servizio:

   1. In Cloud Console, fai clic sull'indirizzo email dell'account di servizio che hai creato.
   2. Fai clic su Chiavi.
   3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
   4. Fai clic su Crea. Il file di una chiave JSON viene scaricato sul computer.
   5. Fai clic su Chiudi.

7. Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file JSON che contiene la chiave dell'account di servizio. Questa variabile si applica solo alla sessione shell corrente, quindi se apri una nuova sessione, impostala di nuovo.

   Esempio: Linux o macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Sostituisci KEY_PATH con il percorso del file JSON che contiene la chiave dell'account di servizio.

   Ad esempio:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Esempio: Windows

   Per PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Sostituisci KEY_PATH con il percorso del file JSON che contiene la chiave dell'account di servizio.

   Ad esempio:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Per il prompt dei comandi:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Sostituisci KEY_PATH con il percorso del file JSON che contiene la chiave dell'account di servizio.

8. Installa e inizializza l'interfaccia a riga di comando di Google Cloud.

9. Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.

   Nota: se non hai intenzione di conservare le risorse che crei in questa procedura, crea un progetto anziché selezionarne uno esistente. Al termine di questi passaggi, puoi eliminare il progetto rimuovendo tutte le risorse associate.

   Vai al selettore progetti

10. Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.

11. Attiva l'API Cloud Natural Language.

    Abilita l'API

12. Crea un account di servizio:

    1. In Cloud Console, vai alla pagina Crea account di servizio.

       Vai a Crea account di servizio
    2. Seleziona il progetto.

    3. Inserisci un nome nel campo Nome account di servizio. Cloud Console compila il campo ID account di servizio in base a questo nome.

       Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

    4. Fai clic su Crea e continua.

    5. Fai clic su Fine per completare la creazione dell'account di servizio.

       Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.

13. Crea una chiave dell'account di servizio:

    1. In Cloud Console, fai clic sull'indirizzo email dell'account di servizio che hai creato.
    2. Fai clic su Chiavi.
    3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
    4. Fai clic su Crea. Il file di una chiave JSON viene scaricato sul computer.
    5. Fai clic su Chiudi.

14. Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file JSON che contiene la chiave dell'account di servizio. Questa variabile si applica solo alla sessione shell corrente, quindi se apri una nuova sessione, impostala di nuovo.

    Esempio: Linux o macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Sostituisci KEY_PATH con il percorso del file JSON che contiene la chiave dell'account di servizio.

    Ad esempio:

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Esempio: Windows

    Per PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Sostituisci KEY_PATH con il percorso del file JSON che contiene la chiave dell'account di servizio.

    Ad esempio:

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    Per il prompt dei comandi:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Sostituisci KEY_PATH con il percorso del file JSON che contiene la chiave dell'account di servizio.

15. Installa e inizializza l'interfaccia a riga di comando di Google Cloud.

Invia una richiesta di analisi delle entità

gcloud

Usa lo strumento a riga di comando gcloud per chiamare il comando analyze-entities e usare il flag --content per specificare il testo da analizzare.

gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'."

Riga di comando

Utilizza curl per effettuare una richiesta POST al metodo documents:analyzeEntities e fornire il corpo della richiesta appropriato, come mostrato nell'esempio seguente.

L'esempio utilizza il comando gcloud auth application-default print-access-token per ottenere un token di accesso per l'account di servizio creato durante la configurazione del progetto.

curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
 "https://language.googleapis.com/v1/documents:analyzeEntities" \
  --data "{
  'document':{
    'type':'PLAIN_TEXT',
    'content':'Michelangelo Caravaggio, Italian painter, is known for
              \'The Calling of Saint Matthew\'.'
  },
  'encodingType':'UTF8'
}"

Dovresti vedere una risposta simile alla seguente:

{
  "entities": [
    {
      "name": "Michelangelo Caravaggio",
      "type": "PERSON",
      "metadata": {
        "wikipedia_url": "http://en.wikipedia.org/wiki/Caravaggio",
        "mid": "/m/020bg"
      },
      "salience": 0.83047235,
      "mentions": [
        {
          "text": {
            "content": "Michelangelo Caravaggio",
            "beginOffset": 0
          },
          "type": "PROPER"
        },
        {
          "text": {
            "content": "painter",
            "beginOffset": 33
          },
          "type": "COMMON"
        }
      ]
    },
    {
      "name": "Italian",
      "type": "LOCATION",
      "metadata": {
        "mid": "/m/03rjj",
        "wikipedia_url": "http://en.wikipedia.org/wiki/Italy"
      },
      "salience": 0.13870546,
      "mentions": [
        {
          "text": {
            "content": "Italian",
            "beginOffset": 25
          },
          "type": "PROPER"
        }
      ]
    },
    {
      "name": "The Calling of Saint Matthew",
      "type": "EVENT",
      "metadata": {
        "mid": "/m/085_p7",
        "wikipedia_url": "http://en.wikipedia.org/wiki/The_Calling_of_St_Matthew_(Caravaggio)"
      },
      "salience": 0.030822212,
      "mentions": [
        {
          "text": {
            "content": "The Calling of Saint Matthew",
            "beginOffset": 69
          },
          "type": "PROPER"
        }
      ]
    }
  ],
  "language": "en"
}

Puoi anche analizzare il sentiment dei documenti ed estrarre le annotazioni di sintassi dai testi inviando richieste a diversi endpoint dell'API Cloud Natural Language. Per ulteriori dettagli, consulta la pagina Nozioni di base sull'API Cloud Natural Language.

Esegui la pulizia

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per questo tutorial, quando lo elimini elimini anche qualsiasi altro lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se prevedi di esplorare più tutorial e guide rapide, il riutilizzo dei progetti può aiutarti a evitare di superare i limiti di quota del progetto.

1. In Cloud Console, vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto da eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Inizia a utilizzare l'API Natural Language nella lingua di tua scelta utilizzando una Libreria client di Cloud Natural Language.

• Consulta le Nozioni di base su Natural Language per informazioni concettuali sulla formulazione di richieste API Natural Language e sulla gestione delle risposte.

• Prova il Tutorial sull'analisi del sentiment e sfoglia le Applicazioni di esempio.