アラーム通知
アラームの種類
GPTBotsの「組織 - アラーム通知」機能では、アラーム関連の設定を試すことができます。
GPTBotsのアラーム通知機能は、ビジネスのシチュエーションにより3つのタイプに分けられます。
- 利用量アラーム:クレジットとサブスクリプションプランに関連するアラームです。これには、クレジット残高のアラーム、クレジット使用量のアラーム、サブスクリプションプランのアラームが含まれます。
- ビジネスアラーム:エージェントのビジネスのシチュエーションに関連するアラームです。これには、エージェントの対話RPMレートの上限超過、エージェントの対話のRPMレートのトリガーカウントのアラーム、エージェントの対話における異常な回答数が上限設定を超えた場合のアラームが含まれます。
- 問題分類アラーム:エージェントの対話中に問題の分類回数に関連するシチュエーションのアラームです。
アラームルール設定
アラームの項目
アラームの種類を選択した後、その種類の下に表示される「アラーム追加」をクリックして、アラーム設定を開始します。
アラーム設定を行う際には、具体的なアラーム項目を選択する必要があります。例えば、クレジットの残高などです。
ビジネスアラームでは、対象となるエージェントの選択が必要です。問題分類アラームでは、対象となるエージェントと対象となる問題分類の両方を選択する必要があります。
アラームルール
アラームルールとは、アラームを発動する条件のことを指します。これらの条件が満たされたときにアラームが発動します。
通知頻度
通知頻度は、アラームがどの程度の頻度で送信されるかを設定します。アラームが発動したら、ユーザー自身で通知頻度を設定することができます。
通知チャネル
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
の両方が設定されている場合、このヘッダが必要です。認証について webhookClientId
とwebhookClientSecret
の両方が存在している場合、以下の形式の基本認証が使用されます:
Authorization: Basic Base64(clientId:clientSecret)
webhookClientId
のみ存在している場合、次のフォーマットのBearer認証を使用します:
Authorization: Bearer clientId
webhookClientSecret
のみ存在している場合、次のフォーマットのBearer認証を使用します:
Authorization: Bearer clientSecret
リクエストボディ
リクエストボディはJSON形式で、以下のフィールドを含みます:
フィールド | タイプ | 必須 | 説明 |
---|---|---|---|
title | String | 必須 | アラームのタイトル |
time | Long | 必須 | アラームのタイムスタンプ (ミリ秒単位) |
content | String | 必須 | アラームの具体的な内容 |
Example: |
{
"title": "CPU使用率アラーム",
"time": 1698745600000,
"content": "過去5分間におけるCPUの使用率が90%を超過しました。"
}
注意事項
- Webhook URLの立証: URLは有効な外部アドレスでなければなりません。内部ネットワークのアドレス(例えば、192.168.x.x や 10.x.x.x)は使用できません。
- 認証:
webhookClientId
またはwebhookClientSecret
が設定されている場合、対応する方法で認証を行いまします。 - タイムアウトの設定: デフォルトのリクエストタイムアウトは5秒間です。ターゲットサーバが5秒以内に応答しないと、リクエストは失敗とみなされます。
アラーム頻度の制御
「アラーム頻度の制御」では、各種チャネルを通じて送信されるアラーム通知の合計数を設定したり、自分でアラーム通知の言語を設定したりすることができます。