API 콘솔에서 사용자 지정 용어 목록을 사용하여 조정

아티클
02/13/2024

Azure Content Moderator에서 기본 전역 용어 목록은 대부분의 콘텐츠 조정 요구에 적합합니다. 그러나 조직에 관련된 용어에 대해 차단해야 할 수 있습니다. 예를 들어 추가 검토를 위해 경쟁 업체 이름에 태그를 지정할 수 있습니다.

목록 관리 API를 사용하여 텍스트 조정 API와 함께 사용할 사용자 지정 용어 목록을 만듭니다. 텍스트 - 차단 작업은 텍스트에서 욕설을 검색하고 사용자 지정 및 공유 차단 목록에 대해 텍스트를 비교합니다.

참고 항목

최대 5개 용어 목록으로 제한되고, 각 목록은 10,000개 용어를 초과하지 않아야 합니다.

목록 관리 API를 사용하여 다음 작업을 수행할 수 있습니다.

목록을 만듭니다.
목록에 용어를 추가합니다.
목록의 용어에 대해 용어를 차단합니다.
목록에서 용어를 삭제합니다.
목록을 삭제합니다.
목록 정보를 편집합니다.
목록에 대한 변경 내용이 새 검색에 포함되도록 인덱스를 새로 고칩니다.

API 콘솔 사용

온라인 콘솔에서 API를 테스트하려면 구독 키가 필요합니다. 이 키는 Ocp-Apim-Subscription-Key 상자의 설정 탭에 있습니다. 자세한 내용은 개요를 참조하세요.

검색 인덱스 새로 고침

용어 목록을 변경한 후 이후 검색에 포함되도록 변경 내용에 대한 해당 인덱스를 새로 고쳐야 합니다. 이 단계는 데스크톱의 검색 엔진(활성화된 경우) 또는 웹 검색 엔진이 새 파일 또는 페이지를 포함하도록 해당 인덱스를 지속적으로 새로 고치는 방법과 유사합니다.

용어 목록 관리 API 참조의 왼쪽 메뉴에서 용어 목록, 검색 인덱스 새로 고침을 차례로 선택합니다.

용어 목록 - 검색 인덱스 새로 고침 페이지가 열립니다.
개방형 API 테스트 콘솔의 경우 사용자 위치를 가장 근접하게 설명하는 지역을 선택합니다.

용어 목록 - 검색 인덱스 새로 고침 API 콘솔이 열립니다.
listId 상자에 목록 ID를 입력합니다. 구독 키를 입력한 다음, 보내기를 선택합니다.

용어 목록 만들기

용어 목록 관리 API 참조로 이동합니다.

용어 목록 - 만들기 페이지가 열립니다.
개방형 API 테스트 콘솔의 경우 사용자 위치를 가장 근접하게 설명하는 지역을 선택합니다.

용어 목록 - 만들기 API 콘솔이 열립니다.
Ocp-Apim-Subscription-Key 상자에 구독 키를 입력합니다.
요청 본문 상자에 이름(예: MyList) 및 설명에 대한 값을 입력합니다.
키-값 쌍 자리 표시자를 사용하여 목록에 보다 설명적인 메타데이터를 지정합니다.
```
{
    "Name": "MyExclusionList",
    "Description": "MyListDescription",
    "Metadata": 
    {
        "Category": "Competitors",
        "Type": "Exclude"
    }
}
```
키-값 쌍으로 실제 용어가 아닌 목록 메타데이터를 추가합니다.
보내기를 선택합니다. 목록이 생성됩니다. 새 목록과 연결된 ID입니다. 다른 용어 목록 관리 기능에 이 ID가 필요합니다.
MyList에 용어를 추가합니다. 왼쪽 메뉴의 용어 아래에서 용어 추가를 선택합니다.

용어 - 용어 추가 페이지가 열립니다.
개방형 API 테스트 콘솔의 경우 사용자 위치를 가장 근접하게 설명하는 지역을 선택합니다.

용어 - 용어 추가 API 콘솔이 열립니다.
listId 상자에 생성한 목록 ID를 입력하고, 언어에 대한 값을 선택합니다. 구독 키를 입력한 다음, 보내기를 선택합니다.
목록에 용어가 추가되었는지 확인하려면 왼쪽 메뉴에서 용어를 선택한 다음, 모든 용어 가져오기를 선택합니다.

용어 - 모든 용어 가져오기 API 콘솔이 열립니다.
listId 상자에 목록 ID를 입력한 다음, 등록 키를 입력합니다. 보내기를 선택합니다.
응답 콘텐츠 상자에서 입력한 용어를 확인합니다.
몇 가지 용어를 추가합니다. 이제 사용자 지정 용어 목록을 만들었으므로 사용자 지정 용어 목록을 사용하여 일부 텍스트 검사를 시도합니다.

용어 및 목록 삭제

용어 또는 목록을 삭제하는 것은 간단합니다. API를 사용하여 다음 작업을 수행합니다.

용어를 삭제합니다. (용어 - 삭제)
목록을 삭제하지 않고 목록의 모든 용어를 삭제합니다. (용어 - 모든 용어 삭제)
목록 및 모든 해당 콘텐츠를 삭제합니다. (용어 목록 - 삭제)

이 예제에서는 단일 용어를 삭제합니다.

용어 목록 관리 API 참조의 왼쪽 메뉴에서 용어, 삭제를 차례로 선택합니다.

용어 - 삭제가 열립니다.
개방형 API 테스트 콘솔의 경우 사용자 위치를 가장 근접하게 설명하는 지역을 선택합니다.

용어 - 삭제 API 콘솔이 열립니다.
listId 상자에 용어를 삭제하려는 목록의 ID를 입력합니다. 이 ID는 MyList에 대해 용어 목록 - 세부 정보 가져오기 콘솔에서 반환되는 번호입니다(예제에서 122). 용어를 입력하고 언어를 선택합니다.
구독 키를 입력한 다음, 보내기를 선택합니다.
용어가 삭제되었는지 확인하려면 용어 목록 - 모두 가져오기 콘솔을 사용합니다.

목록 정보 변경

목록의 이름 및 설명을 편집하고, 메타데이터 항목을 추가할 수 있습니다.

용어 목록 관리 API 참조의 왼쪽 메뉴에서 용어 목록, 세부 정보 업데이트를 차례로 선택합니다.

용어 목록 -세부 정보 업데이트 페이지가 열립니다.
개방형 API 테스트 콘솔의 경우 사용자 위치를 가장 근접하게 설명하는 지역을 선택합니다.

용어 목록 -세부 정보 업데이트 API 콘솔이 열립니다.
listId 상자에 목록 ID를 입력한 다음, 등록 키를 입력합니다.
요청 본문 상자에서 편집을 수행한 다음, 보내기를 선택합니다.

다음 단계

코드에서 REST API를 사용하거나 용어 목록 .NET 빠른 시작을 시작하여 애플리케이션을 통합합니다.