Skip to content

Commit ee3a300

Browse files
Merge pull request #208866 from aahill/docs-editor/overview-1661276320
Summarization overview update
2 parents 095c728 + a473c01 commit ee3a300

File tree

1 file changed

+10
-14
lines changed
  • articles/cognitive-services/language-service/summarization

1 file changed

+10
-14
lines changed

articles/cognitive-services/language-service/summarization/overview.md

Lines changed: 10 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ Summarization is one of the features offered by [Azure Cognitive Service for Lan
2323

2424
This documentation contains the following article types:
2525

26-
* [**Quickstarts**](quickstart.md?pivots=rest-api&tabs=document-summarization) are getting-started instructions to guide you through making requests to the service.
27-
* [**How-to guides**](how-to/document-summarization.md) contain instructions for using the service in more specific or customized ways.
26+
* **[Quickstarts](quickstart.md?pivots=rest-api&tabs=document-summarization)** are getting-started instructions to guide you through making requests to the service.
27+
* **[How-to guides](how-to/document-summarization.md)** contain instructions for using the service in more specific or customized ways.
2828

2929
Text summarization is a broad topic, consisting of several approaches to represent relevant information in text. The document summarization feature described in this documentation enables you to use extractive text summarization to produce a summary of a document. It extracts sentences that collectively represent the most important or relevant information within the original content. This feature is designed to shorten content that could be considered too long to read. For example, it can condense articles, papers, or documents to key sentences.
3030

@@ -49,18 +49,18 @@ Document summarization supports the following features:
4949

5050
This documentation contains the following article types:
5151

52-
* [**Quickstarts**](quickstart.md?pivots=rest-api&tabs=conversation-summarization) are getting-started instructions to guide you through making requests to the service.
53-
* [**How-to guides**](how-to/conversation-summarization.md) contain instructions for using the service in more specific or customized ways.
52+
* **[Quickstarts](quickstart.md?pivots=rest-api&tabs=conversation-summarization)** are getting-started instructions to guide you through making requests to the service.
53+
* **[How-to guides](how-to/conversation-summarization.md)** contain instructions for using the service in more specific or customized ways.
5454

5555
Conversation summarization is a broad topic, consisting of several approaches to represent relevant information in text. The conversation summarization feature described in this documentation enables you to use abstractive text summarization to produce a summary of issues and resolutions in transcripts of web chats and service call transcripts between customer-service agents, and your customers.
5656

5757
:::image type="content" source="media/conversation-summary-diagram.svg" alt-text="A diagram for sending data to the conversation summarization feature.":::
5858

5959
## When to use conversation summarization
6060

61-
* When there are predefined aspects of an “issue” and “resolution”, such as:
62-
* The reason for a service chat/call (the issue).
63-
* That resolution for the issue.
61+
* When there are aspects of an “issue” and “resolution”, such as:
62+
* The reason for a service chat/call (the issue).
63+
* That resolution for the issue.
6464
* You only want a summary that focuses on related information about issues and resolutions.
6565
* When there are two participants in the conversation, and you want to summarize what each had said.
6666

@@ -99,19 +99,16 @@ Conversation summarization feature would simplify the text into the following:
9999

100100
To use this feature, you submit raw unstructured text for analysis and handle the API output in your application. Analysis is performed as-is, with no additional customization to the model used on your data. There are two ways to use summarization:
101101

102-
103-
|Development option |Description | Links |
102+
|Development option |Description | Links |
104103
|---------|---------|---------|
105104
| Language Studio | A web-based platform that enables you to try document summarization without needing writing code. |[Language Studio website](https://language.cognitive.azure.com/tryout/summarization) <br> • [Quickstart: Use Language Studio](../language-studio.md) |
106105
| REST API or Client library (Azure SDK) | Integrate document summarization into your applications using the REST API, or the client library available in a variety of languages. |[Quickstart: Use document summarization](quickstart.md) |
107106

108-
109107
# [Conversation summarization](#tab/conversation-summarization)
110108

111109
To use this feature, you submit raw text for analysis and handle the API output in your application. Analysis is performed as-is, with no additional customization to the model used on your data. There are two ways to use conversation summarization:
112110

113-
114-
|Development option |Description | Links |
111+
|Development option |Description | Links |
115112
|---------|---------|---------|
116113
| REST API | Integrate conversation summarization into your applications using the REST API. | [Quickstart: Use conversation summarization](quickstart.md) |
117114

@@ -124,7 +121,6 @@ To use this feature, you submit raw text for analysis and handle the API output
124121
* Summarization takes raw unstructured text for analysis. See [Data and service limits](../concepts/data-limits.md) in the how-to guide for more information.
125122
* Summarization works with a variety of written languages. See [language support](language-support.md?tabs=document-summarization) for more information.
126123

127-
128124
# [Conversation summarization](#tab/conversation-summarization)
129125

130126
* Conversation summarization takes structured text for analysis. See the [data and service limits](../concepts/data-limits.md) for more information.
@@ -144,7 +140,7 @@ As you use document summarization in your applications, see the following refere
144140
|JavaScript | [JavaScript documentation](/javascript/api/overview/azure/ai-text-analytics-readme?view=azure-node-preview&preserve-view=true) | [JavaScript samples](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/textanalytics/ai-text-analytics/samples/v5) |
145141
|Python | [Python documentation](/python/api/overview/azure/ai-textanalytics-readme?view=azure-python-preview&preserve-view=true) | [Python samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/textanalytics/azure-ai-textanalytics/samples) |
146142

147-
## Responsible AI
143+
## Responsible AI
148144

149145
An AI system includes not only the technology, but also the people who will use it, the people who will be affected by it, and the environment in which it’s deployed. Read the [transparency note for summarization](/legal/cognitive-services/language-service/transparency-note-extractive-summarization?context=/azure/cognitive-services/language-service/context/context) to learn about responsible AI use and deployment in your systems. You can also see the following articles for more information:
150146

0 commit comments

Comments
 (0)