> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/kr/api.md).

# API 문서: 채팅

## **소개**

GGWP는 채팅 데이터 처리와 채팅 애플리케이션 워크플로우에 작업을 통합하는 데 사용할 수 있는 API를 제공합니다. 이 제품은 메시지 수준에서 관련 이벤트를 식별하는 것은 물론, 대화 전체의 진행과 각 개별 사용자의 기여도를 추적하도록 설계되었습니다. GGWP는 인시던트(긍정적 및 부정적), 대화의 분위기, 사용자 평판 점수 생성 등을 감지할 수 있습니다.

## 온보딩 가이드

API를 사용하기 전에, 이 제품이 어떻게 작동하는지 이해하는 것이 중요합니다. 그래야 그 잠재력을 최대한 활용할 수 있습니다.

### **GGWP의 채팅 모더레이션 이해하기**

GGWP의 채팅 모더레이션 서비스는 3가지 사용 사례를 다룹니다:

* 실시간 콘텐츠 필터링 - 이 API를 사용하면 심각도와 주제 선택에 대한 사용자 지정 설정을 만들어, 특정 커뮤니티에서 차단하고자 하는 콘텐츠 유형을 막을 수 있습니다.
* 대화 분석 - GGWP의 사용자 평판 시스템과 대화의 문맥 요소를 결합하여, 세션 내 긍정적 및 부정적 인시던트에 대한 누적된 보기를 제공하도록 설계되었습니다. 이는 클라이언트 측의 다양한 경고 또는 알림과 통합할 수 있습니다.
* 자동 모더레이션 서비스 - 음소거, 정지, 차단을 통해 유해한 플레이어에 대한 제재를 자동화하여, 문제를 일으킨 플레이어에게 충분히 진정할 시간을 주고 다른 플레이어에게 미치는 추가적인 영향을 방지할 수 있도록 합니다. 이 시스템은 인시던트의 심각도, 탐지 신뢰도, 플레이어 기록 및 세션 행동을 고려하여 언제, 얼마 동안 플레이어를 처벌할지 결정합니다.

각 개별 메시지 또는 메시지 블록마다 1회의 API 호출을 수행해야 하며, 여기에는 보낸 사람과 세션을 식별하기 위한 기본 정보도 포함됩니다(자세한 내용은 아래 “Chat API” 섹션 참조). GGWP가 관련 인사이트를 제공하기 위해 모든 처리 단계를 담당합니다.

응답이 반환되면, 플랫폼에서 사용자 경험을 향상시키기 위해 다양한 작업을 통합하는 것을 권장합니다. 예를 들어 원본 메시지를 필터링된 버전으로 교체하거나, 사용자 경고를 보내거나, 가장 방해가 되는 참여자를 음소거할 수 있습니다.

### **구성 가능한 설정**

플랫폼에서 차단하고자 하는 콘텐츠 유형을 선택하기 위해 사용자 지정 설정을 정의할 수 있습니다. 이는 2가지 방법으로 수행할 수 있습니다:

* 온보딩 시점(권장) - 필요한 구성을 계정 관리자와 공유하면 GGWP가 이를 귀하의 특정 API 설정에 반영합니다.
* 각 API 호출 시 - 헤더를 사용하여 API 호출을 할 때마다 일부 사용자 지정 설정을 입력할 수도 있습니다(자세한 내용은 “Chat API” 섹션 참조). 모든 사용자 지정 요소를 제공할 수 있는 것은 아니므로 몇 가지 제한이 있으며 오류가 발생하기 더 쉽습니다.

또한 GGWP의 자동 모더레이션 서비스를 활성화하고 싶으시다면, GGWP 계정 관리자에게 문의해 주세요.

구성할 수 있는 항목 목록은 다음과 같습니다:

* **주제**: 사용 가능한 주제에는 폭력, 성적 콘텐츠, 언어적 학대, 정체성 혐오, 욕설, 링크 공유, 약물, 스팸, 자해가 포함됩니다.
* **필터 강도**: Chat API의 필터 강도 구성은 안전이라는 상위 렌즈를 기반으로 합니다. 일반적으로 각 주제마다 선택할 수 있는 값은 4가지이며, 몇 가지 예외가 있습니다. 이 4가지 값은 다음과 같습니다:
  * 필터 강도 = “꺼짐” - 필터가 활성화되지 않으므로 모든 형태의 유해성이 허용됩니다. 제한을 두고 싶지 않은 성인 환경에 적합합니다.
  * 필터 강도 = “낮음” - 매우 심한 콘텐츠만 필터링하고, 중간 및 낮은 수준의 유해성은 통과시킵니다. 성인만 있는 환경에 적합합니다.
  * 필터 강도 = “중간” - 극단적이고 중간 수준의 유해성을 걸러내고, 경미한 유해성만 통과시킵니다. 일부 무해한 유해성은 허용 가능한 청소년 환경에 적합합니다.
  * 필터 강도 = “높음” - 모든 형태의 유해성을 필터링합니다. 어린이가 있는 환경에 적합합니다.
* **사용자 지정 콘텐츠:** 설정에 반영하고 싶은 사용자 지정 허용 목록, 차단 목록 또는 대체 문구 목록(유해한 메시지를 대신해 사용할 문구)이 있다면, 파일을 공유해 주실 수 있도록 GGWP 계정 관리자에게 문의해 주세요.

### **언어 지원**

GGWP의 채팅 모더레이션 서비스는 다음 언어를 지원합니다: 

* 아랍어
* 중국어(간체 및 번체)
* 네덜란드어
* 영어
* 필리핀어(타갈로그어)
* 핀란드어
* 프랑스어
* 독일어
* 그리스어
* 히브리어
* 힌디어
* 인도네시아어
* 이탈리아어
* 일본어
* 한국어
* 페르시아어
* 폴란드어
* 포르투갈어
* 러시아어
* 스페인어
* 태국어
* 터키어
* 베트남어

새로운 언어는 정기적으로 추가됩니다. 예정된 언어에 대해 알아보거나 추가 언어를 검토 대상으로 제출하려면 계정 관리자에게 문의해 주세요.

### **모델 지원**

GGWP의 채팅 모더레이션이 다루는 카테고리는 [모델 용어집 섹션](/kr/text-and-voice-model-glossary.md).