{"record":{"id":"5a4bc57fe284c050","repo":"iflytek/astron-agent","slug":"knowledge-node-execution-error","errorCode":"KNOWLEDGE_NODE_EXECUTION_ERROR","errorMessage":"Knowledge base URL is not set","messagePattern":"Knowledge base URL is not set","errorType":"error_code","errorClass":"CustomException","httpStatus":null,"severity":"error","filePath":"core/workflow/engine/nodes/knowledge/knowledge_node.py","lineNumber":313,"sourceCode":"                should_use, token_usage = await self._should_use_knowledge(\n                    query, span, variable_pool\n                )\n                if not should_use:\n                    outputs = {self.output_identifier[0]: []}\n                    return self._create_node_result(\n                        status=status,\n                        inputs=inputs,\n                        outputs=outputs,\n                        token_usage=token_usage,\n                    )\n\n            # Get repository and document IDs\n            repo_and_doc_ids = self._get_repo_and_doc_ids()\n\n            # Get knowledge base URL from environment variables\n            knowledge_base_url = os.getenv(\"KNOWLEDGE_BASE_URL\")\n            if not knowledge_base_url:\n                raise CustomException(\n                    err_code=CodeEnum.KNOWLEDGE_NODE_EXECUTION_ERROR,\n                    err_msg=\"Knowledge base URL is not set\",\n                    cause_error=\"Knowledge base URL is not set\",\n                )\n            knowledge_recall_url = f\"{knowledge_base_url}/knowledge/v1/chunk/query\"\n            flow_id: str = variable_pool.system_params.get(ParamKey.FlowId)\n            knowledge_config = KnowledgeConfig(\n                top_n=self.topN,\n                rag_type=self.ragType,\n                repo_id=repo_and_doc_ids.repo_ids,\n                url=knowledge_recall_url,\n                query=str(query),\n                flow_id=flow_id,\n                doc_ids=repo_and_doc_ids.doc_ids,\n                dataset_ids=repo_and_doc_ids.dataset_ids,\n                threshold=self.score,\n                history=history,\n            )","sourceCodeStart":295,"sourceCodeEnd":331,"githubUrl":"https://github.com/iflytek/astron-agent/blob/5e758547a83371a5a4b29dadf4ac03e8dd527635/core/workflow/engine/nodes/knowledge/knowledge_node.py#L295-L331","documentation":"KnowledgeNode.execute raises when the configured knowledge base URL is blank — the node cannot build the retrieval endpoint. This is a configuration guard at node execution time, meaning the workflow's knowledge node settings (or environment) lack the service URL.","triggerScenarios":"Thrown at core/workflow/engine/nodes/knowledge/knowledge_node.py:313 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set the knowledge base URL in workflow/environment configuration","Verify the knowledge service deployment and its exposed URL","Fail the node fast with a clear config-error message"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"5e758547a83371a5a4b29dadf4ac03e8dd527635","analyzedAt":"2026-09-12T08:03:51.356Z","contentChangedAt":"2026-09-12T08:03:51.356Z","schemaVersion":2},"datasetVersion":"2026-09-19T12:17:13.211Z"}