watson_developer_cloud.tone_analyzer_v3 module

The IBM Watson Tone Analyzer Service uses linguistic analysis to detect three types of tones from written text: emotions, social tendencies, and language style. Emotions identified include things like anger, cheerfulness and sadness. Identified social tendencies include things from the Big Five personality traits used by some psychologists. These include openness, conscientiousness, extraversion, agreeableness, and neuroticism. Identified language styles include things like confident, analytical, and tentative. Input email and other written media into the Tone Analyzer service, and use the results to determine if your writing comes across with the tone, personality traits, and writing style that you want for your intended audience.

class ToneAnalyzerV3(version, url=’https://gateway.watsonplatform.net/tone-analyzer/api’, **kwargs)

Bases: watson_developer_cloud.watson_developer_cloud_service.WatsonDeveloperCloudService

Client for the ToneAnalyzer service.

default_url = ‘https://gateway.watsonplatform.net/tone-analyzer/api’

latest_version = ‘2016-05-19’

tone(text, tones=None, sentences=None)

The tone API is the main API call: it analyzes the “tone” of a piece of text. The message is analyzed from several tones (social tone, emotional tone, writing tone), and for each of them various traits are derived (such as conscientiousness, agreeableness, openness). :param text: Text to analyze :param sentences: If “false”, sentence-level analysis is omitted :param tones: Can be one or more of ‘social’, ‘language’, ‘emotion’; comma-separated.

tone_chat(utterances)

Analyze customer engagement tone.

Use the Tone Analyzer for Customer Engagement Endpoint to monitor customer service and customer support conversations.

Parameters:utterances – The content to be analyzed.