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

# Agent Issues

> Troubleshoot agents that aren't responding, are slow, or give wrong answers.

# Agent Issues

This guide helps you diagnose and resolve common agent-related problems.

## Agent not responding

**Symptoms**: You send a message and nothing happens, or you see an error message.

**Possible causes and fixes**:

1. **AI model service issue** — The underlying AI model may be temporarily unavailable. Wait a minute and try again.
2. **Agent configuration error** — The agent may have an invalid configuration. An administrator should check the agent's settings in the Agents page.
3. **Tool failure** — A tool the agent is trying to use may be failing. Check toolkit connections in the admin panel.

## Agent responding slowly

**Symptoms**: The agent takes a long time before text starts appearing.

**Possible causes and fixes**:

1. **Complex tool usage** — If the agent is searching knowledge bases, calling external tools, or executing code, each step adds time. This is normal behavior.
2. **Large context** — Long conversations with many messages create a larger context for the model to process. Start a new conversation if the current one has become very long.
3. **Model selection** — More capable models (reasoning models, larger models) can be slower. An administrator can try a faster model if speed is a priority.
4. **Server load** — During peak usage, response times may increase.

## Agent giving wrong or irrelevant answers

**Symptoms**: The agent provides incorrect information, ignores your question, or goes off-topic.

**Possible causes and fixes**:

1. **Missing knowledge** — The relevant documents may not be in the connected knowledge base. Check that the KB contains the information and that it's been indexed.
2. **Poor system prompt** — The agent's instructions may not be clear enough. An administrator should review and refine the system prompt.
3. **Wrong agent** — You may be chatting with an agent that isn't designed for your question type. Try selecting a different agent.
4. **Strict mode** — If the agent is in [strict mode](/user-guide/agents/strict-mode) and can't find relevant documents, it will decline to answer rather than guess.
5. **Outdated documents** — The knowledge base may contain outdated information. Verify documents are current.

## Agent not using knowledge base

**Symptoms**: The agent responds but doesn't cite any sources, even for questions that should match documents.

**Possible causes and fixes**:

1. **Knowledge search not enabled** — Verify the agent has the knowledge search tool enabled.
2. **No knowledge base connected** — Verify at least one KB is connected to the agent.
3. **KB not indexed** — Check the knowledge base's indexing status — documents may still be processing.
4. **KB access control** — You may not have access to the KB. Check your group memberships.
5. **Query mismatch** — Your question may not match the documents well. Try rephrasing.

## Reporting persistent issues

If issues persist after troubleshooting:

1. Note the agent name, your message, and the error/behavior
2. Check the [Analytics](/user-guide/admin/analytics) dashboard for the interaction details
3. Contact [support@neuralfactory.ai](mailto:support@neuralfactory.ai) with this information