{"record":{"id":"6e38b26ac8ece925","repo":"run-llama/llama_index","slug":"missing-query-str-in-kwargs-with-parameter-name","errorCode":null,"errorMessage":"Missing query_str in kwargs with parameter name: {self._query_str_kwargs_key}","messagePattern":"Missing query_str in kwargs with parameter name: (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"llama-index-core/llama_index/core/tools/ondemand_loader_tool.py","lineNumber":128,"sourceCode":"            )\n        metadata = ToolMetadata(\n            name=name,\n            description=description,\n            fn_schema=fn_schema,\n            return_direct=return_direct,\n        )\n        return cls(\n            loader=tool._fn,\n            index_cls=index_cls,\n            index_kwargs=index_kwargs,\n            use_query_str_in_loader=use_query_str_in_loader,\n            query_str_kwargs_key=query_str_kwargs_key,\n            metadata=metadata,\n        )\n\n    def _parse_args(self, *args: Any, **kwargs: Any) -> Tuple[str, List[Document]]:\n        if self._query_str_kwargs_key not in kwargs:\n            raise ValueError(\n                \"Missing query_str in kwargs with parameter name: \"\n                f\"{self._query_str_kwargs_key}\"\n            )\n        if self._use_query_str_in_loader:\n            query_str = kwargs[self._query_str_kwargs_key]\n        else:\n            query_str = kwargs.pop(self._query_str_kwargs_key)\n\n        docs = self._loader(*args, **kwargs)\n\n        return query_str, docs\n\n    def call(self, *args: Any, **kwargs: Any) -> ToolOutput:\n        \"\"\"Call.\"\"\"\n        query_str, docs = self._parse_args(*args, **kwargs)\n\n        index = self._index_cls.from_documents(docs, **self._index_kwargs)\n        # TODO: add query kwargs","sourceCodeStart":110,"sourceCodeEnd":146,"githubUrl":"https://github.com/run-llama/llama_index/blob/afd0fef371831f9bda13e5af7167cf4e981278ab/llama-index-core/llama_index/core/tools/ondemand_loader_tool.py#L110-L146","documentation":"Error \"Missing query_str in kwargs with parameter name: {self._query_str_kwargs_key}\" thrown in run-llama/llama_index.","triggerScenarios":"Thrown at llama-index-core/llama_index/core/tools/ondemand_loader_tool.py:128 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Include the query_str key in the tool call kwargs.","Configure the correct query_str_kwargs_key matching how the agent passes the query."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"afd0fef371831f9bda13e5af7167cf4e981278ab","analyzedAt":"2026-08-15T05:42:58.429Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}