Merge pull request #2889 from jboback/pii-ner-ta4h-foundry-tab

Foundry Tab for PII, NER, TA4H, Language Detection, Summarization, Sentiment Analysis, Key Phrase Extraction quickstarts

Author: Stacyrch140

articles/ai-services/language-service/entity-linking/quickstart.md

@@ -13,7 +13,7 @@ ms.devlang: csharp
 # ms.devlang: csharp, java, javascript, python
 ms.custom: language-service-entity-linking, mode-api, devx-track-extended-java, devx-track-js, devx-track-python
 keywords: text mining, entity linking
-zone_pivot_groups: programming-languages-text-analytics
+zone_pivot_groups: programming-languages-entity-linking
 ---
 
 # Quickstart: Entity Linking using the client library and REST API

articles/ai-services/language-service/key-phrase-extraction/how-to/call-api.md

@@ -19,7 +19,7 @@ The key phrase extraction feature can evaluate unstructured text, and for each d
 This feature is useful if you need to quickly identify the main points in a collection of documents. For example, given input text "*The food was delicious and the staff was wonderful*", the service returns the main topics: "*food*" and "*wonderful staff*".
 
 > [!TIP]
-> If you want to start using this feature, you can follow the [quickstart article](../quickstart.md) to get started. You can also make example requests using [Language Studio](../../language-studio.md) without needing to write code.
+> If you want to start using this feature, you can follow the [quickstart article](../quickstart.md) to get started. You can also make requests using [Azure AI Foundry](../../../../ai-studio//what-is-ai-studio.md) without needing to write code.
 
 ## Development options
 
@@ -29,20 +29,20 @@ This feature is useful if you need to quickly identify the main points in a coll
 
 ### Specify the key phrase extraction model
 
-By default, key phrase extraction will use the latest available AI model on your text. You can also configure your API requests to use a specific [model version](../../concepts/model-lifecycle.md).
+By default, key phrase extraction uses the latest available AI model on your text. You can also configure your API requests to use a specific [model version](../../concepts/model-lifecycle.md).
 
 ### Input languages
 
-When you submit documents to be processed by key phrase extraction, you can specify which of [the supported languages](../language-support.md) they're written in. if you don't specify a language, key phrase extraction will default to English. The API may return offsets in the response to support different [multilingual and emoji encodings](../../concepts/multilingual-emoji-support.md). 
+When you submit documents to be processed by key phrase extraction, you can specify which of [the supported languages](../language-support.md) they're written in. if you don't specify a language, key phrase extraction defaults to English. The API may return offsets in the response to support different [multilingual and emoji encodings](../../concepts/multilingual-emoji-support.md). 
 
 ## Submitting data
 
 Key phrase extraction works best when you give it bigger amounts of text to work on. This is opposite from sentiment analysis, which performs better on smaller amounts of text. To get the best results from both operations, consider restructuring the inputs accordingly.
 
-To send an API request, You will need your Language resource endpoint and key.
+To send an API request, You need your Language resource endpoint and key.
 
 > [!NOTE]
-> You can find the key and endpoint for your Language resource on the Azure portal. They will be located on the resource's **Key and endpoint** page, under **resource management**. 
+> You can find the key and endpoint for your Language resource on the Azure portal. They are located on the resource's **Key and endpoint** page, under **resource management**. 
 
 Analysis is performed upon receipt of the request. Using the key phrase extraction feature synchronously is stateless. No data is stored in your account, and results are returned immediately in the response.
 

articles/ai-services/language-service/key-phrase-extraction/includes/development-options.md

@@ -13,6 +13,6 @@ To use key phrase extraction, you submit raw unstructured text for analysis and
 
 |Development option  |Description  |
 |---------|---------|
-|Language studio     | Language Studio is a web-based platform that lets you try entity linking with text examples without an Azure account, and your own data when you sign up. For more information, see the [Language Studio website](https://language.cognitive.azure.com/tryout/keyPhrases) or [language studio quickstart](../../language-studio.md).         |
+|Azure AI Foundry     | Azure AI Foundry is a web-based platform that lets you use entity linking with text examples with your own data when you sign up. For more information, see the [Azure AI Foundry website](https://ai.azure.com) or [Azure AI Foundry documentation](../../../../ai-studio/what-is-ai-studio.md).         |
 |REST API or Client library (Azure SDK)      | Integrate key phrase extraction into your applications using the REST API, or the client library available in a variety of languages. For more information, see the [key phrase extraction quickstart](../quickstart.md).        |
 | Docker container | Use the available Docker container to [deploy this feature on-premises](../how-to/use-containers.md). These docker containers enable you to bring the service closer to your data for compliance, security, or other operational reasons. |

articles/ai-services/language-service/key-phrase-extraction/includes/quickstarts/azure-ai-foundry.md

@@ -0,0 +1,49 @@
+---
+author: jboback
+manager: nitinme
+ms.service: azure-ai-language
+ms.topic: include
+ms.date: 02/16/2025
+ms.author: jboback
+---
+
+## Prerequisites
+
+* [Create a Project in Foundry in the Azure AI Foundry Portal](../../../../../ai-studio/how-to/create-projects.md)
+
+## Navigate to the Azure AI Foundry Playground
+
+Using the left side pane, select **Playgrounds**. Then select the **Try the Language Playground** button.
+
+:::image type="content" source="../../media/quickstarts/azure-ai-foundry/foundry-playground-navigation.png" alt-text="The development lifecycle" lightbox="../../media/quickstarts/azure-ai-foundry/foundry-playground-navigation.png":::
+
+## Use Key Phrase Extraction in the Azure AI Foundry Playground
+
+The **Language Playground** consists of four sections:
+
+* Top banner: You can select any of the currently available Language services here.
+* Right pane: This pane is where you can find the **Configuration** options for the service, such as the API and model version, along with features specific to the service.
+* Center pane: This pane is where you enter your text for processing. After the operation is run, some results are shown here.
+* Right pane: This pane is where **Details** of the run operation are shown.
+
+Here you can select the Key Phrase Extraction capability by choosing the top banner tile, **Extract key phrases**.
+
+## Use Extract key phrases
+
+**Extract key phrases** is designed to extract key phrases from text.
+
+In **Configuration** there are the following options:
+
+|Option              |Description                              |
+|--------------------|-----------------------------------------|
+|Select API version  | Select which version of the API to use.    |
+|Select model version| Select which version of the model to use.|
+|Select text language| Select the language of the input text. |
+
+After your operation is completed, each entity is underlined in the center pane and the **Details** section contains the following fields for the overall sentiment and the sentiment of each sentence:
+
+|Field | Description                |
+|------|----------------------------|
+|Extracted key phrases|A list of the extracted key phrases.|
+
+:::image type="content" source="../../media/quickstarts/azure-ai-foundry/key-phrase-extraction.png" alt-text="A screenshot of an example of Extract key phrases in azure AI studio." lightbox="../../media/quickstarts/azure-ai-foundry/key-phrase-extraction.png":::

articles/ai-services/language-service/key-phrase-extraction/media/quickstarts/azure-ai-foundry/foundry-playground-navigation.png

@@ -7,14 +7,14 @@ author: jboback
 manager: nitinme
 ms.service: azure-ai-language
 ms.topic: overview
-ms.date: 09/27/2024
+ms.date: 02/17/2025
 ms.author: jboback
 ms.custom: language-service-key-phrase
 ---
 
 # What is key phrase extraction in Azure AI Language?
 
-Key phrase extraction is one of the features offered by [Azure AI Language](../overview.md), a collection of machine learning and AI algorithms in the cloud for developing intelligent applications that involve written language. Use key phrase extraction to quickly identify the main concepts in text. For example, in the text "*The food was delicious and the staff were wonderful.*", key phrase extraction will return the main topics: "*food*" and "*wonderful staff*".
+Key phrase extraction is one of the features offered by [Azure AI Language](../overview.md), a collection of machine learning and AI algorithms in the cloud for developing intelligent applications that involve written language. Use key phrase extraction to quickly identify the main concepts in text. For example, in the text "*The food was delicious and the staff were wonderful.*", key phrase extraction returns the main topics: "*food*" and "*wonderful staff*."
 
 This documentation contains the following types of articles:
 
@@ -32,12 +32,12 @@ This documentation contains the following types of articles:
 
 ## Responsible AI 
 
-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 is deployed. Read the [transparency note for key phrase extraction](/legal/cognitive-services/language-service/transparency-note-key-phrase-extraction?context=/azure/ai-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:
+An AI system includes not only the technology, but also the people who use it, the people who are affected by it, and the environment in which it's deployed. Read the [transparency note for key phrase extraction](/legal/cognitive-services/language-service/transparency-note-key-phrase-extraction?context=/azure/ai-services/language-service/context/context) to learn about responsible AI use and deployment in your systems. For more information, see the following articles:
 
 [!INCLUDE [Responsible AI links](../includes/overview-responsible-ai-links.md)]
 
 ## Next steps
 
 There are two ways to get started using the entity linking feature:
-* [Language Studio](../language-studio.md), which is a web-based platform that enables you to try several Azure AI Language features without needing to write code.
+* [Azure AI Foundry](../../../ai-studio/what-is-ai-studio.md) is a web-based platform that lets you use several Azure AI Language features without needing to write code.
 * The [quickstart article](quickstart.md) for instructions on making requests to the service using the REST API and client library SDK.  

articles/ai-services/language-service/key-phrase-extraction/media/quickstarts/azure-ai-foundry/key-phrase-extraction.png

@@ -7,7 +7,7 @@ author: jboback
 manager: nitinme
 ms.service: azure-ai-language
 ms.topic: quickstart
-ms.date: 11/21/2024
+ms.date: 02/17/2025
 ms.author: jboback
 ms.devlang: csharp
 # ms.devlang: csharp, java, javascript, python
@@ -48,6 +48,12 @@ zone_pivot_groups: programming-languages-text-analytics
 
 ::: zone-end
 
+::: zone pivot="azure-ai-foundry"
+
+[!INCLUDE [Azure AI Foundry quickstart](includes/quickstarts/azure-ai-foundry.md)]
+
+::: zone-end
+
 ## Clean up resources
 
 If you want to clean up and remove an Azure AI services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.

articles/ai-services/language-service/key-phrase-extraction/overview.md

@@ -13,6 +13,6 @@ To use language detection, you submit raw unstructured text for analysis and han
 
 |Development option  |Description  |
 |---------|---------|
-|Language studio     | Language Studio is a web-based platform that lets you try entity linking with text examples without an Azure account, and your own data when you sign up. For more information, see the [Language Studio website](https://language.cognitive.azure.com/tryout/detectLanguage) or [language studio quickstart](../../language-studio.md).         |
+|Azure AI Foundry     | Azure AI Foundry is a web-based platform that lets you use entity linking with text examples with your own data when you sign up. For more information, see the [Azure AI Foundry website](https://ai.azure.com) or [Azure AI Foundry documentation](../../../../ai-studio/what-is-ai-studio.md).         |
 |REST API or Client library (Azure SDK)      | Integrate language detection into your applications using the REST API, or the client library available in a variety of languages. For more information, see the [language detection quickstart](../quickstart.md).        |
 | Docker container | Use the available Docker container to [deploy this feature on-premises](../how-to/use-containers.md). These docker containers enable you to bring the service closer to your data for compliance, security, or other operational reasons. |

articles/ai-services/language-service/key-phrase-extraction/quickstart.md

@@ -0,0 +1,53 @@
+---
+author: jboback
+manager: nitinme
+ms.service: azure-ai-language
+ms.topic: include
+ms.date: 02/16/2025
+ms.author: jboback
+---
+
+## Prerequisites
+
+* [Create a Project in Foundry in the Azure AI Foundry Portal](../../../../../ai-studio/how-to/create-projects.md)
+
+## Navigate to the Azure AI Foundry Playground
+
+Using the left side pane, select **Playgrounds**. Then select the **Try the Language Playground** button.
+
+:::image type="content" source="../../media/quickstarts/azure-ai-foundry/foundry-playground-navigation.png" alt-text="The development lifecycle" lightbox="../../media/quickstarts/azure-ai-foundry/foundry-playground-navigation.png":::
+
+## Use Language Detection in the Azure AI Foundry Playground
+
+The **Language Playground** consists of four sections:
+
+* Top banner: You can select any of the currently available Language services here.
+* Right pane: This pane is where you can find the **Configuration** options for the service, such as the API and model version, along with features specific to the service.
+* Center pane: This pane is where you enter your text for processing. After the operation is run, some results are shown here.
+* Right pane: This pane is where **Details** of the run operation are shown.
+
+Here you can select the Language Detection capability by choosing the top banner tile, **Detect language**.
+
+## Use Detect language
+
+**Detect language** is designed to identify the language typed in text.
+
+In **Configuration** there are the following options:
+
+|Option              |Description                              |
+|--------------------|-----------------------------------------|
+|Select API version  | Select which version of the API to use.    |
+|Select model version| Select which version of the model to use.|
+|Select country hint| Select the origin country of the input text. |
+
+After your operation is completed, the **Details** section contains the following fields for the most detected language and script:
+
+|Field | Description                |
+|------|----------------------------|
+|Sentence|
+|Iso 639-1 Code| The ISE 639-1 code for the most detected language.|
+|Confidence Score| How confident the model is in the correctness of identification of the most typed language.|
+|Script Name| The name of the most detected script in the text.
+|Iso 15924 Script Code| The ISO 15924 script code for the most detected script.|
+
+:::image type="content" source="../../media/quickstarts/azure-ai-foundry/language-detection.png" alt-text="A screenshot of an example of detect language in azure AI studio." lightbox="../../media/quickstarts/azure-ai-foundry/language-detection.png":::