Estensione linguaggio naturale Google Cloud

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
info

Versione 2.0.0

Fornisce l'accesso all'API Google Cloud Natural Language.

Utilizza questa estensione per classificare i contenuti applicando categorie, nonché per analizzare il loro sentiment su una scala da positivo a negativo.

Questi contenuti forniscono un riferimento per la configurazione e l'utilizzo di questa estensione. Per la procedura di configurazione di un'estensione utilizzando la console Apigee, vedi Aggiunta e configurazione di un'estensione.

Azioni

classifyContent

Analizza una parte di testo e restituisce un elenco di categorie di contenuti applicabili al testo.

Per saperne di più su questa funzionalità nell'API Natural Language, consulta Classificazione dei contenuti e Categorie di contenuti.

Parametri di richiesta

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Parametro Descrizione Tipo Predefinito Obbligatorio
dati I contenuti da analizzare. Stringa Nessuno. Sì.

Risposta

Un array Categories in cui ogni elemento contiene una categoria per la classificazione dei contenuti e un punteggio di affidabilità.

sentenceSentiment

Analizza il testo specificato e identifica l'opinione emotiva prevalente al suo interno, soprattutto per determinare l'atteggiamento di un autore come positivo, negativo o neutro.

Per saperne di più su questa funzionalità nell'API Natural Language, consulta Analisi del sentiment e Nozioni di base sull'API Natural Language.

Parametri di richiesta

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Parametro Descrizione Tipo Predefinito Obbligatorio
dati I contenuti da analizzare. Stringa Nessuno. Sì.

Risposta

Un oggetto contenente i punteggi di sentiment per il documento nel suo complesso e per ciascuna delle sue frasi (in un array). Sia per il documento che per le relative frasi, sono incluse le seguenti proprietà:

  • Una proprietà Content con i contenuti analizzati.
  • Una proprietà Score che indica il sentiment dei contenuti su una scala compresa tra 1 e -1, da positivo (numero positivo) a negativo (numero negativo).
  • Una proprietà Magnitude che indica l'intensità complessiva dell'emozione (sia positiva che negativa) all'interno dei contenuti, compresa tra 0,0 e +infinito.

entitySentiment

Analizza il testo specificato per determinare il sentiment (positivo o negativo) espresso in merito a ogni entità all'interno del testo. Il sentiment per un'entità, formato da un punteggio numerico e da un valore di grandezza, viene determinato per ogni menzione di un'entità. I punteggi vengono quindi aggregati in un punteggio di sentiment complessivo e in una grandezza per un'entità.

Per saperne di più sull'analisi delle entità nell'API Google Cloud Natural Language, consulta Analisi del sentiment delle entità e Interpretazione dei valori dell'analisi del sentiment.

Parametri di richiesta

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Parametro Descrizione Tipo Predefinito Obbligatorio
dati I contenuti da analizzare. Stringa Nessuno. Sì.

Risposta

Un array di oggetti contenenti i punteggi di sentiment per le entità nel testo. Sia per il documento che per le relative frasi, sono incluse le seguenti proprietà:

  • Una proprietà Name con .
  • Una proprietà Type che descrive il tipo di entità.
  • Una proprietà Score che indica il sentiment dell'entità su una scala compresa tra 1 e -1, da positivo (numero positivo) a negativo (numero negativo).
  • Una proprietà Magnitude che indica l'intensità dell'emozione (sia positiva che negativa) per l'entità, compresa tra 0,0 e +infinito.

Riferimento alla configurazione

Utilizza quanto segue quando configuri ed esegui il deployment di questa estensione per utilizzarla nei proxy API.

Proprietà comuni delle estensioni

Per ogni estensione sono presenti le seguenti proprietà.

Proprietà Descrizione Predefinito Obbligatorio
name Il nome che assegni a questa configurazione dell'estensione. Nessuno
packageName Nome del pacchetto dell'estensione fornito da Apigee Edge. Nessuno
version Numero di versione del pacchetto dell'estensione da cui stai configurando un'estensione. Nessuno
configuration Valore di configurazione specifico per l'estensione che stai aggiungendo. Vedi Proprietà per questo pacchetto di estensioni Nessuno

Proprietà per questo pacchetto di estensioni

Specifica i valori per le seguenti proprietà di configurazione specifiche di questa estensione.

Proprietà Descrizione Predefinito Obbligatorio
credenziali Se inserito nella console Apigee Edge, si tratta dei contenuti del file della chiave dell'account di servizio. Se inviato tramite l'API di gestione, è un valore codificato in base64 generato dal file della chiave dell'account di servizio. Nessuno. Sì.