Saltar al contenido principal

Agente IA directa con MCP

Además del modo aiflow (flujo explícito), AIFlows soporta el modo ia_direct: el bot delega el control a un agente que decide en cada turno qué tool invocar para responder al usuario.

¿Qué es MCP?​

Model Context Protocol es un estándar abierto para que un LLM invoque herramientas externas de forma estructurada. El servidor MCP expone:

  • Lista de herramientas (nombre, descripción, esquema de inputs/outputs).
  • Método para ejecutar cada tool.

En AIFlows, las funciones del proyecto se registran automáticamente como tools MCP cuando tienen type: "tool" o "mixed".

Configurar una línea en modo ia_direct​

{
  "lineId": "line_support",
  "mode": "ia_direct",
  "providerConfigId": "pc_anthropic_prod",
  "systemPrompt": "Sos un agente de soporte. Usá las tools disponibles para responder al cliente.",
  "tools": [
    "lookupCustomer",
    "createTicket",
    "scheduleCallback"
  ],
  "maxToolCallsPerTurn": 5,
  "maxTurnsPerSession": 30
}

Anti-loop​

Para evitar que el agente entre en loops de tool calls, AIFlows impone:

  • maxToolCallsPerTurn: máximo de invocaciones a tools por turno.
  • maxTurnsPerSession: máximo de turnos por sesión antes de forzar end.
  • Detección de tool calls repetidos idénticos: si el agente llama 3 veces seguidas al mismo tool con los mismos inputs, se corta y se escala a humano.

Herramientas externas vía MCP server​

Además de las funciones del proyecto, podés apuntar a un MCP server externo:

{
  "mcpServers": [
    {
      "name": "crm",
      "transport": "http",
      "url": "https://mcp.example.com/crm",
      "auth": { "type": "bearer", "tokenRef": "env.MCP_CRM_TOKEN" }
    }
  ]
}

El agente ve las tools de ese server combinadas con las funciones locales.

Estado y métricas​

Cada sesión ia_direct produce:

  • Lista de turnos con tool calls y resultados.
  • Tokens consumidos (input/output/reasoning/cache).
  • Coste calculado según AIUsage.
  • Outcome final (success, handoff, error, capped).

Estado: 🟡 Fase 6 — implementación parcial. Detalles: doc-iaflows/14-AGENTE-IA-DIRECTA.md.