次の方法で共有

Teams でレートを制限してボットを最適化する

  • [アーティクル]

レート制限は、メッセージを特定の最大頻度に制限する方法です。 一般的な原則として、アプリケーションでは、個々のチャットまたはチャネルの会話に投稿するメッセージの数を制限する必要があります。 これにより、最適なエクスペリエンスが確保され、メッセージがユーザーへのスパムとして表示されません。

Microsoft Teams とそのユーザーを保護するために、ボット API は受信要求のレート制限を提供します。 この制限を超えるアプリは、 HTTP 429 Too Many Requests エラー状態を受け取ります。 すべての要求には、メッセージ、チャネル列挙、名簿フェッチの送信など、同じレート制限ポリシーが適用されます。

レート制限の正確な値は変更される可能性があります。アプリケーションは、API が HTTP 429 Too Many Requestsを返すときに適切なバックオフ動作を実装する必要があります。

レート制限を処理する

Bot Builder SDK 操作を発行するときに、状態コードのMicrosoft.Rest.HttpOperationExceptionとチェックを処理できます。

次のコードは、レート制限の処理の例を示しています。

try
{
    // Perform Bot Framework operation
    // for example, await connector.Conversations.UpdateActivityAsync(reply);
}
catch (HttpOperationException ex)
{
    if (ex.Response != null && (uint)ex.Response.StatusCode ==  429)
    {
        //Perform retry of the above operation/Action method
    }
}

ボットのレート制限を処理した後、指数バックオフを使用して HTTP 429 応答を処理できます。

HTTP 429応答を処理する

HTTP 429応答を受け取らないように、簡単な予防措置を講じる必要があります。 たとえば、同じ個人用またはチャネルの会話に対して複数の要求を発行しないようにします。 代わりに、API 要求のバッチを作成します。

429s を処理するには、ランダム ジッターで指数バックオフを使用することをお勧めします。 これにより、複数の要求で再試行時に競合が発生しないようにします。

HTTP 429応答を処理したら、一時的な例外を検出する例を確認できます。

注:

エラー コード 429 の再試行に加えて、エラー コード 412、 502、 504 も再試行する必要があります。

一時的な例外の検出の例

次のコードは、一時的な障害処理アプリケーション ブロックを使用して指数バックオフを使用する例を示しています。

public class BotSdkTransientExceptionDetectionStrategy : ITransientErrorDetectionStrategy
    {
        // List of error codes to retry on
        List<int> transientErrorStatusCodes = new List<int>() { 429 };

        public bool IsTransient(Exception ex) 
          {
          {
              if (ex.Message.Contains("429"))
                  return true;

              HttpResponseMessageWrapper? response = null;
              if (ex is HttpOperationException httpOperationException)
              {
                  response = httpOperationException.Response;
              }
              else
              if (ex is ErrorResponseException errorResponseException)
              {
                  response = errorResponseException.Response;
              }
              return response != null && transientErrorStatusCodes.Contains((int)response.StatusCode);
          }
    }

一時的な障害処理を使用して、バックオフと再試行を実行できます。 NuGet パッケージの取得とインストールに関するガイドラインについては、ソリューションへの 一時的な障害処理アプリケーション ブロックの追加に関するページを参照してください。 「一時的な障害処理」も参照してください。

一時的な例外を検出する例を確認したら、指数バックオフの例を参照してください。 障害時に再試行する代わりに、指数バックオフを使用できます。

バックオフの例

レート制限の検出に加えて、指数バックオフを実行することもできます。

次のコードは、指数バックオフの例を示しています。

/**
* The first parameter specifies the number of retries before failing the operation.
* The second parameter specifies the minimum and maximum backoff time respectively.
* The last parameter is used to add a randomized  +/- 20% delta to avoid numerous clients retrying simultaneously.
*/
var exponentialBackoffRetryStrategy = new ExponentialBackoffRetryStrategy(3, TimeSpan.FromSeconds(2),
                        TimeSpan.FromSeconds(20), TimeSpan.FromSeconds(1));


// Define the Retry Policy
var retryPolicy = new RetryPolicy(new BotSdkTransientExceptionDetectionStrategy(), exponentialBackoffRetryStrategy);

//Execute any bot sdk action
await retryPolicy.ExecuteAsync(() => connector.Conversations.ReplyToActivityAsync( (Activity)reply) ).ConfigureAwait(false);

このセクションで説明する再試行ポリシーを使用して、 System.Action メソッドの実行を実行することもできます。 参照ライブラリを使用すると、固定間隔または線形バックオフ メカニズムを指定することもできます。

値と戦略を構成ファイルに格納して、実行時に値を微調整および調整します。

詳細については、「 再試行パターン」を参照してください。

また、スレッドごとのボットあたりの制限を使用してレート制限を処理することもできます。

スレッドあたりのボットあたりの制限

スレッドごとのボットごとの制限は、ボットが 1 つの会話で生成できるトラフィックを制御します。 会話は、ボットとユーザー、グループ チャット、またはチーム内のチャネルの間で 1:1 です。 そのため、アプリケーションが各ユーザーに 1 つのボット メッセージを送信する場合、スレッドの制限は調整されません。

注:

  • スレッドの制限である 3600 秒と 1800 操作は、複数のボット メッセージが 1 人のユーザーに送信される場合にのみ適用されます。
  • テナントあたりのアプリあたりのグローバル制限は、1 秒あたり 50 要求 (RPS) です。 そのため、1 秒あたりのボット メッセージの合計数がスレッドの制限を超えてはなりません。
  • サービス レベルでメッセージを分割すると、予想よりも RPS が大きくなります。 制限に近づくことを心配する場合は、 バックオフ戦略を実装する必要があります。 このセクションで提供される値は見積もり専用です。

次の表に、スレッドごとのボットごとの制限を示します。

シナリオ 秒単位の期間 許可される操作の最大数
会話に送信する 1 7
会話に送信する 2 8
会話に送信する 30 60
会話に送信する 3600 1800
会話を作成する 1 7
会話を作成する 2 8
会話を作成する 30 60
会話を作成する 3600 1800
会話メンバーを取得する 1 14
会話メンバーを取得する 2 16
会話メンバーを取得する 30 120
会話メンバーを取得する 3600 3600
会話を取得する 1 14
会話を取得する 2 16
会話を取得する 30 120
会話を取得する 3600 3600

注:

以前のバージョンの TeamsInfo.getMembers API と TeamsInfo.GetMembersAsync API は非推奨になっています。 1 分あたり 5 つの要求に調整され、チームごとに最大 10,000 人のメンバーが返されます。 最新のページ分割された API エンドポイントを使用するように Bot Framework SDK とコードを更新するには、「 チームおよびチャット メンバーの Bot API の変更」を参照してください。

また、すべてのボットのスレッドごとの制限を使用してレート制限を処理することもできます。

すべてのボットのスレッドごとの制限

すべてのボットのスレッドごとの制限は、すべてのボットが 1 つの会話全体で生成できるトラフィックを制御します。 ここでは、ボットとユーザー、グループ チャット、またはチーム内のチャネルの間の 1 対 1 の会話です。

次の表に、すべてのボットのスレッドごとの制限を示します。

シナリオ 秒単位の期間 許可される操作の最大数
会話に送信する 1 14
会話に送信する 2 16
会話を作成する 1 14
会話を作成する 2 16
会話を作成する 1 14
会話を作成する 2 16
会話メンバーを取得する 1 28
会話メンバーを取得する 2 32
会話を取得する 1 28
会話を取得する 2 32

次の手順

通話とオンライン会議のボット

関連項目