Endpoint /api/help/ask — proxy Help Widget → MCP workspace

Identificación

Responsabilidad

Actúa como proxy thin entre el Help Widget del frontend (Alpine.js) y el MCP workspace (bib_ask). Normaliza el modo (help | tutor), propaga el historial conversacional cuando corresponde, y devuelve la respuesta renderizada en HTML (_md_to_html).

No accede directamente a la base de datos ni al vector store — toda la lógica de recuperación vive en el workspace MCP.

Payload de entrada

{
  "question": "string (requerido)",
  "mode": "'tutor' | null",
  "source_type": "string | null",
  "app": "string | null",
  "history": [
    { "role": "user | assistant", "content": "string" }
  ]
}

Lógica de enrutamiento por modo

mode = "tutor" if payload.get("mode") == "tutor" else "help"
history = payload.get("history") if mode == "tutor" else None

• Modo help: búsqueda vectorial en la wiki de la app, filtrada por app y source_type. Sin historial.
• Modo tutor: conocimiento general de IT (el workspace skipea el vector search). Con historial multi-turn (desde s55). El campo app no se envía en este modo.

Ambos modos incluyen "archive": False — el archivado lo gestiona el cron diario del Curator, no el flujo del usuario final.

Respuesta

{
  "answer": "<p>HTML renderizado desde markdown</p>",
  "mode": "help | tutor",
  "sources": [ ... ]
}

El HTML lo genera _md_to_html en el proxy antes de devolver la respuesta. El frontend inyecta resp.answer directamente en el DOM via innerHTML (patrón CSP del proyecto).

Historial del endpoint

Endpoints relacionados del módulo core.api_help

Véase también

• [[feature—help—chat-tutor-multi-turn]]
• [[feature—help—it-tutor-mode]]
• [[concept—help—help-widget]]
• [[entity—core—endpoint—help-wiki]]
• [[entity—core—endpoint—help-article]]