PII(개인 식별 정보) 검색 및 수정 방법
PII 기능은 미리 정의된 여러 범주의 텍스트에서 구조화되지 않은 텍스트, PII(중요한 정보) 및 PHI(상태 정보)를 추출하고 수정할 수 있습니다.
개발 옵션
PII 감지를 사용하려면 분석을 위해 텍스트를 제출하고 애플리케이션에서 API 출력을 처리합니다. 분석은 데이터에 사용되는 모델에 대한 사용자 지정 없이 있는 그대로 수행됩니다. PII 감지를 사용하는 방법에는 다음 두 가지가 있습니다.
| 개발 옵션 | 설명 |
|---|---|
| Azure AI Foundry | Azure AI Foundry는 등록할 때 사용자 고유의 데이터로 텍스트 예제를 사용하여 개인 식별 정보 검색을 사용할 수 있는 웹 기반 플랫폼입니다. 자세한 내용은 Azure AI Foundry 웹 사이트 또는 Azure AI Foundry 설명서를 참조하세요. |
| REST API 또는 클라이언트 라이브러리(Azure SDK) | REST API 또는 다양한 언어로 제공되는 클라이언트 라이브러리를 사용하여 PII 감지를 애플리케이션에 통합합니다. 자세한 내용은 PII 감지 빠른 시작을 참조하세요. |
데이터 처리 방법 결정(선택 사항)
PII 검색 모델 지정
기본적으로 이 기능은 텍스트에서 사용 가능한 최신 AI 모델을 사용합니다. 특정 모델 버전을 사용하도록 API 요청을 구성할 수도 있습니다.
입력 언어
처리할 입력 텍스트를 제출할 때 지원되는 언어 중 어떤 언어 로 작성되었는지 지정할 수 있습니다. 언어를 지정하지 않으면 추출 기본값은 영어로 설정됩니다. API는 다양한 다국어 및 그림 이모티콘 인코딩을 지원하기 위해 응답에 오프셋을 반환할 수 있습니다.
수정 정책(버전 2024-11-5-preview에만 해당)
버전 2024-11-5-preview에서는 텍스트를 편집할 때 사용할 편집 정책을 반영하도록 매개 변수를 정의 redactionPolicy 할 수 있습니다. 정책 필드는 다음 세 가지 정책 유형을 지원합니다.
DoNotRedact-
MaskWithCharacter(기본값) MaskWithEntityType
이 DoNotRedact 정책을 사용하면 사용자가 "John Doe가 424-878-9192에서 전화를 받았습니다"라는 필드 없이 redactedText 응답을 반환할 수 있습니다.
정책을 MaskWithRedactionCharacter 사용하면 redactedText 문자(예: "*")로 마스킹하여 원래 텍스트의 길이와 오프셋을 유지합니다. 즉, "******** ************ 호출을 받았습니다."입니다. 이는 기존 동작입니다.
정책을 사용하는 MaskWithCharacter 경우 편집에 사용할 문자를 입력할 수 있는 선택 redactionCharacter 적 필드도 있습니다.
이 MaskWithEntityType 정책을 사용하면 검색된 엔터티 형식으로 검색된 PII 엔터티 텍스트를 마스킹할 수 있습니다. 즉, "[PERSON_1]가 [PHONENUMBER_1]에서 전화를 받았습니다."입니다.
데이터 제출
요청을 받으면 분석이 수행됩니다. PII 검색 기능을 동기적으로 사용하는 것은 상태 비저장입니다. 계정에 데이터가 저장되지 않으며, 결과가 응답에서 즉시 반환됩니다.
이 기능을 비동기적으로 사용하는 경우 요청이 수집된 시간부터 24시간 동안 API 결과를 사용할 수 있으며 응답에 표시됩니다. 이 기간이 지나면 결과가 제거되고 더 이상 검색할 수 없습니다.
반환할 엔터티 선택
API는 지정된 입력 텍스트 언어에 대해 정의된 엔터티 범주 를 검색하려고 시도합니다. 검색되고 반환되는 엔터티를 지정하려면 적절한 엔터티 범주와 함께 선택적 piiCategories 매개 변수를 사용합니다. 이 매개 변수를 사용하면 입력 텍스트 언어에 대해 기본적으로 사용하도록 설정되지 않은 엔터티를 검색할 수도 있습니다. 다음 예에서는 Person만 검색합니다. 반환할 엔터티 형식을 하나 이상 지정할 수 있습니다.
팁
엔터티 범주를 지정할 때 포함하지 default 않는 경우 API는 지정한 엔터티 범주만 반환합니다.
입력:
참고 항목
이 예제에서는 사용자 엔터티 형식만 반환합니다.
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 엔터티가 수정된 텍스트 문자열도 반환됩니다.
서비스 및 데이터 제한
분당 및 초당 보낼 수 있는 요청의 크기와 수에 대한 내용은 서비스 제한 문서를 참조하세요.