{"record":{"id":"198eb4841ff66394","repo":"iflytek/astron-agent","slug":"dataset-creation-failed-create-response","errorCode":null,"errorMessage":"Dataset creation failed: {create_response}","messagePattern":"Dataset creation failed: (.+?)","errorType":"exception","errorClass":"Exception","httpStatus":null,"severity":"error","filePath":"core/knowledge/infra/ragflow/ragflow_utils.py","lineNumber":136,"sourceCode":"                            )\n                            return dataset_id\n\n                logger.info(f\"Dataset doesn't exist, creating new dataset: {group}\")\n                create_response = await create_dataset(\n                    name=group,\n                    description=description\n                    or f\"Automatically created dataset: {group}\",\n                    chunk_method=\"naive\",\n                )\n\n                if create_response.get(\"code\") == 0:\n                    dataset_id = create_response.get(\"data\", {}).get(\"id\")\n                    logger.info(\n                        f\"Dataset created successfully: {group}, ID: {dataset_id}\"\n                    )\n                    return dataset_id\n                else:\n                    raise Exception(f\"Dataset creation failed: {create_response}\")\n\n            except Exception as e:\n                logger.error(f\"Dataset management failed: {e}\")\n                raise Exception(f\"Unable to ensure dataset exists: {str(e)}\")\n\n    @staticmethod\n    async def _sync_description_if_stale(\n        dataset_id: str, current: Optional[str], desired: Optional[str]\n    ) -> None:\n        \"\"\"Best-effort lazy sync of a dataset's description.\n\n        Skips when ``desired`` is empty (caller did not supply a label) or\n        when ``current`` already matches. Exceptions are swallowed and logged\n        — a UI-friendly description must never block document writes.\n        \"\"\"\n        if not desired or current == desired:\n            return\n        try:","sourceCodeStart":118,"sourceCodeEnd":154,"githubUrl":"https://github.com/iflytek/astron-agent/blob/5e758547a83371a5a4b29dadf4ac03e8dd527635/core/knowledge/infra/ragflow/ragflow_utils.py#L118-L154","documentation":"ensure_dataset raises this when create_dataset returns a non-zero code from the RAGFlow server — the dataset (knowledge group) could not be created, so document ingestion for that group cannot proceed. The message embeds the full create_response for diagnosis.","triggerScenarios":"Thrown at core/knowledge/infra/ragflow/ragflow_utils.py:136 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Inspect the embedded create_response code/message (name conflicts, auth, quota)","Check RAGFlow service availability and API key validity","Retry creation; if the name exists, look up the existing dataset instead"],"exampleFix":null,"handlingStrategy":"retry","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"}