Function wiki_ask

deployments/desktop/shared/agents.py:4685–4781

(
    user_id: str,
    question: str,
    limit: int = 8,
    scope: str = "all",
    mentions: Any = None,
    session_id: str = "",
    persist_chat: bool = False,
    response_language: str = "zh",
)

def _comparison_selection_required_message(response_language: str) -> str:
    if _normalize_response_language(response_language) == "en":
        return (
            "Please use @ in the input box to select two specific papers first, "
            "or open a reference from the right panel before comparing them. "
            "Otherwise the local Wiki cannot know which two papers you mean."
        )
    return "请先在输入框用 @ 选择两篇具体论文，或从右侧参考文献点“查看来源”后再对比。否则本地 Wiki 无法判断你说的“这两篇”是哪两篇。"


def wiki_ask(
    user_id: str,
    question: str,
    limit: int = 8,
    scope: str = "all",
    mentions: Any = None,
    session_id: str = "",
    persist_chat: bool = False,
    response_language: str = "zh",
) -> Dict[str, Any]:
    if not user_id:
        raise ValueError("user_id is required")
    cleaned_question = str(question or "").strip()
    if not cleaned_question:
        raise ValueError("question is required")
    language = _normalize_response_language(response_language)
    safe_limit = max(1, min(12, int(limit or 8)))
    normalized_scope = str(scope or "all").strip().lower()
    scope_hint = _wiki_scope_hint(normalized_scope, language)
    resolved_nodes, resolved_mentions, unresolved_mentions = _resolve_wiki_mentions(
        user_id,
        cleaned_question,
        mentions,
        limit=6,
    )
    mode, routing_reason = _question_route(cleaned_question, normalized_scope, resolved_mentions)
    if _comparison_needs_mentions(cleaned_question, resolved_nodes):
        result = _selection_required_answer(
            _comparison_selection_required_message(language),
            response_language=language,
        )
        _apply_chat_metadata(
            result,
            mode="wiki",
            retrieval_required=True,
            routing_reason="mention_required",
            mentions=resolved_mentions,
            unresolved_mentions=unresolved_mentions,
            scope=normalized_scope,
            response_language=language,
        )
        _attach_chat_session(
            result,
            user_id=user_id,
            session_id=session_id,
            question=cleaned_question,
            persist_chat=persist_chat,
        )