> 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/jp/apidokyumento-chat.md).

# APIドキュメント: Chat

## **はじめに**

GGWP は、チャットデータの処理やチャットアプリケーションのワークフローへのアクション統合に利用できる API を提供します。この製品は、メッセージ単位で関連イベントを特定するとともに、会話全体の推移や各ユーザーの貢献を追跡できるよう設計されています。GGWP は、インシデント（ポジティブ／ネガティブ）の検出、会話の温度の分析、ユーザーのレピュテーションスコアの生成などを行うことができます。

## 導入ガイド

API の利用を始める前に、この製品がどのように動作するのかを理解することが、その機能を最大限に引き出すうえで重要です。

### **GGWP のチャットモデレーションの理解**

GGWP のチャットモデレーションサービスは、3 つのユースケースをカバーします。

* リアルタイムのコンテンツフィルタリング - この API を使うと、重大度やトピック選択のカスタム設定を作成できるため、特定のコミュニティで防ぎたいコンテンツの種類をブロックできます。
* 会話分析 - GGWP のユーザーレピュテーションシステムと会話の文脈要素を組み合わせ、セッション内のポジティブおよびネガティブなインシデントを累積的に把握できるように設計されています。これは、クライアント側でさまざまな種類の警告やアラートと統合できます。
* 自動モデレーションサービス - ミュート、停止、BAN によって攻撃的なプレイヤーへの制裁を自動化し、問題のあるプレイヤーに冷静になる時間を与えて、他のプレイヤーへのさらなる影響を防げるようにします。このシステムでは、インシデントの重大度、検出の信頼度、プレイヤーの履歴、セッション中の行動を考慮して、いつ、どのくらいの期間プレイヤーを罰するかを決定します。

各メッセージ、またはメッセージのブロックごとに 1 回 API を呼び出し、送信者とセッションを識別するための基本情報も含めます（詳細は下記の「Chat API」セクションを参照）。GGWP が必要な処理をすべて行い、関連するインサイトを提供します。

レスポンスが返されたら、プラットフォーム上でのユーザー体験を向上させるために、さまざまなアクションを統合することを推奨します。たとえば、元のメッセージをフィルタリング後の版に置き換える、ユーザーに警告を送る、最も迷惑行為の多い参加者をミュートする、といった対応が考えられます。

### **設定可能な項目**

プラットフォーム上で防ぎたいコンテンツの種類を選択するために、カスタム設定を定義できます。方法は 2 つあります。

* 導入時（推奨）- 必要な設定をアカウントマネージャーと共有すると、GGWP がそれを特定の API 設定に組み込みます。
* 各 API 呼び出し時 - ヘッダーを使用して、API を呼び出すたびに一部のカスタム設定を入力することもできます（詳細は「Chat API」セクションを参照）。ただし、すべてのカスタム要素を指定できるわけではなく、制約があり、エラーも起こりやすくなります。

さらに、GGWP の自動モデレーションサービスを有効にしたい場合は、GGWP のアカウントマネージャーにお問い合わせください。

設定できる項目の一覧は次のとおりです。

* **トピック**：利用可能なトピックには、暴力、性的コンテンツ、言葉による虐待、アイデンティティへの憎悪、罵倒、リンク共有、薬物、スパム、自傷行為があります。
* **フィルター強度**：Chat API におけるフィルター強度の設定は、安全性という上位の観点に基づいています。通常、各トピックに対して選択できる値は 4 つありますが、いくつか例外があります。この 4 つの値は次のとおりです。
  * フィルター強度 =「オフ」- フィルターは有効ではないため、あらゆる形態の有害表現が許可されます。制限を設けたくない成人向け環境に適しています。
  * フィルター強度 =「低」- 非常に攻撃的なコンテンツのみをフィルタリングし、中程度および軽度の有害表現は通過させます。成人のみの環境に適しています。
  * フィルター強度 =「中」- 激しい有害表現と中程度の有害表現を除外し、軽度の有害表現のみを通します。ある程度の無害な有害表現は許容される、ティーンエイジャー向けの環境に適しています。
  * フィルター強度 =「高」- あらゆる形態の有害表現を除外します。子どもがいる環境に適しています。
* **カスタムコンテンツ：** 設定に組み込みたいカスタムの許可リスト、ブロックリスト、または置換フレーズリスト（有害なメッセージの代わりに使用するフレーズ）がある場合は、GGWP のアカウントマネージャーに連絡し、ファイルを共有してください。

### **言語サポート**

GGWP のチャットモデレーションサービスは、以下の言語をサポートしています。 

* アラビア語
* 中国語（簡体字・繁体字）
* オランダ語
* 英語
* フィリピノ語（タガログ語）
* フィンランド語
* フランス語
* ドイツ語
* ギリシャ語
* ヘブライ語
* ヒンディー語
* インドネシア語
* イタリア語
* 日本語
* 韓国語
* ペルシア語
* ポーランド語
* ポルトガル語
* ロシア語
* スペイン語
* タイ語
* トルコ語
* ベトナム語

新しい言語は定期的に追加されています。今後対応予定の言語についてはアカウントマネージャーにお問い合わせいただくか、追加候補の言語をご提案ください。

### **モデルサポート**

GGWP のチャットモデレーションが対象とするカテゴリは、 [モデル用語集セクション](/jp/tekisutomoderu.md).