Saltar al contenido
Descubrimiento de Herramientas

Descubrimiento de Herramientas

Cuando Pando acumula muchas herramientas (de servidores MCP, hooks Lua y herramientas incorporadas), el sistema de Descubrimiento de Herramientas maneja la complejidad mostrando solo un subconjunto visible y proporcionando búsqueda bajo demanda para el resto.

Cómo Funciona

Inspirado en el enfoque de VS Code Copilot:

  1. Herramientas core (bash, edit, view, glob, grep, write) siempre visibles
  2. Herramientas MCP y Lua se diferencian por defecto
  3. Cuando el conteo total de herramientas excede MaxDirectTools, la herramienta tool_search se activa
  4. El LLM busca en el registro completo por lenguaje natural
  5. Las herramientas descubiertas permanecen visibles para el resto de la sesión

Configuración

[ToolDiscovery]
Enabled = true
Mode = 'auto'            # 'auto', 'always', o 'off'
MaxDirectTools = 64       # Umbral para modo auto
SearchLimit = 8           # Resultados predeterminados de tool_search
NonDeferredTools = []     # Herramientas siempre visibles
DeferredSources = []      # Fuentes a diferir (ej. "mcp", "lua")

Modos

ModoComportamiento
autoSe activa cuando las herramientas exceden MaxDirectTools
alwaysSiempre difiere las herramientas no-core
offTodas las herramientas visibles (predeterminado para configuraciones pequeñas)

Búsqueda de Herramientas

El LLM llama a tool_search con una consulta en lenguaje natural:

{
  "query": "buscar código en el repositorio"
}

Los resultados se clasifican usando puntuación de frecuencia de términos sobre nombre, alias, nombre del servidor, descripción y nombres de parámetros.

Filtrado por Fuente

Las herramientas se categorizan por fuente:

  • core - Herramientas incorporadas (siempre visibles)
  • internal - Herramientas internas de Pando
  • mcp - Herramientas de servidores MCP externos
  • lua - Herramientas de hooks Lua
  • mesnada - Herramientas de orquestación
  • rag - Herramientas de base de conocimiento e índice de código
  • gateway - Re-exportaciones del gateway MCP
Para la mayoría de usuarios con menos de 64 herramientas, el Descubrimiento de Herramientas permanece inactivo. Solo se activa cuando el conteo de herramientas crece lo suficiente para impactar el uso del contexto.