Estensione linguaggio naturale Google Cloud

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

Versione 2.0.2

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 su una scala da positivo a negativo.

Questi contenuti forniscono un riferimento per la configurazione e l'utilizzo di questa estensione. Per i passaggi per configurare 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à dell'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 classificare i contenuti e un punteggio di affidabilità.

sentenceSentiment

Analizza il testo fornito 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à dell'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). Per il documento e 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à Magnitude che indica l'intensità complessiva dell'emozione (sia positiva che negativa) all'interno dei contenuti, con valori compresi tra 0,0 e +infinito.

entitySentiment

Analizza il testo specificato per determinare il sentiment (positivo o negativo) espresso su 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 ciascuna menzione di una particolare entità. I punteggi vengono quindi aggregati in un punteggio di sentiment e una grandezza complessivi 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. Per il documento e 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à, con valori compresi tra 0,0 e +infinito.

Riferimento alla configurazione

Utilizza quanto segue quando configuri ed esegui il deployment di questa estensione per l'utilizzo 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à di 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, questo è il contenuto del file della chiave dell'account di servizio. Se inviato utilizzando l'API Management, è un valore codificato in base64 generato dal file delle chiavi del service account. Nessuno. Sì.