​

Common Errors

This page lists the most common error messages in Neural Factory and how to resolve them.

​

Authentication errors

​

”Session expired” / “Please sign in again”

Your authentication session has timed out. Sign out and sign back in. If this happens frequently, clear your browser cookies for the Neural Factory domain.

​

”Unauthorized” (401)

Your request was not authenticated. Possible causes:

• You’re not signed in
• Your API key is invalid or expired
• Your session token has expired

Fix: Sign in again, or verify your API key is correct and active.

​

”Forbidden” (403)

You don’t have permission to perform this action. Possible causes:

• You’re trying to access an admin feature as a Member
• The agent or knowledge base is restricted to groups you don’t belong to
• Your API key doesn’t have the required permissions

Fix: Contact your administrator to check your role and group memberships.

​

Resource errors

​

”Not found” (404)

The requested resource doesn’t exist. Possible causes:

• The agent, knowledge base, or conversation was deleted
• The URL is incorrect
• You’re trying to access a resource in a different organization

​

”Rate limited” (429)

You’ve exceeded the request rate limit. Wait for the time specified in the Retry-After header before retrying. If you consistently hit rate limits, consider upgrading your plan (SaaS) or contact your administrator (Enterprise).

​

”You’ve reached your limit of parallel agent tasks” (429)

A different limit that returns the same status code. This one is about how many agent tasks you may run at the same time, not how fast you send requests — so it clears as soon as a running task finishes, not at the end of a billing cycle. Over the API the message names the numbers, for example: “You already have 10 agent runs in progress (your limit is 10).” Fix: Wait for a task to finish, or stop one you no longer need. Tasks paused waiting on you don’t count toward the limit. If you hit this routinely, raise the limit by upgrading your plan (SaaS) or ask your administrator (Enterprise). See Billing for the per-plan allowance.

​

Server errors

​

”Internal server error” (500)

Something went wrong on the server. This is usually temporary. Steps:

1. Wait a moment and try again
2. If the error persists, check if the issue is specific to one agent or feature
3. Contact support@neuralfactory.ai if the error continues

​

”Service unavailable” (503)

The platform is temporarily unavailable, usually due to maintenance or high load. Try again in a few minutes.

​

Chat errors

​

”Agent failed to respond”

The agent encountered an error while processing your message, and the failure is reported on the turn itself. Possible causes:

• The AI model service is temporarily unavailable
• The agent’s configuration has an issue
• A connected tool or datasource is failing

Fix: Reopen the conversation first — if the task is still running, the answer is still coming and resending would start a second task that is billed separately. Once the turn has actually failed, send the message again; if it keeps failing, try a different agent or contact your administrator. A failed task is billed for the work it completed before failing.

​

”Run stopped at its execution limit.”

The task hit its maximum active running time (one hour by default) or its total token ceiling, and was stopped. Split the request into smaller tasks, or narrow the documents and tools it has to work through. See Agent Issues for the full walkthrough.

​

”Message too long”

Your message exceeds the maximum allowed length. Shorten your message or break it into multiple messages.