Estensione linguaggio naturale Google Cloud

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

Versione 1.4.1

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

Utilizza questa estensione per classificare i contenuti applicando categorie, nonché per analizzare il sentiment dei contenuti da una scala da positiva a negativa.

Questi contenuti forniscono riferimento per la configurazione e l'utilizzo di questa estensione. Per i passaggi per configurare un'estensione utilizzando la console Apigee, consulta Aggiungere e configurare un'estensione.

Azioni

classifyContent

Analizza una porzione di testo e restituisce un elenco di categorie di contenuti che si applicano al testo.

Per ulteriori informazioni su questa funzionalità nell'API Natural Language, consulta le sezioni Classificazione dei contenuti e Categorie di contenuti.

Parametri richiesta

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

Risposta

Un array Categories in cui ogni elemento contiene una categoria per classificare i 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 uno scrittore come positivo, negativo o neutro.

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

Parametri richiesta

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

Risposta

Un oggetto che contiene i punteggi di sentiment per il documento complessivo e 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 del contenuto su una scala compresa tra 1 e -1, da positivo (numero positivo) a negativo (numero negativo).
  • Una proprietà di grandezza che indica la forza complessiva dell'emozione (sia positiva che negativa) all'interno del contenuto, compresa tra 0,0 e +inf.

entitySentiment

Analizza il testo specificato per determinare il sentiment (positivo o negativo) espresso su ogni entità all'interno del testo. Il sentiment dell'entità è rappresentato da punteggi numerici e valori di grandezza ed è determinato per ogni menzione di un'entità. Questi punteggi vengono poi aggregati in un punteggio di sentiment complessivo e grandezza per un'entità.

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

Parametri richiesta

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

Risposta

Un array di oggetti contenenti punteggi di sentiment per 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à di grandezza che indica la forza dell'emozione (sia positiva che negativa) per l'entità, compresa tra 0,0 e + inf.

Riferimento per la configurazione

Utilizza quanto segue durante la configurazione e il deployment di questa estensione per l'utilizzo nei proxy API.

Proprietà delle estensioni comuni

Per ogni estensione sono presenti le seguenti proprietà.

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

Proprietà per questo pacchetto di estensioni

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

Proprietà Descrizione Predefinito Obbligatorie
credenziali Una volta inseriti nella console Apigee Edge, questi saranno i contenuti del file della chiave dell'account di servizio. Quando viene inviato tramite l'API di gestione, si tratta di un valore con codifica Base64 generato dal file della chiave dell'account di servizio. Nessuna. Sì.