Ir al contenido principal
Español— Elegir un idioma
Menú

Canalización de herramientas múltiples

Lección 13 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. Orquestación de herramientas en secuencia
  2. Arquitectura de la canalización
  3. Ejemplo: canalización de inteligencia competitiva
  4. Ejecución de la canalización
  5. Combinación de herramientas de servidor y cliente en una canalización
  6. Patrón: dispersión / agregación (fan-out / fan-in)
  7. Gestión de fallos en una canalización
  8. Puntos clave

Orquestación de herramientas en secuencia

El agente meteorológico de la lección anterior utilizaba herramientas independientes. En una canalización de herramientas múltiples, los resultados de una herramienta alimentan la siguiente llamada. El modelo orquesta la secuencia automáticamente; tu función es proporcionar las herramientas y ejecutar las llamadas.

Arquitectura de la canalización

Una canalización típica sigue este esquema:

Búsqueda → Análisis → Acción → Notificación

Cada paso produce datos que consume el siguiente. El modelo gestiona esta orquestación de forma natural gracias al contexto de la conversación.

Ejemplo: canalización de inteligencia competitiva

Imagina una canalización que supervisa los precios de la competencia y genera un informe:

tools = [
    {
        "type": "function",
        "function": {
            "name": "scrape_competitor_prices",
            "description": "Recupera los precios actuales de un competidor "
                          "para una lista de productos. Devuelve un array "
                          "de {product, price, availability}.",
            "parameters": {
                "type": "object",
                "properties": {
                    "competitor": {
                        "type": "string",
                        "description": "Nombre del competidor"
                    },
                    "products": {
                        "type": "array",
                        "items": {"type": "string"},
                        "description": "Lista de productos a comprobar"
                    }
                },
                "required": ["competitor", "products"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "compare_with_our_prices",
            "description": "Compara los precios del competidor con los nuestros. "
                          "Devuelve las diferencias porcentuales y "
                          "recomendaciones de ajuste.",
            "parameters": {
                "type": "object",
                "properties": {
                    "competitor_prices": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "product": {"type": "string"},
                                "price": {"type": "number"}
                            }
                        }
                    }
                },
                "required": ["competitor_prices"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "generate_report",
            "description": "Genera un informe PDF con los resultados del "
                          "análisis comparativo. Devuelve la URL del informe.",
            "parameters": {
                "type": "object",
                "properties": {
                    "title": {"type": "string"},
                    "data": {"type": "object"},
                    "format": {
                        "type": "string",
                        "enum": ["pdf", "csv", "json"]
                    }
                },
                "required": ["title", "data"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "send_notification",
            "description": "Envía una notificación por correo electrónico o Slack "
                          "con un resumen y un enlace al informe.",
            "parameters": {
                "type": "object",
                "properties": {
                    "channel": {
                        "type": "string",
                        "enum": ["email", "slack"]
                    },
                    "recipient": {"type": "string"},
                    "message": {"type": "string"},
                    "attachment_url": {"type": "string"}
                },
                "required": ["channel", "recipient", "message"]
            }
        }
    }
]

Ejecución de la canalización

Cuando el usuario pregunta: «Analiza los precios de CompetitorX para nuestros 5 productos principales y envía el informe al equipo de ventas», el modelo orquesta:

Turno 1 : scrape_competitor_prices(competitor="CompetitorX", products=[...])
Turno 2 : compare_with_our_prices(competitor_prices=[resultados del turno 1])
Turno 3 : generate_report(title="Supervisión de precios de CompetitorX", data={...})
Turno 4 : send_notification(channel="slack", recipient="#sales", ...)

Cada turno utiliza los resultados del anterior. El modelo transfiere los datos de una herramienta a la siguiente de forma natural.

Combinación de herramientas de servidor y cliente en una canalización

Las canalizaciones más potentes combinan herramientas de servidor y de cliente:

tools = [
    {"type": "web_search"},  # Servidor: búsqueda web
    {
        "type": "function",
        "function": {
            "name": "extract_data",
            "description": "Extrae datos estructurados de texto sin formato",
            "parameters": { ... }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "save_to_crm",
            "description": "Guarda los datos extraídos en el CRM",
            "parameters": { ... }
        }
    }
]

Flujo: el modelo realiza una búsqueda web (automática en el lado del servidor), luego llama a tu función de extracción (lado del cliente) y finalmente guarda los datos en el CRM (lado del cliente).

Patrón: dispersión / agregación (fan-out / fan-in)

Algunas canalizaciones requieren un patrón de dispersión (múltiples llamadas paralelas) seguido de una agregación (consolidación de resultados):

         ┌→ scrape_site_A ─┐
Solicitud ─┤→ scrape_site_B ─┤→ aggregate_results → generate_report
         └→ scrape_site_C ─┘

El modelo gestiona esto de forma natural con llamadas paralelas:

Turno 1 : [scrape_site_A, scrape_site_B, scrape_site_C]  (paralelo)
Turno 2 : aggregate_results(data=[result_A, result_B, result_C])
Turno 3 : generate_report(aggregated_data={...})

Gestión de fallos en una canalización

Una canalización robusta gestiona los fallos en cada paso:

def execute_with_retry(name, args, max_retries=2):
    for attempt in range(max_retries + 1):
        try:
            result = execute_function(name, args)
            if "error" not in result:
                return result
        except Exception:
            pass

        if attempt < max_retries:
            time.sleep(1)  # Esperar antes de reintentar

    return {
        "error": f"Fallo después de {max_retries + 1} intentos",
        "function": name,
        "partial_data": None
    }

Cuando un paso falla, el modelo puede:

  • Reintentar con parámetros ajustados
  • Omitir el paso y continuar con datos parciales
  • Informar al usuario y solicitar instrucciones

Puntos clave

  • Una canalización de herramientas múltiples encadena los resultados de una herramienta con la siguiente
  • El modelo orquesta la secuencia automáticamente gracias al contexto
  • El patrón de dispersión/agregación combina llamadas paralelas y consolidación
  • Combina herramientas de servidor (web_search) y de cliente (tus funciones) para canalizaciones híbridas
  • Gestiona los fallos en cada paso con reintentos y planes de contingencia
  • Cada herramienta en la canalización debe tener una responsabilidad única y clara