Saltar al contenido
AX Principios
AX-SYS-10IntermedioBorrador

Expón solo las herramientas que el agente necesita

Expose only the tools the agent needs

#saas#mcp

Acota las herramientas por dominio y dale a cada una un propósito único y claro con resultados estructurados. No abrumes a un agente con cientos de operaciones.

Por qué

Acotar las herramientas por dominio mejora la fiabilidad; volcar 300 operaciones en un solo agente lo degrada (Speakeasy Toolability). La guía de producción de Anthropic es explícita: construye unas pocas herramientas bien pensadas orientadas a flujos de trabajo específicos de alto impacto. Las herramientas ocupan espacio en la ventana de contexto: cada herramienta listada es una elección que el modelo debe evaluar, y un conjunto de herramientas saturado degrada la precisión de selección y aumenta la probabilidad de llamadas mal dirigidas.

Haz

Proporciona conjuntos de herramientas acotados por dominio.

No hagas

Enviar un megaconjunto de herramientas único para cada agente.

Artefacto

Artefacto de configuración: expón conjuntos de herramientas acotados por dominio (por ejemplo orders, billing) en lugar de un único conjunto de 300 operaciones. Controla qué conjunto recibe un agente según sus alcances.

Fuentes

  1. [01]
    Speakeasy — Designing Agent Experience

    Toolability: scoping tools by domain and giving each a clear single purpose improves agent reliability; exposing too many operations degrades selection accuracy

  2. [02]
    Anthropic — Building Effective AI Agents

    Build a few thoughtful tools targeting specific high-impact workflows; a large, poorly-scoped toolset degrades agent decision quality and increases latency

  3. [03]
    Anthropic — Writing Effective Tools for AI Agents

    Tools are prominent in Claude's context window; developers should be conscious about how they design tools to maximize context efficiency and minimize misdirected calls