BerriAI/litellm · error · ValueError

name is required for RAGFlow dataset creation

Error message

name is required for RAGFlow dataset creation

What it means

Required-field guard when building a RAGFlow dataset-creation request: the create params contain no 'name', but the POST /api/v1/datasets API requires a dataset name, so the request body is rejected before it is sent.

Source

Thrown at litellm/llms/ragflow/vector_stores/transformation.py:121

        raise NotImplementedError("RAGFlow vector stores support dataset management only, not search/retrieval")

    def transform_create_vector_store_request(
        self,
        vector_store_create_optional_params: VectorStoreCreateOptionalRequestParams,
        api_base: str,
    ) -> tuple[str, dict]:
        """
        Transform create request to RAGFlow POST /api/v1/datasets format.

        Maps LiteLLM params to RAGFlow dataset creation parameters.
        RAGFlow-specific fields can be passed via metadata.
        """
        url: Final = api_base  # Already includes /api/v1/datasets from get_complete_url

        # Extract name (required by RAGFlow)
        name: Final = vector_store_create_optional_params.get("name")
        if not name:
            raise ValueError("name is required for RAGFlow dataset creation")

        # Build request body
        request_body: Final[dict[str, Any]] = {
            "name": name,
        }

        # Extract RAGFlow-specific fields from metadata
        metadata: Final = vector_store_create_optional_params.get("metadata")
        if metadata:
            # RAGFlow-specific fields that can be in metadata
            ragflow_fields: Final = [
                "avatar",
                "description",
                "embedding_model",
                "permission",
                "chunk_method",
                "parser_config",
                "parse_type",

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Provide a 'name' when creating a RAGFlow dataset/vector store.

Example fix

litellm.vector_stores.create(name="my-dataset", custom_llm_provider="ragflow", ...)

When it happens

Trigger: Triggered when creating a RAGFlow dataset without providing the required 'name' field.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/4e99e0bcf5c7e92c. Report an issue: GitHub.