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

docmd-assistant v0.1.17 convierte el motor del asistente en una solución totalmente universal e independiente del sitio, añade filtros específicos de búsqueda por versión y subproyecto, introduce una limitación de contenido en páginas de documentación extensas para optimizar tokens, refuerza los límites de la ventana de contexto y mejora la tolerancia a fallos de red.

Características Principales y Mejoras

Prompt de Sistema Universal e Independiente del Sitio

  • Descubrimiento Auténtico del Conocimiento: Reemplaza las suposiciones fijas de configuración por un prompt universal y neutro. En lugar de predecir esquemas de configuración específicos, el asistente descubre y fundamenta sus respuestas dinámicamente mediante las herramientas disponibles (search_documentation, read_documentation_page). Esto garantiza su funcionamiento natural en cualquier sitio de documentación, blog técnico o guía de proyectos.
  • Identidad Coherente del Asistente: Mantiene la identidad de “docmd assistant” como un guía experto de inteligencia artificial dedicado al sitio, respondiendo estrictamente dentro de los límites del contenido documentado.

Búsqueda Filtrada por Versión y Proyecto

  • Filtrado Focalizado por Versión: Se extendió el esquema de la herramienta search_documentation con parámetros opcionales de version (por ejemplo, "0.9.0", "0.8.0", "latest") y project, permitiendo consultar directamente archivos técnicos de versiones específicas en sitios multiversión.
  • Paso Directo a Proveedores Personalizados: Las funciones de búsqueda personalizadas pasadas a createStandardTools ahora reciben los argumentos (query, project, version) para una consulta granular en el índice.

Limitación Inteligente de Contenido y Protección del Contexto

  • Ahorro de Tokens en el Lector DOM: Se añadió un límite máximo de 8.000 caracteres con un aviso de continuidad (...[content capped for token economy]) en read_documentation_page. Esto evita que especificaciones de API excesivamente extensas agoten la ventana de contexto del LLM, reteniendo el texto explicativo y los ejemplos de código esenciales.
  • Piso Mínimo de Seguridad para el Contexto: Se estableció un umbral mínimo de 1.000 caracteres en la opción contextWindow, evitando que valores accidentales o erróneos vacíen el contexto técnico recuperado.

Gestión Resiliente de Errores de Red

  • Mensajes de Red Claros y Accionables: Intercepta fallos de conectividad del navegador (Failed to fetch, Load failed) tanto en modo de transmisión continua (streaming) como en peticiones estándar, proporcionando explicaciones claras para el usuario.
  • Cancelación Limpia: Gestiona peticiones canceladas y eventos AbortError de manera limpia, sin generar registros de error innecesarios.

Problemas Resueltos

  • Recuperación Universal: Resuelto un problema por el cual las instrucciones rígidas del prompt por defecto hacían que el asistente asumiera estructuras de docmd.config.json, en lugar de recuperar dinámicamente la configuración real documentada en el sitio.
  • Precisión en Consultas con Versión: Corregido un fallo donde consultas orientadas a versiones (como notas de lanzamientos anteriores) no podían restringir el rango de búsqueda a la versión solicitada.

Actualización

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