빠른 시작: 텍스트에 대한 보호자료감지(미리 보기)
텍스트용 보호 자료 기능은 AI 생성 콘텐츠(영어 콘텐츠에만 해당)와 관련된 위험을 관리하기 위한 포괄적인 솔루션을 제공합니다. 조직은 보호된 자료의 표시를 감지하고 방지함으로써 지적 재산권법을 준수하고, 콘텐츠 독보성을 유지하고, 평판을 보호할 수 있습니다. 보호된 자료는 노래 가사, 기사, 조리법 또는 기타 선택한 웹 콘텐츠와 같은 저작권이 있는 출처의 알려진 텍스트와 일치하는 콘텐츠를 나타냅니다.
AI 생성 콘텐츠에 대한 텍스트 보호 자료 검색 기능의 주요 목표는 다음과 같습니다.
- AI 모델에서 생성된 보호된 콘텐츠의 표시를 감지하고 방지합니다.
- 조직에서 AI 생성 콘텐츠와 관련된 위험을 관리할 수 있도록 합니다.
- AI에서 생성된 콘텐츠가 법적, 윤리적 및 콘텐츠 정책 지침을 준수하는지 확인합니다.
보호자료감지에 대한 자세한 내용은 보호자료감지 개념 페이지를 참조하세요. API 입력 제한에 대해서는 개요의 입력 요구 사항 섹션을 참조하세요.
필수 조건
- Azure 구독 - 체험 구독 만들기
- Azure 구독이 있으면 Azure Portal에서 콘텐츠 안전 리소스를 생성하여 키와 엔드포인트를 가져옵니다. 리소스의 고유한 이름을 입력하고 구독을 선택한 다음 리소스 그룹, 지원되는 지역(지역 가용성 참조) 및 지원되는 가격 책정 계층을 선택합니다. 다음으로 만들기를 선택합니다.
- 리소스를 배포하는 데 몇 분 정도 걸립니다. 완료되면 리소스로 이동을 선택합니다. 왼쪽 창의 리소스 관리에서 구독 키 및 엔드포인트를 선택합니다. 엔드포인트와 키 중 하나는 API를 호출하는 데 사용됩니다.
- cURL 설치
보호 자료 감지를 위한 텍스트 분석
다음 섹션에서는 cURL을 사용한 샘플 요청을 안내합니다. 아래 명령을 텍스트 편집기에 붙여넣고 다음과 같이 변경합니다.
<endpoint>을(를) 리소스와 연결된 엔드포인트 URL로 바꾸세요.<your_subscription_key>을 리소스와 함께 제공되는 키 중 하나로 바꾸세요.- 선택적으로 본문의
"text"필드를 분석하려는 텍스트로 바꿉니다.팁
최대 텍스트 길이 제한 사항은 입력 요구 사항을 참조하세요. 보호 자료 감지는 사용자 프롬프트가 아닌 LLM 완료 시 실행되어야 합니다.
curl --location --request POST '<endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"text": "Kiss me out of the bearded barley Nightly beside the green, green grass Swing, swing, swing the spinning step You wear those shoes and I will wear that dress Oh, kiss me beneath the milky twilight Lead me out on the moonlit floor Lift your open hand Strike up the band and make the fireflies dance Silver moon's sparkling So, kiss me Kiss me down by the broken tree house Swing me upon its hanging tire Bring, bring, bring your flowered hat We'll take the trail marked on your father's map."
}'
아래 필드가 URL에 포함되어야 합니다.
| 이름 | 필수 여부 | 설명 | Type |
|---|---|---|---|
| API 버전 | Required | 확인할 API 버전입니다. 현재 버전은 api-version=2024-09-01입니다. 예: <endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01 |
문자열 |
요청 본문의 매개 변수는 다음 표에 정의되어 있습니다.
| 이름 | 필수 여부 | 설명 | Type |
|---|---|---|---|
| text | Required | 확인할 원시 텍스트입니다. ASCII가 아닌 다른 문자도 포함될 수 있습니다. | 문자열 |
다음 샘플 요청 본문을 참조하세요.
{
"text": "string"
}
명령 프롬프트 창을 열고 cURL 명령을 실행합니다.
API 응답 해석
콘솔 출력에 JSON 데이터로 표시되는 보호 자료 감지 결과가 표시되어야 합니다. 예시:
{
"protectedMaterialAnalysis": {
"detected": true
}
}
출력의 JSON 필드는 다음과 같이 정의됩니다.
| 이름 | Description | Type |
|---|---|---|
| protectedMaterialAnalysis | API가 예측하는 각 출력 클래스입니다. | 문자열 |
| 감지됨 | 보호 자료가 감지되었는지 여부입니다. | 부울 |
리소스 정리
Azure AI 서비스 구독을 정리하고 제거하려면 리소스 또는 리소스 그룹을 삭제할 수 있습니다. 리소스 그룹을 삭제하면 해당 리소스 그룹에 연결된 다른 모든 리소스가 함께 삭제됩니다.
관련 콘텐츠
- 보호자료감지:
- 각 범주에 대한 필터를 구성하고 콘텐츠 안전 스튜디오를 사용하여 데이터 세트에서 테스트하고 코드를 내보내고 배포합니다.