FAQ

RAG returns nothing

Take AXL's agent out of the loop first. Search the corpus directly:

axl rag search "your real question" -c /path/to/axl-config
axl rag status -c /path/to/axl-config

If search returns nothing, the problem is ingestion:

  • Files must be under the document set's content/ directory.
  • Run axl rag ingest after adding or changing files; use --reindex for a full rebuild.
  • PDF and office files need Tika configured. Start with Markdown to validate the pipeline.

If search works but the agent ignores it, the problem is the connection:

  • sources in the agent's rag.toml must exactly match the name in docs.toml.
  • trigger_mode = "keyword" only searches when the question matches the set's keywords. Use always for an agent that should ground every answer.
  • Restart the server after changing agent config.

If results come back but are wrong, the problem is the corpus. Split very large pages into task-sized documents and add useful terms to keywords.txt before touching RAG_TOP_K or distance thresholds.

Next

Model missing from the registry

A model you expected does not appear in the models endpoint.

Agent forgets between sessions

Something a user told the agent earlier is gone in the next conversation.

On this page

Next