HKUDS/DeepTutor · error · ValueError

RAG requires an explicit kb_name.

Error message

RAG requires an explicit kb_name.

What it means

Error "RAG requires an explicit kb_name." thrown in HKUDS/DeepTutor.

Source

Thrown at deeptutor/tools/rag_tool.py:34

    query: str,
    kb_name: str,
    provider: Optional[str] = None,
    kb_base_dir: Optional[str] = None,
    event_sink=None,
    **kwargs,
) -> dict:
    """Retrieve passages from ``kb_name`` and synthesise an answer.

    ``kb_name`` must match a knowledge base the current user can access;
    multi-user routing is delegated to :func:`resolve_for_rag` when no
    explicit ``kb_base_dir`` is given.
    """
    query = query.strip() if isinstance(query, str) else ""
    kb_name = kb_name.strip() if isinstance(kb_name, str) else ""
    if not query:
        raise ValueError("RAG query must be a non-empty string.")
    if not kb_name:
        raise ValueError("RAG requires an explicit kb_name.")

    if kb_base_dir is None:
        from deeptutor.multi_user.knowledge_access import resolve_for_rag

        resource = resolve_for_rag(kb_name)
        if resource is None:
            raise ValueError(f"Knowledge base '{kb_name}' is not accessible.")
        kb_base_dir = str(resource.base_dir)
        kb_name = resource.name

    service = RAGService(kb_base_dir=kb_base_dir, provider=provider)
    return await service.search(
        query=query,
        kb_name=kb_name,
        event_sink=event_sink,
        **kwargs,
    )

View on GitHub (pinned to 3e82f13042)

When it happens

Trigger: Thrown at deeptutor/tools/rag_tool.py:34 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of HKUDS/DeepTutor@3e82f13042 (2026-08-27). Data as JSON: /api/errors/00bbba140d780790. Report an issue: GitHub.