Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Pattern di combinazione degli strumenti

Lezione 10 di 12 Aggiornata il 30 luglio 2026 Avanzato
In questa pagina
  1. Combina gli strumenti per compiti complessi
  2. Pattern 1: Ricerca + Analisi
  3. Pattern 2: Notizie da più fonti
  4. Pattern 3: Estrazione da più fonti con funzioni
  5. Pattern 4: Convalida incrociata
  6. Migliori pratiche
  7. Punti chiave

Combina gli strumenti per compiti complessi

Gli strumenti di Grok diventano davvero potenti quando li combini. La ricerca web da sola fornisce dati grezzi. Aggiungendo l’esecuzione del codice, puoi analizzare quei dati. Integrando le tue funzioni personalizzate, puoi agire sui risultati. Questa lezione copre i pattern di combinazione più utili.

Pattern 1: Ricerca + Analisi

Il caso d’uso più comune combina la ricerca web con l’esecuzione del codice per raccogliere dati e trarre conclusioni:

response = await client.chat.completions.create(
    model="grok-4.5",
    messages=[{
        "role": "user",
        "content": "Look up the stock prices for Tesla, Apple, and Microsoft over the last 30 days. "
                   "Calculate relative performance and identify the trend."
    }],
    tools=[
        {"type": "web_search"},
        {"type": "code_interpreter"}
    ],
    max_turns=5
)

Grok inizia con una ricerca web per ottenere dati finanziari, quindi utilizza l’esecuzione del codice per calcolare le prestazioni e generare un grafico. Tutto avviene in una singola richiesta grazie a un valore sufficiente di max_turns.

Pattern 2: Notizie da più fonti

Combinare la ricerca web e la ricerca su X offre una copertura completa su un argomento:

response = await client.chat.completions.create(
    model="grok-4.5",
    messages=[{
        "role": "user",
        "content": "What are the reactions to the announcement of the new AI regulation in Europe? "
                   "Compare official sources and reactions on X."
    }],
    tools=[
        {"type": "web_search"},
        {"type": "x_search"}
    ],
    max_turns=5
)

La ricerca web cattura articoli di stampa e comunicati ufficiali, mentre la ricerca su X raccoglie reazioni e opinioni in tempo reale.

Pattern 3: Estrazione da più fonti con funzioni

Per flussi di lavoro più complessi, combina gli strumenti del server con le tue funzioni personalizzate:

tools = [
    {"type": "web_search"},
    {"type": "code_interpreter"},
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Saves structured results to the database",
            "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"Research and analyze: {topic}. "
                 "Save the structured results."}]

    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)
                })

In questo pattern, Grok cerca le informazioni, le analizza con il codice e chiama poi la tua funzione per salvare i risultati. Il flusso di lavoro è completamente autonomo.

Pattern 4: Convalida incrociata

Utilizza più fonti per verificare l’affidabilità delle informazioni:

response = await client.chat.completions.create(
    model="grok-4.5",
    messages=[{
        "role": "user",
        "content": "Verify this claim by cross-referencing sources: "
                   "'France produced 70% of its electricity from nuclear power in 2024.' "
                   "Compare data from multiple official sources."
    }],
    tools=[
        {"type": "web_search"},
        {"type": "code_interpreter"}
    ],
    max_turns=8
)

Con un valore di max_turns più elevato, Grok può eseguire più ricerche successive per incrociare le informazioni e utilizzare l’esecuzione del codice per confrontare le cifre.

Migliori pratiche

Specifica gli strumenti nel prompt

Non limitarti a dichiarare gli strumenti nel parametro tools. Indica esplicitamente nel tuo prompt cosa ti aspetti:

# BENE: il prompt guida l'uso degli strumenti
"""Search for the data, then use code to generate a comparison table.
Save the final result via save_to_database."""

# MALE: il prompt non menziona gli strumenti
"Give me information on this topic."

Limita gli strumenti allo stretto necessario

Non abilitare ogni strumento se ne ti serve solo uno. Ogni strumento aggiunge contesto al prompt di sistema, consumando token e rischiando di distrarre il modello.

Punti chiave

  • Ricerca + Esecuzione codice ti permette di raccogliere e analizzare dati in una singola richiesta
  • Ricerca web + Ricerca su X offre una copertura completa (articoli + reazioni)
  • Le funzioni personalizzate estendono le capacità oltre ciò che offrono gli strumenti del server
  • Guida esplicitamente Grok nel tuo prompt sugli strumenti da utilizzare
  • Adatta max_turns alla complessità del flusso di lavoro (5-8 per combinazioni multi-strumento)
  • Abilita solo gli strumenti necessari per ottimizzare il consumo di token