As with any powerful AI automation tool, occasional errors can occur when working with Agents, often due to configuration issues, environment settings, or external dependencies. To help you move past these quickly and confidently, we’ve outlined the most common errors, what they mean, and how to resolve them. This guide is designed to make your experience with Blink Agents as smooth and productive as possible, even when something unexpected comes up. Below, you will find a list of the most common errors along with suggested remediation steps:

​
Rate Limit Errors

Error Message

“You’ve reached the maximum number of requests allowed for running agents on this tenant. Please try again in {next_window}. (tenantid: {tenant_id})”

Suggestion

This error occurs when the number of agent run requests has exceeded the permitted limit for the tenant within a fixed time window. This request rate limit ensures fair usage and system stability. Wait until the next window to retry the request.

Error Message

“You’ve reached the maximum number of tokens allowed for running agents on this tenant. Please try again in {next_window}. (tenantid: {tenant_id})”

Suggestion

This error indicates that the tenant has consumed the maximum number of agent execution tokens within the current time window. Token-based limits control usage at a more granular level. Wait until the next window to resume execution or review usage patterns. For additional information, navigate to the rate limits section.

​
Abilities Errors

Error Message

“The agent exceeded the maximum limit of 20 abilities executions in a single run.”

Suggestion

Refine the agent task so the agent processes fewer items in a single run. For example, if the agent is analyzing IP addresses, provide a smaller subset at a time (e.g., batch them in groups of 5–10 instead of sending all 20 at once). This helps keep the number of ability executions within the allowed limit.

Error Message

“Ability execution output is too long. Maximum size allowed is 100KB.”

Suggestion

This error indicates that the output generated after a running the agent step exceeded the maximum allowed size of 100KB. Here’s a rewritten, suitable remediation: Review the ability used in the agent step and adjust how it is configured to generate only the essential data needed for your outcome. This may involve refining prompts and filtering unnecessary detail so the resulting abilities output remains within the 100KB size limit.

Error Message

“Ability execution failed: {workflow_name}. Please try again or contact support if the issue persists.”

Suggestion

A specific ability (workflow) failed during execution. This is typically caused by internal processing errors, misconfiguration, or connectivity issues. Check the workflow setup and logs for more details.

​
Other

Error Message

“The agent output structure exceeded the supported nesting depth of 3 levels.”

Suggestion

The agent’s output includes a JSON structure nested deeper than three levels, which exceeds the supported depth. To resolve, simplify the output to meet the depth limit.

Error Message

“An unexpected error occurred while running the agent. Please try again or contact support if the issue persists.”

Suggestion

An uncaught exception occurred during agent execution. This may be due to an internal runtime issue. Retry the run, and if the problem persists, escalate for further investigation.