Adoption Agent: Agent-level limits vs. Global limits

Prev Next

To help you track Adoption Agent usage, control costs, and prevent misuse, Userflow applies Adoption Agent limits at two levels: agent-level and global.

Privacy Assurance and Adoption Agent

Userflow does not use AI inputs to train, fine-tune, or otherwise improve public large language models. However, to maintain the highest standards of data security, we strongly recommend training your Adoption Agent on non-sensitive data and instructing users not to submit any sensitive or private information in their Adoption Agent searches. Refer to our Terms of Service for additional details.

Agent-level limits

Agent-level limits are configured in the settings for specific Adoption Agents within a single Environment (e.g., staging OR production). Usage is assessed on a rolling 30-day period.

  • What they control: Individual Adoption Agent usage.

  • Scope: Single agent in one environment (e.g., staging OR production).

  • When the agent-level limit is reached:
    ❌ That specific agent disappears from your Resource Center for 24 hours.
    ✅ Other Adoption Agents continue working normally.
    ✅ Test chats and other agent-related UI functionality remain available.
    ⚠️ Important: You can still accumulate usage that counts toward billing.

Additional Billing & Auto-Upgrades

Even if your agent-level limit is reached for a specific agent and it is removed from your Resource Center, you can still use other Adoption Agents and agent-related UI functions like test chats.

Note: While it’s still possible to be auto-upgraded, we’ve built backend protections against auto-upgrades from temporary usage spikes. Consistent usage patterns over the 24-hour period are more likely to trigger an upgrade.

Global limits

Global limits apply to all Adoption Agents and are managed within the Adoption Agent UI. Usage is assessed on a rolling 30-day period and will be displayed at the top of the Adoption Agent page, allowing you to monitor your usage and adjust your global limit as needed. If your global limit is reached, all Adoption Agents and associated UI functionality that may contribute to credit counts will be deactivated for 24 hours. Global limits can be set by account owners.

  • What they control: Adoption Agent usage for all agents and agent-related UI features across your entire account in all environments.

  • Scope: Every agent and agent-related UI function that contributes to your credit count (e.g., test chats, staging environment activity).

  • When the global limit is reached:
    ❌ All Adoption Agents become unavailable for 24 hours.
    ✅ Test chats and other agent-related UI functionality remain available.
    ✅ No further usage accumulates (protecting you from unexpected charges).

    Additional Billing & Auto-Upgrades

    When the global limit is reached, all of your Adoption Agents and all related UI functionality that contributes to the credit count are deactivated, reducing the possibility of additional billing or auto-upgrades.

    Note:  While it’s still possible to be auto-upgraded, we’ve built backend protections against auto-upgrades from temporary usage spikes. Consistent usage patterns over the 24-hour period are more likely to trigger an upgrade.

Key Takeaways

Agent-level limits help you manage individual deployments, but don't prevent overall usage from growing.

Global limits act as a safety net, completely stopping Adoption Agent-related usage when reached to prevent unexpected billing or auto-upgrades.

Usage calculations for both agent-level and global limits are assessed on a rolling 30-day period. If an agent or related functionality is deactivated when a limit is reached, it will be restored after 24 hours when the 30-day calculation resets.