logo
Development
検索
アラーム通知

アラーム通知

アラームの種類

image-20241226194156222

GPTBotsの「組織 - アラーム通知」機能では、アラーム関連の設定を試すことができます。
GPTBotsのアラーム通知機能は、ビジネスのシチュエーションにより3つのタイプに分けられます。

  • 利用量アラーム:クレジットとサブスクリプションプランに関連するアラームです。これには、クレジット残高のアラーム、クレジット使用量のアラーム、サブスクリプションプランのアラームが含まれます。
  • ビジネスアラーム:エージェントのビジネスのシチュエーションに関連するアラームです。これには、エージェントの対話RPMレートの上限超過、エージェントの対話のRPMレートのトリガーカウントのアラーム、エージェントの対話における異常な回答数が上限設定を超えた場合のアラームが含まれます。
  • 問題分類アラーム:エージェントの対話中に問題の分類回数に関連するシチュエーションのアラームです。

アラームルール設定

アラームの項目

image-20241226194534946

アラームの種類を選択した後、その種類の下に表示される「アラーム追加」をクリックして、アラーム設定を開始します。

アラーム設定を行う際には、具体的なアラーム項目を選択する必要があります。例えば、クレジットの残高などです。
ビジネスアラームでは、対象となるエージェントの選択が必要です。問題分類アラームでは、対象となるエージェントと対象となる問題分類の両方を選択する必要があります。

アラームルール

アラームルールとは、アラームを発動する条件のことを指します。これらの条件が満たされたときにアラームが発動します。

通知頻度

通知頻度は、アラームがどの程度の頻度で送信されるかを設定します。アラームが発動したら、ユーザー自身で通知頻度を設定することができます。

通知チャネル

image-20241226194739578

GPTBotsでは、Email、SMS、WhatsApp、Webhookの4つの通知手段をサポートしています。通知方法を選択し、通知メンバーを追加します。アラームが発生した場合、GPTBotsは選択した方法とメンバーの連絡先詳細に基づいて通知を送信します。

アラームWebhookの設定

このWebhookは、アラーム通知を受け取るために用います。POSTリクエストを使って、クライアントはアラームのタイトル、発生時間、内容などの情報を指定したWebhook URLに送信することができます。
リクエストURL

  • URL: ダイナミックに設定されたWebhook URL
  • Method: POST
  • Content-Type: application/json
    リクエストヘッダ
    Username: webhookClientId
    Secret: webhookClientSecret
    ヘッダ 必須 説明
    Content-Type 必須 リクエストボディのコンテンツタイプ、固定で application/json
    Authorization 必須 webhookClientId および webhookClientSecret の両方が設定されている場合、このヘッダが必要です。
    認証について
  • webhookClientIdwebhookClientSecret の両方が存在している場合、以下の形式の基本認証が使用されます:
Authorization: Basic Base64(clientId:clientSecret)
                      
                      Authorization: Basic Base64(clientId:clientSecret)

                    
このコードブロックをポップアップで表示
  • webhookClientId のみ存在している場合、次のフォーマットのBearer認証を使用します:
Authorization: Bearer clientId
                      
                      Authorization: Bearer clientId

                    
このコードブロックをポップアップで表示
  • webhookClientSecret のみ存在している場合、次のフォーマットのBearer認証を使用します:
Authorization: Bearer clientSecret
                      
                      Authorization: Bearer clientSecret

                    
このコードブロックをポップアップで表示

リクエストボディ
リクエストボディはJSON形式で、以下のフィールドを含みます:

フィールド タイプ 必須 説明
title String 必須 アラームのタイトル
time Long 必須 アラームのタイムスタンプ (ミリ秒単位)
content String 必須 アラームの具体的な内容
Example:
{ "title": "CPU使用率アラーム", "time": 1698745600000, "content": "過去5分間におけるCPUの使用率が90%を超過しました。" }
                      
                      {
  "title": "CPU使用率アラーム",
  "time": 1698745600000,
  "content": "過去5分間におけるCPUの使用率が90%を超過しました。"
}

                    
このコードブロックをポップアップで表示

注意事項

  1. Webhook URLの立証: URLは有効な外部アドレスでなければなりません。内部ネットワークのアドレス(例えば、192.168.x.x や 10.x.x.x)は使用できません。
  2. 認証: webhookClientId または webhookClientSecret が設定されている場合、対応する方法で認証を行いまします。
  3. タイムアウトの設定: デフォルトのリクエストタイムアウトは5秒間です。ターゲットサーバが5秒以内に応答しないと、リクエストは失敗とみなされます。

アラーム頻度の制御

image-20241226194848985

「アラーム頻度の制御」では、各種チャネルを通じて送信されるアラーム通知の合計数を設定したり、自分でアラーム通知の言語を設定したりすることができます。