Convex Agents Rate Limiting

What problem does it solve?

This Skill provides a structured approach to regulating message flow and token usage in Convex Agent workflows, preventing abuse and controlling costs.

Core Features & Use Cases

• Per-user and global limits: Define and enforce limits to ensure fair use across users and global capacity.
• Burst handling and budgeting: Support fixed-window and token-bucket strategies to accommodate bursts while staying within quotas.
• Use Case: In a multi-user chat, the skill helps prevent abuse by capping messages per user per minute and tracking token usage for billing.

Quick Start

Install or reference the rate-limiter library in your project, initialize the rate limiter with your configured rules, and apply checks before generating responses in agent workflows. Example: create a rateLimiter with per-user and global limits, then call rateLimiter.limit(ctx, "sendMessage", { key: userId, throws: true }); on each user message.