你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

如何检测和编辑个人身份信息 (PII)

项目
11/19/2024

PII 功能可以评估非结构化文本，并跨多个预定义类别提取和编修文本中的敏感信息 (PII) 和健康状况信息 (PHI)。

开发选项

若要使用 PII 检测，需在应用程序中提交文本进行分析并处理 API 输出。分析按原样执行，不会对数据所用的模型进行自定义。可通过两种方式使用 PII 检测：

开发选项	说明
Language Studio	Language Studio 是一个基于 Web 的平台，让你可以在没有 Azure 帐户的情况下尝试使用文本示例进行实体链接，并在注册时使用自己的数据。有关详细信息，请参阅 Language Studio 网站或 Language Studio 快速入门。
REST API 或客户端库 (Azure SDK)	使用 REST API 或以各种语言提供的客户端库将 PII 检测集成到应用程序中。有关详细信息，请参阅 PII 检测快速入门。

确定如何处理数据（可选）

指定 PII 检测模型

默认情况下，此功能对文本使用最新的可用 AI 模型。你还可以将 API 请求配置为使用特定模型版本。

输入语言

提交要处理的文档时，可以指定在编写这些文档时采用哪种受支持的语言。如果未指定语言，则提取将默认为英语。 API 可能会在响应中返回偏移量，以支持不同的多语言和表情符号编码。

修订策略（仅限版本 2024-11-5-preview）

在版本 2024-11-5-preview 中，可以定义 redactionPolicy 参数，以反映在响应中编辑文档时要使用的修订策略。策略字段支持 3 种策略类型：

DoNotRedact
MaskWithCharacter（默认值）
MaskWithEntityType

DoNotRedact 策略允许用户在没有 redactedText 字段的情况下返回响应。

MaskWithRedactionCharacter 策略允许使用字符屏蔽 redactedText，从而保留原始文本的长度和偏移量。这是现有行为。

还有一个名为 redactionCharacter 的可选字段，可以在其中输入在修订中使用的字符（如果使用 MaskWithCharacter 策略）

通过 MaskWithEntityType 策略，可以使用检测到的实体类型屏蔽检测到的 PII 实体文本。

提交数据

在收到请求时执行分析。同步使用 PII 检测功能是无状态的。不会在帐户中存储数据，结果会立即在响应中返回。

在以异步方式使用此功能时，API 结果在引入请求时的 24 小时内可用，并在响应中指示。在此时间段后，结果将被清除，并且不再可用于检索。

选择要返回的实体

此 API 会尝试检测给定文档语言的已定义实体类别。如果要指定将检测并返回哪些实体，请使用可选的 piiCategories 参数指定相应的实体类别。此参数还可以检测默认情况下未为文档语言启用的实体。以下示例仅检测 Person。可以指定一种或多种要返回的实体类型。

提示

如果在指定实体类别时不包括 default，则 API 将仅返回指定的实体类别。

输入：

注意

在此示例中，仅返回“person”实体类型：

https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

{
    "kind": "PiiEntityRecognition",
    "parameters": 
    {
        "modelVersion": "latest",
        "piiCategories" :
        [
            "Person"
        ]
    },
    "analysisInput":
    {
        "documents":
        [
            {
                "id":"1",
                "language": "en",
                "text": "We went to Contoso foodplace located at downtown Seattle last week for a dinner party, and we adore the spot! They provide marvelous food and they have a great menu. The chief cook happens to be the owner (I think his name is John Doe) and he is super nice, coming out of the kitchen and greeted us all. We enjoyed very much dining in the place! The pasta I ordered was tender and juicy, and the place was impeccably clean. You can even pre-order from their online menu at www.contosofoodplace.com, call 112-555-0176 or send email to order@contosofoodplace.com! The only complaint I have is the food didn't come fast enough. Overall I highly recommend it!"
            }
        ]
    },
    "kind": "PiiEntityRecognition", 
    "parameters": { 
        "redactionPolicy": { 
            "policyKind": "MaskWithCharacter"  
             //MaskWithCharacter|MaskWithEntityType|DoNotRedact 
            "redactionCharacter": "*"  
}

输出：


{
    "kind": "PiiEntityRecognitionResults",
    "results": {
        "documents": [
            {
                "redactedText": "We went to Contoso foodplace located at downtown Seattle last week for a dinner party, and we adore the spot! They provide marvelous food and they have a great menu. The chief cook happens to be the owner (I think his name is ********) and he is super nice, coming out of the kitchen and greeted us all. We enjoyed very much dining in the place! The pasta I ordered was tender and juicy, and the place was impeccably clean. You can even pre-order from their online menu at www.contosofoodplace.com, call 112-555-0176 or send email to order@contosofoodplace.com! The only complaint I have is the food didn't come fast enough. Overall I highly recommend it!",
                "id": "1",
                "entities": [
                    {
                        "text": "John Doe",
                        "category": "Person",
                        "offset": 226,
                        "length": 8,
                        "confidenceScore": 0.98
                    }
                ],
                "warnings": []
            }
        ],
        "errors": [],
        "modelVersion": "2021-01-15"
    }
}

获取 PII 结果

从 PII 检测获得结果时，可以将结果流式传输到应用程序或将输出保存到本地系统上的文件中。 API 响应包括识别的实体，包括其类别和子类别，以及置信度分数。还将返回 PII 实体经过编辑的文本字符串。

服务和数据限制

有关每分钟和每秒可以发送的请求大小和数量信息，请参阅服务限制一文。

后续步骤

命名实体识别概述

通过