Skip to content

Commit 4cd5c75

Browse files
GitHubber17GitHubber17
authored
Merge pull request #66912 from aahill/ta-entities-release
[Cog Svcs] Text Analytics 2.1 Entities release
2 parents 3074b35 + 79790b8 commit 4cd5c75

23 files changed

+437
-1110
lines changed

‎articles/cognitive-services/language-support.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: erhopf
77
manager: nitinme
88
ms.service: cognitive-services
99
ms.topic: article
10-
ms.date: 01/07/2019
10+
ms.date: 04/11/2019
1111
ms.author: erhopf
1212
ms.custom: seodec18
1313
---
@@ -22,19 +22,18 @@ This article is broken into two sections. The first lists core languages commonl
2222

2323
These core languages are supported across Azure Cognitive Services:
2424

25-
* Chinese¹
25+
* Chinese
2626
* English
2727
* French
2828
* German
2929
* Italian
3030
* Japanese
31-
* Korean²
31+
* Korean¹
3232
* Portuguese
3333
* Spanish
3434

3535
> [!NOTE]
36-
> ¹ Text Analytics is not supported. <br/>
37-
> ² LUIS and Video Indexer: Speech-to-Text are not supported.
36+
> ¹ LUIS and Video Indexer: Speech-to-Text are not supported.
3837
3938
## Additional language availability by service
4039

@@ -53,8 +52,8 @@ These tables highlight language availability by service category; core languages
5352
| | Arabic | Bulgarian | Catalan | Croatian | Czech | Danish | Dutch | Estonian | Finnish | Greek | Hindi | Hungarian | Icelandic | Indonesian | Latvian | Lithuanian | Malay | Norwegian | Polish | Romanian | Russian | Serbian | Slovak | Slovenian | Swedish | Tamil | Thai | Turkish | Ukrainian | Vietnamese |
5453
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
5554
| [Custom Speech](https://docs.microsoft.com/azure/cognitive-services/custom-speech-service/customspeech-how-to-topics/cognitive-services-custom-speech-change-locale) | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: |
56-
| [Speech Service: Speech-to-Text](https://docs.microsoft.com/azure/cognitive-services/speech-service/supported-languages#speech-to-text) | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |
57-
| [Speech Service:Text-to-Speech](https://docs.microsoft.com/azure/cognitive-services/speech-service/supported-languages#text-to-speech) | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: |
55+
| [Speech Service: Speech-to-Text](https://docs.microsoft.com/azure/cognitive-services/speech-service/supported-languages#speech-to-text) | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |
56+
| [Speech Service:Text-to-Speech](https://docs.microsoft.com/azure/cognitive-services/speech-service/supported-languages#text-to-speech) | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: |
5857
| [Speech Service: Speech Translation](https://docs.microsoft.com/azure/cognitive-services/speech-service/supported-languages#speech-translation) | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
5958

6059
### Language
@@ -65,7 +64,7 @@ These tables highlight language availability by service category; core languages
6564
| [Content Moderator: Text Filtering](https://docs.microsoft.com/azure/cognitive-services/content-moderator/text-moderation-api-languages) | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
6665
| [Language Understanding (LUIS)](https://docs.microsoft.com/azure/cognitive-services/luis/luis-supported-languages) | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: |
6766
| [Translator Text](https://docs.microsoft.com/azure/cognitive-services/translator/languages) | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
68-
| [Text Analytics](https://docs.microsoft.com/azure/cognitive-services/text-analytics/text-analytics-supported-languages) | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: |
67+
| [Text Analytics](https://docs.microsoft.com/azure/cognitive-services/text-analytics/text-analytics-supported-languages) | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: |
6968

7069
### Knowledge
7170

‎articles/cognitive-services/text-analytics/how-tos/text-analytics-how-to-access-key.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ titleSuffix: Azure Cognitive Services
44
description: Get an access key for Text Analytics operations to submit raw text for processing in Cognitive Services.
55
services: cognitive-services
66
author: aahill
7-
87
manager: nitinme
98
ms.service: cognitive-services
109
ms.subservice: text-analytics

‎articles/cognitive-services/text-analytics/how-tos/text-analytics-how-to-call-api.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ manager: nitinme
99
ms.service: cognitive-services
1010
ms.subservice: text-analytics
1111
ms.topic: conceptual
12-
ms.date: 02/13/2019
12+
ms.date: 02/26/2019
1313
ms.author: aahi
1414
---
1515

@@ -22,7 +22,7 @@ Each request must include your access key and an HTTP endpoint. The endpoint spe
2222
Recall that Text Analytics is stateless so there are no data assets to manage. Your text is uploaded, analyzed upon receipt, and results are returned immediately to the calling application.
2323

2424
> [!Tip]
25-
> For one-off calls to see how the API works, you can send POST requests from the built-in **API testing console**, available on any [API doc page](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics.V2.0/operations/56f30ceeeda5650db055a3c6). There is no setup, and the only requirements are to paste an access key and the JSON documents into the request.
25+
> For one-off calls to see how the API works, you can send POST requests from the built-in **API testing console**, available on any [API doc page](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/56f30ceeeda5650db055a3c6). There is no setup, and the only requirements are to paste an access key and the JSON documents into the request.
2626
2727
## Prerequisites
2828

@@ -56,10 +56,10 @@ The service accepts request up to 1 MB in size. If you are using Postman (or ano
5656

5757
Resource endpoints are as follows (your region may vary):
5858

59-
+ `https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment`
60-
+ `https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/keyPhrases`
61-
+ `https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/languages`
62-
+ `https://westus.api.cognitive.microsoft.com/text/analytics/v2.1-preview/entities`
59+
+ `https://westus.api.cognitive.microsoft.com/text/analytics/v2.1/sentiment`
60+
+ `https://westus.api.cognitive.microsoft.com/text/analytics/v2.1/keyPhrases`
61+
+ `https://westus.api.cognitive.microsoft.com/text/analytics/v2.1/languages`
62+
+ `https://westus.api.cognitive.microsoft.com/text/analytics/v2.1/entities`
6363

6464
2. Set the three request headers:
6565

@@ -77,10 +77,10 @@ The service accepts request up to 1 MB in size. If you are using Postman (or ano
7777

7878
5. Paste in some JSON documents in a format that is valid for the intended analysis. For more information about a particular analysis, see the topics below:
7979

80-
+ [Language detection](text-analytics-how-to-language-detection.md)
81-
+ [Key phrase extraction](text-analytics-how-to-keyword-extraction.md)
82-
+ [Sentiment analysis](text-analytics-how-to-sentiment-analysis.md)
83-
+ [Entity recognition (Preview)](text-analytics-how-to-entity-linking.md)
80+
+ [Language detection](text-analytics-how-to-language-detection.md)
81+
+ [Key phrase extraction](text-analytics-how-to-keyword-extraction.md)
82+
+ [Sentiment analysis](text-analytics-how-to-sentiment-analysis.md)
83+
+ [Entity recognition](text-analytics-how-to-entity-linking.md)
8484

8585

8686
6. Click **Send** to submit the request. You can submit up to 100 requests per minute.

‎articles/cognitive-services/text-analytics/how-tos/text-analytics-how-to-entity-linking.md

Lines changed: 15 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,13 @@ manager: nitinme
99
ms.service: cognitive-services
1010
ms.subservice: text-analytics
1111
ms.topic: article
12-
ms.date: 02/13/2019
12+
ms.date: 04/16/2019
1313
ms.author: aahi
1414
---
1515

16-
# How to use Named Entity Recognition in Text Analytics (Preview)
16+
# How to use Named Entity Recognition in Text Analytics
1717

18-
The [Entity Recognition API](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-V2-1-Preview/operations/5ac4251d5b4ccd1554da7634) takes unstructured text, and for each JSON document, returns a list of disambiguated entities with links to more information on the web (Wikipedia and Bing).
18+
The [Named Entity Recognition API](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/5ac4251d5b4ccd1554da7634) takes unstructured text, and for each JSON document, returns a list of disambiguated entities with links to more information on the web (Wikipedia and Bing).
1919

2020
## Entity Linking and Named Entity Recognition
2121

@@ -24,12 +24,10 @@ The Text Analytics' `entities` endpoint supports both named entity recognition (
2424
### Entity Linking
2525
Entity linking is the ability to identify and disambiguate the identity of an entity found in text (for example, determining whether the "Mars" is being used as the planet or as the Roman god of war). This process requires the presence of a knowledge base to which recognized entities are linked - Wikipedia is used as the knowledge base for the `entities` endpoint Text Analytics.
2626

27-
In Text Analytics [Version 2.0](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics.V2.0/operations/5ac4251d5b4ccd1554da7634), only entity linking is available.
28-
2927
### Named Entity Recognition (NER)
3028
Named entity recognition (NER) is the ability to identify different entities in text and categorize them into pre-defined classes. The supported classes of entities are listed below.
3129

32-
In Text Analytics [Version 2.1-Preview](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-V2-1-Preview/operations/5ac4251d5b4ccd1554da7634), both entity linking and named entity recognition (NER) are available.
30+
In Text Analytics [Version 2.1](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/5ac4251d5b4ccd1554da7634), both entity linking and named entity recognition (NER) are available.
3331

3432
### Language support
3533

@@ -67,7 +65,7 @@ Using entity linking in various languages requires using a corresponding knowled
6765

6866
## Preparation
6967

70-
You must have JSON documents in this format: id, text, language
68+
You must have JSON documents in this format: ID, text, language
7169

7270
For currently supported languages, see [this list](../text-analytics-supported-languages.md).
7371

@@ -90,16 +88,16 @@ Document size must be under 5,120 characters per document, and you can have up t
9088

9189
Details on request definition can be found in [How to call the Text Analytics API](text-analytics-how-to-call-api.md). The following points are restated for convenience:
9290

93-
+ Create a **POST** request. Review the API documentation for this request: [Entity Linking API](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics.V2.0/operations/5ac4251d5b4ccd1554da7634)
91+
+ Create a **POST** request. Review the API documentation for this request: [Entity Linking API](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/5ac4251d5b4ccd1554da7634)
9492

95-
+ Set the HTTP endpoint for entity extraction. It must include the `/entities` resource: `https://[your-region].api.cognitive.microsoft.com/text/analytics/v2.1-preview/entities`
93+
+ Set the HTTP endpoint for entity extraction. It must include the `/entities` resource: `https://[your-region].api.cognitive.microsoft.com/text/analytics/v2.1/entities`
9694

9795
+ Set a request header to include the access key for Text Analytics operations. For more information, see [How to find endpoints and access keys](text-analytics-how-to-access-key.md).
9896

9997
+ In the request body, provide the JSON documents collection you prepared for this analysis
10098

10199
> [!Tip]
102-
> Use [Postman](text-analytics-how-to-call-api.md) or open the **API testing console** in the [documentation](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-V2-1-Preview/operations/5ac4251d5b4ccd1554da7634) to structure a request and POST it to the service.
100+
> Use [Postman](text-analytics-how-to-call-api.md) or open the **API testing console** in the [documentation](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/5ac4251d5b4ccd1554da7634) to structure a request and POST it to the service.
103101
104102
## Step 2: Post the request
105103

@@ -276,18 +274,16 @@ An example of the output for entity linking is shown next:
276274

277275
In this article, you learned concepts and workflow for entity linking using Text Analytics in Cognitive Services. In summary:
278276

279-
+ [Entities API](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-V2-1-Preview/operations/5ac4251d5b4ccd1554da7634) is available for selected languages.
280-
+ JSON documents in the request body include an id, text, and language code.
277+
+ [Entities API](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/5ac4251d5b4ccd1554da7634) is available for selected languages.
278+
+ JSON documents in the request body include an ID, text, and language code.
281279
+ POST request is to a `/entities` endpoint, using a personalized [access key and an endpoint](text-analytics-how-to-access-key.md) that is valid for your subscription.
282280
+ Response output, which consists of linked entities (including confidence scores, offsets, and web links, for each document ID) can be used in any application
283281

284-
## See also
285-
286-
[Text Analytics overview](../overview.md)
287-
[Frequently asked questions (FAQ)](../text-analytics-resource-faq.md)</br>
288-
[Text Analytics product page](//go.microsoft.com/fwlink/?LinkID=759712)
289-
290282
## Next steps
291283

292284
> [!div class="nextstepaction"]
293-
> [Text Analytics API](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-V2-1-Preview/operations/5ac4251d5b4ccd1554da7634)
285+
> [Text Analytics API](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/5ac4251d5b4ccd1554da7634)
286+
287+
* [Text Analytics overview](../overview.md)
288+
* [Frequently asked questions (FAQ)](../text-analytics-resource-faq.md)</br>
289+
* [Text Analytics product page](//go.microsoft.com/fwlink/?LinkID=759712)

0 commit comments

Comments
 (0)