Skip to content

Commit ceabbe8

Browse files
committed
Removed deprecated services
1 parent 2d7c4e1 commit ceabbe8

6 files changed

Lines changed: 31 additions & 30 deletions

File tree

learn-pr/wwl-data-ai/analyze-text-ai-language/includes/2-provision-resource.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,9 @@ Azure Language in Foundry Tools is designed to help you extract information from
66

77
:::image type="content" source="../media/text-analytics-resource.png" alt-text="Diagram showing an Azure Language resource performing language detection, named entity recognition, and PII extraction.":::
88

9+
> [!NOTE]
10+
> Azure Language also provides functionality for sentiment analysis, summarization, key phrase extraction, and other common language-related tasks. These deprecated capabilities are provided to support existing applications.
11+
912
## Using a Microsoft Foundry resource for text analysis
1013

1114
To use Azure Language in Foundry Tools to analyze text, you must provision a Microsoft Foundry resource in your Azure subscription.

learn-pr/wwl-data-ai/develop-text-analysis-agent-language-mcp/includes/01-introduction.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
Azure Language in Foundry Tools provides a set of natural language processing (NLP) capabilities that you can use to analyze text. These capabilities include sentiment analysis, named entity recognition, key phrase extraction, summarization, and more.
1+
Azure Language in Foundry Tools provides a set of natural language processing (NLP) capabilities that you can use to analyze text. These capabilities include language detection, named entity recognition, and personally identifiable information (PII) extraction.
22

33
While you can call these capabilities individually through REST APIs or SDKs, you can also make them available to an AI agent through the **Azure Language Model Context Protocol (MCP) server**. This approach lets the agent dynamically select and call the appropriate language tool based on a user's request, without you needing to write specific code for each capability.
44

5-
For example, suppose you work for a company that needs to analyze customer feedback. Customers submit reviews in multiple languages, and your team needs to understand the overall sentiment, identify the people and places mentioned, and generate summaries of the feedback. Rather than building separate integrations for each of these tasks, you can create an AI agent that uses the Azure Language MCP server to perform all of them through a single tool connection.
5+
For example, suppose you work for a company that needs to analyze customer feedback. Customers submit reviews in multiple languages, and your team needs to determine which language was used, identify the people and places mentioned, and redact any personal details in the reviews. Rather than building separate integrations for each of these tasks, you can create an AI agent that uses the Azure Language MCP server to perform all of them through a single tool connection.
66

77
In this module, you learn how the Azure Language MCP server works, how to connect it to an AI agent in Microsoft Foundry, and how to build a client application that interacts with the agent programmatically.
88

learn-pr/wwl-data-ai/develop-text-analysis-agent-language-mcp/includes/02-understand-language-mcp.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,17 +21,15 @@ The Azure Language MCP server exposes Azure Language NLP capabilities as tools t
2121

2222
| Capability | Description |
2323
|---|---|
24-
| **Named Entity Recognition** | Identifies and categorizes entities in text, such as people, places, organizations, dates, and quantities. |
25-
| **Sentiment Analysis** | Determines whether text expresses positive, negative, or neutral sentiment, and can extract opinions about specific aspects. |
26-
| **Summarization** | Generates concise summaries of longer text content. |
27-
| **Key Phrase Extraction** | Identifies the main concepts and key phrases in text. |
28-
| **PII Redaction** | Detects and redacts personally identifiable information such as names, addresses, and phone numbers. |
2924
| **Language Detection** | Identifies the language in which text is written. |
25+
| **Named Entity Recognition** | Identifies and categorizes entities in text, such as people, places, organizations, dates, and quantities. |
26+
| **PII Redaction** | Detects and redacts personally identifiable information (PII) such as names, addresses, and phone numbers. |
3027
| **Text Analytics for Health** | Extracts and labels medical entities (such as diagnoses, medications, and symptoms) from clinical text. |
31-
| **Conversational Language Understanding** | Interprets user utterances to identify intents and extract entities based on a trained custom model. |
32-
| **Custom Question Answering** | Returns curated answers to user questions from a configured knowledge base. |
3328

34-
When you connect the Language MCP server to an agent, the agent receives the full list of available tools. Based on the user's prompt, the agent's underlying model decides which tool (or combination of tools) to call. For example, if a user asks "Summarize this article and tell me what people are mentioned," the agent might call both the summarization tool and the named entity recognition tool in the same turn.
29+
> [!NOTE]
30+
> Azure Language also provides functionality for sentiment analysis, summarization, key phrase extraction, and other common language-related tasks. These deprecated capabilities are provided to support existing applications.
31+
32+
When you connect the Language MCP server to an agent, the agent receives the full list of available tools. Based on the user's prompt, the agent's underlying model decides which tool (or combination of tools) to call. For example, if a user asks "Determine the language that this article is written in, and tell me what people are mentioned." the agent might call both the language detection tool and the named entity recognition tool in the same turn.
3533

3634
## How the agent selects tools
3735

learn-pr/wwl-data-ai/develop-text-analysis-agent-language-mcp/includes/03-connect-use-language-mcp.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ The agent now has access to all the text analysis tools exposed by the Azure Lan
3939
After connecting the Language MCP tool, update the agent's instructions to direct it to use the tool:
4040
4141
```
42-
You are an AI agent that assists users by helping them analyze and summarize text. Use the Azure Language tool to perform text analysis tasks.
42+
You are an AI agent that assists users by helping them analyze text. Use the Azure Language tool to perform text analysis tasks.
4343
```
4444
4545
This instruction helps the agent understand that it should use the connected tool when processing text analysis requests.
@@ -50,7 +50,7 @@ The agent playground in the Foundry portal provides an interactive environment f
5050
5151
When you send a prompt that requires text analysis, the agent:
5252
53-
1. Identifies the tasks needed (for example, summarization and entity recognition).
53+
1. Identifies the tasks needed (for example, language detection and entity recognition).
5454
1. Calls the appropriate Azure Language MCP tool(s).
5555
1. Returns a combined response.
5656
@@ -84,7 +84,7 @@ response = openai_client.responses.create(
8484
print(response.output_text)
8585
```
8686

87-
The agent processes the prompt, calls the appropriate MCP tools, and returns the result in `output_text`. You can also inspect the full response JSON (using `response.model_dump_json()`) to see which tools the agent called — for example, `extract_named_entities_from_text` or `detect_sentiment_from_text` — along with the arguments and results for each tool call.
87+
The agent processes the prompt, calls the appropriate MCP tools, and returns the result in `output_text`. You can also inspect the full response JSON (using `response.model_dump_json()`) to see which tools the agent called — for example, `extract_named_entities_from_text` or `detect_language_from_text` — along with the arguments and results for each tool call.
8888

8989
### Connect the MCP server in code
9090

@@ -108,6 +108,6 @@ When a user's prompt involves multiple text analysis tasks, the agent can call m
108108

109109
> "Tell me what entities and dates are mentioned in this review, and whether it is positive or negative."
110110
111-
This prompt requires both entity recognition and sentiment analysis. The agent identifies both tasks, calls the appropriate tools (`extract_named_entities_from_text` and `detect_sentiment_from_text`), and combines the results into a single response.
111+
This prompt requires both entity recognition and sentiment analysis. The agent identifies both tasks, calls the appropriate tools (`extract_named_entities_from_text` and `detect_language_from_text`), and combines the results into a single response.
112112

113113
Each tool call goes through the MCP server independently, and the agent synthesizes the outputs into a coherent answer for the user.

learn-pr/wwl-data-ai/develop-text-analysis-agent-language-mcp/includes/04-exercise.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Now it's your turn to build a text analysis agent using the Azure Language MCP server!
22

3-
In this exercise, you create an AI agent in Microsoft Foundry, connect it to the Azure Language MCP server, test it in the agent playground, and build a Python client application that uses the agent to perform text analysis tasks such as entity recognition, sentiment analysis, and summarization.
3+
In this exercise, you create an AI agent in Microsoft Foundry, connect it to the Azure Language MCP server, test it in the agent playground, and build a Python client application that uses the agent to perform text analysis tasks such as entity recognition and PII redaction.
44

55
> [!NOTE]
66
> To complete this exercise, you need an **[Azure subscription](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn)** in which you have administrative access.

learn-pr/wwl-data-ai/develop-text-analysis-agent-language-mcp/index.yml

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
uid: learn.wwl.develop-text-analysis-agent-language-mcp
33
metadata:
44
title: Develop a Text Analysis Agent with the Azure Language MCP Server
5-
description: Learn how to build an AI agent that uses the Azure Language MCP server to perform text analysis tasks like entity recognition, sentiment analysis, and summarization.
5+
description: Learn how to build an AI agent that uses the Azure Language MCP server to perform text analysis tasks like language detection, entity recognition, and personal information redaction.
66
ms.date: 03/13/2026
77
author: ivorb
88
ms.author: berryivor
99
ms.topic: module-standard-task-based
1010
ms.service: azure-ai-language
1111
ai-usage: ai-generated
1212
title: Develop a text analysis agent with the Azure Language MCP server
13-
summary: Learn how to build an AI agent that uses the Azure Language MCP server to perform text analysis tasks like entity recognition, sentiment analysis, and summarization.
13+
summary: Learn how to build an AI agent that uses the Azure Language MCP server to perform text analysis tasks like language detection, entity recognition, and personal information redaction.
1414
abstract: |
1515
After completing this module, you'll be able to:
1616
- Describe the Azure Language MCP server and the text analysis capabilities it exposes.
@@ -24,22 +24,22 @@ prerequisites: |
2424
- Have some familiarity with Python programming.
2525
iconUrl: /learn/achievements/generic-badge.svg
2626
levels:
27-
- intermediate
27+
- intermediate
2828
roles:
29-
- ai-engineer
30-
- developer
29+
- ai-engineer
30+
- developer
3131
products:
32-
- language-service
33-
- microsoft-foundry
34-
- foundry-agent-service
32+
- language-service
33+
- microsoft-foundry
34+
- foundry-agent-service
3535
subjects:
36-
- artificial-intelligence
36+
- artificial-intelligence
3737
units:
38-
- learn.wwl.develop-text-analysis-agent-language-mcp.introduction
39-
- learn.wwl.develop-text-analysis-agent-language-mcp.understand-language-mcp
40-
- learn.wwl.develop-text-analysis-agent-language-mcp.connect-use-language-mcp
41-
- learn.wwl.develop-text-analysis-agent-language-mcp.exercise
42-
- learn.wwl.develop-text-analysis-agent-language-mcp.knowledge-check
43-
- learn.wwl.develop-text-analysis-agent-language-mcp.summary
38+
- learn.wwl.develop-text-analysis-agent-language-mcp.introduction
39+
- learn.wwl.develop-text-analysis-agent-language-mcp.understand-language-mcp
40+
- learn.wwl.develop-text-analysis-agent-language-mcp.connect-use-language-mcp
41+
- learn.wwl.develop-text-analysis-agent-language-mcp.exercise
42+
- learn.wwl.develop-text-analysis-agent-language-mcp.knowledge-check
43+
- learn.wwl.develop-text-analysis-agent-language-mcp.summary
4444
badge:
4545
uid: learn.wwl.develop-text-analysis-agent-language-mcp.badge

0 commit comments

Comments
 (0)