README.md

topic	languages	products	name	description	azureDeploy
sample	csharp	azure-cognitive-services	Custom Entity Search sample skill for cognitive search	This custom skill finds user defined entities in given texts.	https://raw.githubusercontent.com/Azure-Samples/azure-search-power-skills/main/Text/CustomEntityLookup/azuredeploy.json

CustomEntityLookup

This custom skill finds finds user defined entities in given texts.

Requirements

These skills have no additional requirements than the ones described in the root README.md file.

Settings

This function by default performs exact matches with no synonym detection. Based on user input in the JSON file or in the posted values, this skill can perform fuzzy matching on some or all of the entities provided. The input field "words" is optional, where a user can add a "words.json" file instead.

Sample CSV Config File (comma or new line delineated terms)

wordToFind1,wordToFind2,
wordToFind3
oscar
rodger
over
lastWordToFind

Sample JSON Config File (complex entity definitions)

[ 
    { 
        "name" : "FindThisStringAsAnExactMatchOnly" 
    }, 
    { 
        "name" : "Bill Gates", 
        "description" : "This document references William Henry Gates III, founder of Microsoft. Not to be confused with a series of barriers made of invoices."  
    }, 
    { 
        "name" : "Satya Nadella",
        "type" : "Person",
        "subtype" : "CEO",
        "id" : "4e36bf9d-5550-4396-8647-8e43d7564a76",
        "description" : "This document references Satya Narayana Nadella."
    }, 
    { 
        "name" : "MSFT" , 
        "description" : "This document refers to Microsoft the company. Likely in a financial capacity", 
        "id" : "differentIdentifyingScheme123", 
        "caseSensitive" : true,
        "accentSensitive" : true, 
        "fuzzyEditDistance" : 0 
    }, 
    { 
        "name" : "Microsoft" , 
        "description" : "This document refers to Microsoft the company.", 
        "id" : "differentIdentifyingScheme987", 
        "defaultCaseSensitive" : false, 
        "defaultAccentSensitive" : false, 
        "defaultFuzzyEditDistance" : 1, 
        "aliases" : [
            { 
                "text" : "Macrosofty" 
            }, 
            { 
                "text" : "MSFT", 
                "caseSensitive" : true 
            }, 
            { 
                "text" : "Windows 10", 
                "fuzzyEditDistance" : 3 
            }, 
            { 
                "text" : "Xbox", 
                  "accentSensitive" : true 
            } 
        ]
    } 
]

Sample Input:

{
    "values": [
        {
            "recordId": "1",
            "data":
            {
                "text":  "Learn how to leverage Azure Storage in your applications with our quickstarts and tutorials.",
            }
        },
        {
            "recordId": "foo1",
            "data":
            {
                "text":  "Azure Storage includes Azure Blobs (objects), Azure Data Lake Storage Gen2, Azure Files, Azure Queues, and Azure Tables.",
            }
        }
    ]
}

Sample Output:

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "Entities": [
                    {
                        "name": "learn",
                        "matches": [
                            {
                                "text": "Learn",
                                "offset": 1,
                                "length": 6,
                                "matchDistance": 1.0
                            }
                        ]
                    },
                    {
                        "name": "app",
                        "matches": [
                            {
                                "text": "app",
                                "offset": 45,
                                "length": 3,
                                "matchDistance": 0.0
                            }
                        ]
                    }
                ]
            },
            "errors": [],
            "warnings": []
        },
        {
            "recordId": "foo1",
            "data": {
                "Entities": []
            },
            "errors": [],
            "warnings": []
        }
    ]
}

Sample Skillset Integration

In order to use this skill in a cognitive search pipeline, you'll need to add a skill definition to your skillset. Here's a sample skill definition for this example (inputs and outputs should be updated to reflect your particular scenario and skillset environment):

{
    "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
    "description": "Our Custom Entity Lookup custom skill",
    "context": "/document/merged_content/*",
    "uri": "[AzureFunctionEndpointUrl]/api/custom-entity-lookup?code=[AzureFunctionDefaultHostKey]",
    "batchSize": 1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content/"
        },
        {
            "name": "words",
            "source": "/document/merged_content/*"
        }
    ],
    "outputs": [
        {
            "name": "EntitiesFound",
            "targetName": "EntitiesFound"
        },
        {
            "name": "Entities",
            "targetName": "Entities"
        }
    ]
}