Documentation Index

Fetch the complete documentation index at: https://docs.neuralfactory.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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).

​

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. Possible causes:

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

Fix: Try sending the message again. If it persists, try a different agent or contact your administrator.

​

”Message too long”

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