run-llama/llama_index · error · ValueError

Missing query_str in kwargs with parameter name: {self._quer

Error message

Missing query_str in kwargs with parameter name: {self._query_str_kwargs_key}

What it means

Error "Missing query_str in kwargs with parameter name: {self._query_str_kwargs_key}" thrown in run-llama/llama_index.

Source

Thrown at llama-index-core/llama_index/core/tools/ondemand_loader_tool.py:128

            )
        metadata = ToolMetadata(
            name=name,
            description=description,
            fn_schema=fn_schema,
            return_direct=return_direct,
        )
        return cls(
            loader=tool._fn,
            index_cls=index_cls,
            index_kwargs=index_kwargs,
            use_query_str_in_loader=use_query_str_in_loader,
            query_str_kwargs_key=query_str_kwargs_key,
            metadata=metadata,
        )

    def _parse_args(self, *args: Any, **kwargs: Any) -> Tuple[str, List[Document]]:
        if self._query_str_kwargs_key not in kwargs:
            raise ValueError(
                "Missing query_str in kwargs with parameter name: "
                f"{self._query_str_kwargs_key}"
            )
        if self._use_query_str_in_loader:
            query_str = kwargs[self._query_str_kwargs_key]
        else:
            query_str = kwargs.pop(self._query_str_kwargs_key)

        docs = self._loader(*args, **kwargs)

        return query_str, docs

    def call(self, *args: Any, **kwargs: Any) -> ToolOutput:
        """Call."""
        query_str, docs = self._parse_args(*args, **kwargs)

        index = self._index_cls.from_documents(docs, **self._index_kwargs)
        # TODO: add query kwargs

View on GitHub (pinned to afd0fef371)

Solutions

1. Include the query_str key in the tool call kwargs.
2. Configure the correct query_str_kwargs_key matching how the agent passes the query.

When it happens

Trigger: Thrown at llama-index-core/llama_index/core/tools/ondemand_loader_tool.py:128 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of run-llama/llama_index@afd0fef371 (2026-08-15). Data as JSON: /api/errors/6e38b26ac8ece925. Report an issue: GitHub.