v0.9.5 is live! — Read the latest technical documentation and migration guides.

docmd-assistant v0.1.16 introduce extracción estructurada de Markdown desde el DOM para la lectura de páginas de documentación, entrega de contexto ilimitado para síntesis enriquecidas, deduplicación de registros en la nube en flujos multi-turno y sanitización refinada de consultas.

Características Principales y Mejoras

Extracción Estructurada de Contenido en Markdown

  • Preservación de Bloques de Código y Formato: El lector DOM integrado (read_documentation_page) ahora procesa documentos HTML en Markdown estructurado y limpio en lugar de texto plano. Los bloques de código con identificadores de lenguaje (pre/code), encabezados (#######), elementos de lista (-) y espaciados de párrafo se mantienen íntegros.
  • Filtrado de Elementos del Navegador y Cajones: Se eliminan automáticamente elementos secundarios antes de la extracción (nav, aside, header, footer, .toc, .sidebar, .docmd-ai-drawer y [aria-hidden="true"]), garantizando que solo el contenido técnico auténtico llegue al modelo.

Ventana de Contexto Ilimitada (contextWindow)

  • Síntesis de Alta Fidelidad: Se eliminó la restricción previa de 3.500 caracteres en read_documentation_page, permitiendo la lectura íntegra de páginas de referencia completas, tablas de configuración y ejemplos de código extensos.
  • Tamaño de Contexto Configurable: Se añadió contextWindow en AssistantOptions (valor por defecto: 0 / sin límite con entrega completa), sustituyendo los límites fijos y permitiendo optimizar tokens cuando sea necesario.

Optimización de Retransmisión y Analíticas Multi-Turno

  • Identificación de Turnos de Herramienta (isToolFollowUp): Las solicitudes posteriores dentro de bucles autónomos multi-turno envían ahora isToolFollowUp: true. Esto permite que los servidores de retransmisión y las métricas en la nube diferencien las preguntas iniciales de los usuarios de los pasos intermedios de herramientas, evitando registros duplicados.
  • Sanitización de Consultas: Elimina bloques de contexto de búsqueda residuales (\n\n[Documentation Search Context...]) de originalUserQuery y descarta comillas circundantes, evitando comillas huérfanas en los registros de chat.

Problemas Resueltos

  • Registro Duplicado en Analíticas: Solucionado el problema en el que ejecuciones intermedias de herramientas se contabilizaban como consultas repetidas de usuarios.
  • Comilla Inicial Huérfana ("): Corregido el artefacto en el que la expresión regular de sanitización dejaba una comilla de apertura al inicio de las consultas en los registros en la nube.
  • Aplanamiento de Código: Corregida la pérdida de indentación y saltos de línea al recuperar páginas mediante read_documentation_page.

Actualización

npm
pnpm
npm install docmd-assistant@0.1.16
pnpm add docmd-assistant@0.1.16