quota-management

クォータ管理

概要

累積トークン予算を追跡し、上限を適用します。呼び出しごとのログ記録には、 usage-logging を使用してください。

レート制限のあるサービス全体で、リソースクォータを追跡して適用するためのパターンです。このスキルは、ほかのプラグインが一貫したクォータ管理に使用するインフラを提供します。

使用する場面

• レート制限のある API との連携を構築する場合
• セッションをまたいで使用状況を追跡する必要がある場合
• 上限に近づいた際に、段階的な縮退を行いたい場合
• 操作前にコストを見積もる必要がある場合

使用しない場面

• プロジェクトで leyline のインフラパターンを使用していない場合
• サービスアーキテクチャを必要としない単純なスクリプトの場合

コアコンセプト

クォータのしきい値

予防的な管理のための3段階のしきい値システムです。

レベル	使用率	アクション
正常	<80%	通常どおり続行
警告	80-95%	警告し、バッチ処理を検討
重大	>95%	緊急性の低い処理を延期し、代替サービスを使用

クォータの種類

@dataclass
class QuotaConfig:
    requests_per_minute: int = 60
    requests_per_day: int = 1000
    tokens_per_minute: int = 100000
    tokens_per_day: int = 1000000

クイックスタート

クォータの状態を確認

from leyline.quota_tracker import QuotaTracker

tracker = QuotaTracker(service="my-service")
status, warnings = tracker.get_quota_status()

if status == "critical":
    # Defer or use secondary service
    pass

使用量を記録

tracker.record_request(tokens=estimated_tokens, success=True, duration=elapsed_seconds)

実行前に見積もる

can_proceed, issues = tracker.can_handle_task(estimated_tokens)
if not can_proceed:
    print(f"Quota issues: {issues}")

統合パターン

ほかのプラグインからこのスキルを参照します。

# In your skill's frontmatter
dependencies: [leyline:quota-management]

次に、共有パターンを使用します。

1. サービス用のトラッカーを初期化します
2. 操作の前にクォータを確認します
3. 操作の後に使用量を記録します
4. しきい値の警告に適切に対処します

詳細なリソース

• しきい値の戦略：縮退パターンについては modules/threshold-strategies.md を参照してください
• 見積もりパターン：トークンやコストの見積もりについては modules/estimation-patterns.md を参照してください

完了条件

• 操作の前にクォータの状態を確認している
• 操作の後に使用量を記録している
• しきい値の警告に適切に対処している