Skip to content

Commit c607b50

Browse files
authored
Merge pull request #114188 from tchristiani/AzS-custom-skills-video-embed
AzS: added video ships and link
2 parents 67eb888 + 0ebd246 commit c607b50

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

articles/search/cognitive-search-custom-skill-interface.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,13 @@ author: luiscabrer
88
ms.author: luisca
99
ms.service: cognitive-search
1010
ms.topic: conceptual
11-
ms.date: 02/20/2020
11+
ms.date: 05/06/2020
1212
---
1313

1414
# How to add a custom skill to an Azure Cognitive Search enrichment pipeline
1515

16+
> [!VIDEO https://www.youtube.com/embed/fHLCE-NZeb4?version=3&start=172&end=221]
17+
1618
An [enrichment pipeline](cognitive-search-concept-intro.md) in Azure Cognitive Search can be assembled from [built-in cognitive skills](cognitive-search-predefined-skills.md) as well as [custom skills](cognitive-search-custom-skill-web-api.md) that you personally create and add to the pipeline. In this article, learn how to create a custom skill that exposes an interface allowing it to be included in an AI enrichment pipeline.
1719

1820
Building a custom skill gives you a way to insert transformations unique to your content. A custom skill executes independently, applying whatever enrichment step you require. For example, you could define field-specific custom entities, build custom classification models to differentiate business and financial contracts and documents, or add a speech recognition skill to reach deeper into audio files for relevant content. For a step-by-step example, see [Example: Creating a custom skill for AI enrichment](cognitive-search-create-custom-skill-example.md).
@@ -36,6 +38,10 @@ Currently, the only mechanism for interacting with a custom skill is through a W
3638

3739
### 1. Web API Input Format
3840

41+
42+
> [!VIDEO https://www.youtube.com/embed/fHLCE-NZeb4?version=3&start=294&end=340]
43+
44+
3945
The Web API must accept an array of records to be processed. Each record must contain a "property bag" that is the input provided to your Web API.
4046

4147
Suppose you want to create a simple enricher that identifies the first date mentioned in the text of a contract. In this example, the skill accepts a single input *contractText* as the contract text. The skill also has a single output, which is the date of the contract. To make the enricher more interesting, return this *contractDate* in the shape of a multi-part complex type.
@@ -154,8 +160,9 @@ When you create a Web API enricher, you can describe HTTP headers and parameters
154160

155161
This article covered the interface requirements necessary for integrating a custom skill into a skillset. Click the following links to learn more about custom skills and skillset composition.
156162

163+
+ [Watch our video about custom skills](https://youtu.be/fHLCE-NZeb4)
157164
+ [Power Skills: a repository of custom skills](https://github.com/Azure-Samples/azure-search-power-skills)
158165
+ [Example: Creating a custom skill for AI enrichment](cognitive-search-create-custom-skill-example.md)
159166
+ [How to define a skillset](cognitive-search-defining-skillset.md)
160167
+ [Create Skillset (REST)](https://docs.microsoft.com/rest/api/searchservice/create-skillset)
161-
+ [How to map enriched fields](cognitive-search-output-field-mapping.md)
168+
+ [How to map enriched fields](cognitive-search-output-field-mapping.md)

0 commit comments

Comments
 (0)