Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.narrative.io/llms.txt

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

Surface: GET /agents/runs/{id}, error.type = "AgentLoopUnknownToolAlias"

​
When this error occurs

The workflow router splits each tool_use.name on the first - and looks up the resulting alias in effective_config.mcp_servers[].alias ∪ effective_config.client_tools[].alias. This error means the alias matched neither — there’s no resolver for the call. Common causes:
  • The system prompt or the tool catalog itself references an alias that wasn’t actually registered for this run.
  • The model hallucinated a tool name (rare with tool_choice set; more common with auto and a loose prompt).

​
How to fix

  • Make sure every alias the system prompt mentions also appears in mcp_servers or client_tools for the run’s effective config.
  • Tighten the prompt: “Only use the tools listed below; do not invent new ones.”
  • Use tool_choice: {kind: any} to force a real tool, or specific_tool if you know which one is expected next.