Estensione linguaggio naturale Google Cloud

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

Versione 1.2.0

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

Utilizza questa estensione per classificare i contenuti applicando categorie e per analizzare il sentiment dei contenuti in 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 Aggiungere e configurare un'estensione.

Azioni

classifyContent

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

Per ulteriori informazioni 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 confidenza.

sentenceSentiment

Analizza il testo dato e identifica l'opinione emotiva prevalente al suo interno, soprattutto per determinare l'atteggiamento di uno scrittore 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 punteggi di sentiment per il documento nel complesso e per ciascuna delle sue frasi (in un array). Sia per il documento che per le sue frasi sono incluse le seguenti proprietà:

  • Una proprietà Contenuti 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 la forza complessiva dell'emozione (sia positiva che negativa) all'interno dei contenuti, compresa tra 0,0 e +inf.

entitySentiment

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

Per saperne di più sull'analisi delle entità nell'API Google Cloud Natural Language, vedi Analisi del sentiment dell'entità e Interpretazione dei valori di 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 punteggi di sentiment per le entità nel testo. Sia per il documento che per le sue 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 la forza dell'emozione (sia positiva che negativa) per l'entità, compresa tra 0,0 e +inf.

Riferimento alla configurazione

Quando configuri questa estensione e ne esegui il deployment da usare nei proxy API, usa quanto segue.

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 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 per questa estensione.

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