AWS Comprehend

USER GUIDE
Version: 6.4
Document Revision: 1.0

For more information please contact:

info@blueprism.com | UK: +44 (0) 870 879 3000 | US: +1 888 757 7476
www.blueprism.com
Contents
Introduction..........................................................................................................................................................................3
Solution Overview and Configuration .................................................................................................................................3
Limitations ........................................................................................................................................................................3
Pre-Requisites and Environment Configuration .................................................................................................................4
AWS Comprehend Services Prerequisites ......................................................................................................................4
AWS Authorization...........................................................................................................................................................4
AWS Parameter Terms ....................................................................................................................................................4
Blue Prism Configuration .................................................................................................................................................5
Using Comprehend VBO ......................................................................................................................................................6
Detect Dominant Language .............................................................................................................................................7
Detect Entities ..................................................................................................................................................................7
Detect Key Phrases ..........................................................................................................................................................8
Detect Sentiment .............................................................................................................................................................9
Detect Syntax ...................................................................................................................................................................9

The information contained in this document is the proprietary and confidential information of Blue Prism Limited and should not be
disclosed to a third party without the written consent of an authorised Blue Prism representative. No part of this document may be
reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying without the written
permission of Blue Prism Limited.
© Blue Prism Limited, 2001 – 2016
®Blue Prism is a registered trademark of Blue Prism Limited
All trademarks are hereby acknowledged and are used to the benefit of their respective owners.
Blue Prism is not responsible for the content of external websites referenced by this document.
Blue Prism Limited, Centrix House, Crow Lane East, Newton-le-Willows, WA12 9UY, United Kingdom
Registered in England: Reg. No. 4260035. Tel: +44 870 879 3000. Web: www.blueprism.com

Commercial in Confidence Page 2 of 11

Introduction

As the market for RPA grows, also grows the interest of what RPA can do and how easy it can integrate with every
ecosystem available. With the advent of Artificial Intelligence (AI) to the marketplace, interest has grown in
capabilities that provide integrations with different pre-trained AI services in the cloud.
This document focuses on the design of the integration between Blue Prism® and Amazon’s Comprehend Service.
Amazon provides these in the form of web services, which are consumed via RESTful APIs.
Amazon Comprehend is a natural language processing (NLP) service that uses machine learning to find insights and
relationships in text. No machine learning experience required.
There is a treasure trove of potential sitting in your unstructured data. Customer emails, support tickets, product
reviews, social media, even advertising copy represents insights into customer sentiment that can be put to work
for your business. The question is how to get at it? As it turns out, Machine learning is particularly good at
accurately identifying specific items of interest inside vast swathes of text (such as finding company names in
analyst reports) and can learn the sentiment hidden inside language (identifying negative reviews, or positive
customer interactions with customer service agents), at almost limitless scale.
Amazon Comprehend uses machine learning to help you uncover the insights and relationships in your
unstructured data. The service identifies the language of the text; extracts key phrases, places, people, brands, or
events; understands how positive or negative the text is; analyzes text using tokenization and parts of speech; and
automatically organizes a collection of text files by topic.
https://aws.amazon.com/comprehend/features/

Solution Overview and Configuration

Limitations
The following limitations should be understood before attempting to use these integrations:
• The customer or partner is responsible for the configuration and maintenance of the relevant cloud
subscriptions and services. Blue Prism cannot provide any support on the configuration of the cloud
environment itself.
• Use of the APIs may incur additional costs, depending on usage.
• There is always a possibility with external services that the APIs will change. This VBO is provided as-is
without warranties, and support is provided by Blue Prism on a best endeavours basis and is not subject to
formal SLAs.

Commercial in Confidence Page 3 of 11

Pre-Requisites and Environment Configuration
AWS Comprehend Services Prerequisites
This document assumes you have an AWS account and appropriate credentials. Details how to set up an AWS
Account are found here:
https://docs.aws.amazon.com/comprehend/latest/dg/setting-up.html

Amazon recommends using Identity and Access Management (IAM) for fine grained control of AWS resources.
Information about IAM is here:
https://aws.amazon.com/iam/

Details for setting up identity-based policies for Amazon Comprehend are found here:
https://docs.aws.amazon.com/comprehend/latest/dg/auth-and-access-control.html

AWS Authorization
AWS employs a propriety algorithm for generating an authorization token, when is provided in the HTTP header.
This algorithm involves creating a signature based on several criteria, including the HTTP request body. The Blue
Prism Comprehend VBO includes the ability to create this authorization token, so there is no need to install the
AWS CLI tools.

AWS Parameter Terms

AWSRegion
An example would be us-east-1. You should choose a region that ensures best performance based on geography.

AccessID
Access Key ID assigned when setting up IAM
SecretKey
Secret access key assigned when setting up IAM

Commercial in Confidence Page 4 of 11

Blue Prism Configuration
When importing the .bprelease file that contains the VBO and AWS WebAPI, a credential named AWS is also
created. You will need to update the Username to contain the Access Key ID for your AWS account, as well as
setting the Password to contain the Secret Key for your account.

Details about creating keys for IAM users is here:

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html

Commercial in Confidence Page 5 of 11

Using Comprehend VBO
Amazon Comprehend (except the Detect Dominant Language feature) can examine and analyze documents in these
languages:

Amazon Comprehend Detect Dominant Language feature can detect the following languages:

Commercial in Confidence Page 6 of 11

Detect Dominant Language
Request
Parameter Data Type Description

AWSRegion Text The AWS Region

AccessID Text AWS Access ID

SecretKey Password AWS Secret Key

InputText Text Text to analyze for dominant language

Response
Parameter Data Type Description

Response Collection Collection of language names & codes along with

confidence levels found in the analyzed text

Response Headers Collection Collection of HTTP Response Headers

HTTP Status Code Text HTTP Status Code

Raw Response Text Raw JSON Response

Detect Entities
An entity is a textual reference to the unique name of a real-world object such as people, places, and commercial
items, and to precise references to measures such as dates and quantities.

Commercial in Confidence Page 7 of 11

Request
Parameter Data Type Description

AWSRegion Text The AWS Region

AccessID Text AWS Access ID

SecretKey Password AWS Secret Key

InputText Text Text to analyze

InputLanguageCode Text Two character language code

Response
Parameter Data Type Description

Response Collection Collection of entities found in the analyzed text

Response Headers Collection Collection of HTTP Response Headers

HTTP Status Code Text HTTP Status Code

Raw Response Text Raw JSON Response

Detect Key Phrases

A key phrase is a string containing a noun phrase that describes a particular thing. It generally consists of a noun
and the modifiers that distinguish it. For example, "day" is a noun; "a beautiful day" is a noun phrase that includes
an article ("a") and an adjective ("beautiful"). Each key phrase includes a score that indicates the level of confidence
that Amazon Comprehend has that the string is a noun phrase. You can use the score to determine if the detection
has high enough confidence for your application.
Request
Parameter Data Type Description

AWSRegion Text The AWS Region

AccessID Text AWS Access ID

SecretKey Password AWS Secret Key

InputText Text Text to analyze for key phrases

InputLanguageCode Text Two character language code

Response
Parameter Data Type Description

Response Collection Collection of key phrases found in the provided text

Response Headers Collection Collection of HTTP Response Headers

Commercial in Confidence Page 8 of 11

 HTTP Status Code Text HTTP Status Code

Raw Response Text Raw JSON Response

Detect Sentiment
You can determine if the sentiment is positive, negative, neutral, or mixed. For example, you can use sentiment
analysis to determine the sentiments of comments on a blog posting to determine if your readers liked the post.
Request
Parameter Data Type Description

AWSRegion Text The AWS Region

AccessID Text AWS Access ID

SecretKey Password AWS Secret Key

InputText Text Text to analyze sentiment

InputLanguageCode Text Two character language code

Response
Parameter Data Type Description

Response Collection Collection of sentiment categories and a rating score of

certainty

Response Headers Collection Collection of HTTP Response Headers

HTTP Status Code Text HTTP Status Code

Raw Response Text Raw JSON Response

Detect Syntax
Analyze your documents to parse the words from the document and return the part of speech, or syntactic
function, for each word in the document. You can identify the nouns, verbs, adjectives and so on in your document.
Use this information to gain a richer understanding of the content of your documents, and to understand the
relationship of the words in the document.
For example, you can look for the nouns in a document and then look for the verbs related to those nouns. In a
sentence like "My grandmother moved her couch" you can see the nouns, "grandmother" and "couch," and the
verb, "moved." You can use this information to build applications for analyzing text for word combinations that you
are interested in.
Request
Parameter Data Type Description

AWSRegion Text The AWS Region

AccessID Text AWS Access ID

Commercial in Confidence Page 9 of 11

SecretKey Password AWS Secret Key

InputContentPath Text Text to analyze syntax elements

Response
Parameter Data Type Description

Response Collection Collection of text elements and the part of speech they are
categorized as.

Response Headers Collection Collection of HTTP Response Headers

HTTP Status Code Text HTTP Status Code

Raw Response Text Raw JSON Response

Token Part of speech

ADJ Adjective
Words that typically modify nouns.

ADP Adposition
The head of a prepositional or postpositional phrase.

ADV Adverb
Words that typically modify verbs. They may also modify adjectives and other adverbs.

AUX Auxiliary
Function words that accompanies the verb of a verb phrase.

CCONJ Coordinating conjunction

Words that links words or phrases without subordinating one to the other.

DET Determiner
Articles and other words that specify a particular noun phrase.

INTJ Interjection
Words used as an exclamation or part of an exclamation.

NOUN Noun
Words that specify a person, place, thing, animal, or idea.

NUM Numeral
Words, typically determiners, adjectives, or pronouns, that express a number.

O Other
Words that can't be assigned a part of speech category.

Commercial in Confidence Page 10 of 11

PART Particle
Function words associated with another word or phrase to impart meaning.

PRON Pronoun
Words that substitute for nouns or noun phrases.

PROPN Proper noun

A noun that is the name of a specific individual, place or object.

PUNCT Punctuation
Non-alphabetical characters that delimit text.

SCONJ Subordinating conjunction

A conjunction that links parts of sentences by make one of them part of the other.

SYM Symbol
Word-like entities such as the dollar sign ($) or mathematical symbols.

VERB Verb
Words that signal events and actions.

Commercial in Confidence Page 11 of 11