Bot Framework middleware component for the Google Cloud Natural Language service, including sentiment analysis, language detection, entity extraction, and keyword recognition.
npm install @botbuildercommunity/middleware-google-languageThe Google Cloud Platform Natural Language API Middleware offers Bot Framework middleware components for the Google Cloud Platform Natural Language API. You will need an Google Cloud account.
npm install @botbuildercommunity/middleware-google-language --save
This package assumes that you have a Google Cloud Platform account. Your Google Cloud key needs to be stored on the filesystem (it's in a JSON file), and a GOOGLE_APPLICATION_CREDENTIALS environment variable should point to that file. See Google's quickstart guide for more information.
All middleware is created and used in the same way. For example, for sentiment analysis, import the SentimentAnalysis class from the package, and add it to your bot adapter:
``typescript
import { SentimentAnalysis } from '@botbuildercommunity/middleware-google-cloud';
adapter.use(new SentimentAnalysis());
`
When used, the turnState on the TurnContext will have a property named sentimentScore between 0 and 1. A full example can be seen in the sample bot test file.
Supported middleware classes include:
* SentimentAnalysisCategoryExtraction
* EntityExtraction
*
In each case, properties are added to the turnState of the TurnContext. You can retrieve them in your bot via:
* context.turnState.get('sentimentScore') //This is a number for SentimentAnalysiscontext.turnState.get('categoryEntities')
* //This is an array of object containing a name property and a confidence property for CategoryExtractioncontext.turnState.get('textEntities')
* //This is an array of strings for EntityExtraction
> Note that the CategoryExtraction` middleware component might not return any values if the text is too little, or if the classification cannot find a match.