Partager via


Text Analytics (Preview)

Discover meaningful insights in your text data. Perform Sentiment Analysis, extract Key Phrases and scrub PII Data from your text data.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name MAQ Software Sales
URL https://maqsoftware.com/contact
Email Sales@MAQSoftware.com
Connector Metadata
Publisher MAQ Software
Website https://maqsoftware.com/
Privacy Policy https://maqsoftware.com/privacystatement
Categories AI;Website

MAQTextAnalytics can be used for processing raw text using the natural language processing models. This connector supports sentiment analysis, extraction of key phrases and scrubbing Personally Identifiable Information (PII).

Prerequisites

Register for the SDK

You will need an O365 Account to register:

  • Click here to register using the Free Trial button in the Developer Zone pane
  • Save the API Key you receive while registering on the Developer Zone pane. Kindly note the validity until which the subscription will be active

You're now ready to start using this connector.

Capabilities

Sentiment Analysis

Analyze sentiment of raw text. This capability returns a sentiment score between 0 and 1, where a score of 0 corresponds to negative sentiment and a score of 1 corresponds to positive sentiment. In addition, a score of 0.5 corresponds to neutral sentiment.

Key Phrase Extraction

Extract top key phrases from raw text. It outputs each keyphrase with a significance score and most similar key phrases. This capability requires the following information to be entered by user:

  • text: Input text from which key phrases need to be extracted
  • keyphraseCount: Count of Key Phrases to return
  • diversityThreshold: Value of Diversity Threshold can be between 0 and 1. More the score, more different/diverse the keyphrases are. Less the score, more duplicate the keyphrases are.
  • aliasThreshold: Value of Alias Threshold can be between 0 and 1. Similarity threshold for Alias/Similar Keyphrase with Top Key Phrase. More the value, more accurate are the keyphrases in top key-phrase.

Scrub PII Data

Scrub Personally Identifiable Information (PII data) from raw text based on the configured entities. This capability requires the following information to be entered by user:

  • text: Input text from which PII entities need to be scrubbed
  • entityList: Comma separated list of entities (Refer to List of Supported Entities section below)

List of Supported Entities for scrubbing PII data:

Entity Name Action
PERSON A full person name, which can include first names, middle names or initials, and last names.
CREDIT_CARD A credit card number is between 12 to 19 digits. https://en.wikipedia.org/wiki/Payment_card_number
DATE_TIME Absolute or relative dates or periods or times smaller than a day.
DOMAIN_NAME A domain name as defined by the DNS standard.
EMAIL_ADDRESS An email address identifies an email box to which email messages are delivered
IBAN_CODE The International Bank Account Number (IBAN) is an internationally agreed system of identifying bank accounts across national borders to facilitate the communication and processing of cross border transactions with a reduced risk of transcription errors.
IP_ADDRESS An Internet Protocol (IP) address (either IPv4 or IPv6).
LOCATION Name of politically or geographically defined location (cities, provinces, countries, international regions, bodies of water, mountains
PHONE_NUMBER A telephone number
US_BANK_NUMBER A US bank account number is between 8 to 17 digits.
US_DRIVER_LICENSE A US driver license according to https://ntsi.com/drivers-license-format/
US_PASSPORT A US passport number with 9 digits.
US_SSN A US Social Security Number (SSN) with 9 digits.

Known issues and limitations

This connector uses API Key offered as part of free trial from MAQ Text Analytics. In the free trial subscription, the API Key has a default quota of 500 calls. In a single call, you can send maximum of 1 document.

FAQ

  1. What happens when my API Key expires?
    You can re-register for a free trial subscription by clicking here. For more information, you can connect with us at support@maqsoftware.com.

  2. What happens when my API Limit is exhausted?
    You will get an API Limit exceeded error when you try to use the connector. You can visit the Developer Zone pane and generate a new API Key. For a premium service, you can connect with us at support@maqsoftware.com

  3. Why I am getting batch size error? You can send a maximum 1 document in a single call for each capability. Verify that you are not trying to send more than 1 document.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Key Phrase Extractor

Extract Key Phrases from your text data

Scrub PII Data

Scrub PII data from your text based on configured entities

Sentiment Classifier

Perform Sentiment Analysis of your text data

Key Phrase Extractor

Extract Key Phrases from your text data

Parameters

Name Key Required Type Description
text
text string

text

keyphrases_count
keyphrases_count integer

keyphrases_count

diversity_threshold
diversity_threshold float

diversity_threshold

alias_threshold
alias_threshold float

alias_threshold

Returns

Name Path Type Description
array of object
KeyPhrase
KeyPhrase string

KeyPhrase

Score
Score float

Score

Similar
Similar array of string

Similar

Scrub PII Data

Scrub PII data from your text based on configured entities

Parameters

Name Key Required Type Description
data
data string

data

entity_list
entity_list string

entity_list

Returns

Name Path Type Description
scrubbed_text
scrubbed_text string

scrubbed_text

Sentiment Classifier

Perform Sentiment Analysis of your text data

Parameters

Name Key Required Type Description
id
id integer

id

text
text string

text

Returns

Name Path Type Description
array of object
id
id integer

id

sentiment
sentiment float

sentiment