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

Patrones de combinación de herramientas

Lección 10 de 12 Actualizado el 30 de julio de 2026 Avanzado
En esta página
  1. Combina herramientas para tareas complejas
  2. Patrón 1: Búsqueda + Análisis
  3. Patrón 2: Noticias de múltiples fuentes
  4. Patrón 3: Extracción de múltiples fuentes con funciones
  5. Patrón 4: Validación cruzada
  6. Mejores prácticas
  7. Puntos clave

Combina herramientas para tareas complejas

Las herramientas de Grok adquieren su verdadero potencial cuando las combinas. La búsqueda web por sí sola proporciona datos en bruto. Si añades ejecución de código, puedes analizar esos datos. Si incorporas tus funciones personalizadas, puedes actuar sobre los resultados. Esta lección cubre los patrones de combinación más útiles.

Patrón 1: Búsqueda + Análisis

El caso de uso más común combina la búsqueda web con la ejecución de código para recopilar datos y extraer conclusiones:

response = await client.chat.completions.create(
    model="grok-4.5",
    messages=[{
        "role": "user",
        "content": "Busca los precios de las acciones de Tesla, Apple y Microsoft durante los últimos 30 días. "
                   "Calcula el rendimiento relativo e identifica la tendencia."
    }],
    tools=[
        {"type": "web_search"},
        {"type": "code_interpreter"}
    ],
    max_turns=5
)

Grok comienza con una búsqueda web para obtener datos financieros y, a continuación, utiliza la ejecución de código para calcular el rendimiento y generar un gráfico. Todo ocurre en una única solicitud gracias a un valor de max_turns suficiente.

Patrón 2: Noticias de múltiples fuentes

Combinar la búsqueda web y la búsqueda en X ofrece una cobertura exhaustiva sobre un tema:

response = await client.chat.completions.create(
    model="grok-4.5",
    messages=[{
        "role": "user",
        "content": "¿Cuáles son las reacciones al anuncio de la nueva regulación de IA en Europa? "
                   "Compara las fuentes oficiales con las reacciones en X."
    }],
    tools=[
        {"type": "web_search"},
        {"type": "x_search"}
    ],
    max_turns=5
)

La búsqueda web captura artículos de prensa y comunicados oficiales, mientras que la búsqueda en X recoge reacciones y opiniones en tiempo real.

Patrón 3: Extracción de múltiples fuentes con funciones

Para flujos de trabajo más complejos, combina las herramientas del servidor con tus funciones personalizadas:

tools = [
    {"type": "web_search"},
    {"type": "code_interpreter"},
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Guarda resultados estructurados en la base de datos",
            "parameters": {
                "type": "object",
                "properties": {
                    "category": {"type": "string"},
                    "data": {"type": "object"},
                    "source_urls": {"type": "array", "items": {"type": "string"}}
                },
                "required": ["category", "data"]
            }
        }
    }
]

async def research_and_save(topic: str) -> str:
    messages = [{"role": "user", "content": f"Investiga y analiza: {topic}. "
                 "Guarda los resultados estructurados."}]

    while True:
        response = await client.chat.completions.create(
            model="grok-4.5",
            messages=messages,
            tools=tools,
            max_turns=5
        )

        message = response.choices[0].message

        if not message.tool_calls:
            return message.content

        messages.append(message)
        for tc in message.tool_calls:
            if tc.function.name == "save_to_database":
                result = await save_to_db(json.loads(tc.function.arguments))
                messages.append({
                    "role": "tool",
                    "tool_call_id": tc.id,
                    "content": json.dumps(result)
                })

En este patrón, Grok busca información, la analiza mediante código y, finalmente, llama a tu función para guardar los resultados. El flujo de trabajo es totalmente autónomo.

Patrón 4: Validación cruzada

Utiliza múltiples fuentes para verificar la fiabilidad de la información:

response = await client.chat.completions.create(
    model="grok-4.5",
    messages=[{
        "role": "user",
        "content": "Verifica esta afirmación contrastando fuentes: "
                   "'Francia produjo el 70 % de su electricidad a partir de energía nuclear en 2024.' "
                   "Compara datos de varias fuentes oficiales."
    }],
    tools=[
        {"type": "web_search"},
        {"type": "code_interpreter"}
    ],
    max_turns=8
)

Con un valor de max_turns más alto, Grok puede realizar varias búsquedas sucesivas para contrastar la información y utilizar la ejecución de código para comparar las cifras.

Mejores prácticas

Especifica las herramientas en el prompt

No te limites a declarar las herramientas en el parámetro tools. Indica explícitamente en tu prompt qué esperas:

# CORRECTO: el prompt guía el uso de las herramientas
"""Busca los datos y, a continuación, utiliza código para generar una tabla comparativa.
Guarda el resultado final mediante save_to_database."""

# INCORRECTO: el prompt no menciona las herramientas
"Dame información sobre este tema."

Limita las herramientas a lo necesario

No actives todas las herramientas si solo necesitas una. Cada herramienta añade contexto al prompt del sistema, lo que consume tokens y puede distraer al modelo.

Puntos clave

  • Búsqueda + Ejecución de código te permite recopilar y analizar datos en una única solicitud
  • Búsqueda web + Búsqueda en X ofrece una cobertura exhaustiva (artículos + reacciones)
  • Las funciones personalizadas amplían las capacidades más allá de lo que ofrecen las herramientas del servidor
  • Guía explícitamente a Grok en tu prompt sobre qué herramientas debe utilizar
  • Adapta max_turns a la complejidad del flujo de trabajo (5-8 para combinaciones de múltiples herramientas)
  • Activa solo las herramientas necesarias para optimizar el consumo de tokens