Salt la conținutul principal
Română— Alege o limbă
Meniu

Flux de lucru cu instrumente multiple

Lecția 13 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Orchestarea instrumentelor în secvență
  2. Arhitectura fluxului de lucru
  3. Exemplu: flux de lucru pentru intelligence competitiv
  4. Executarea fluxului de lucru
  5. Combinarea instrumentelor server și client într-un flux de lucru
  6. Model: fan-out / fan-in
  7. Gestionarea erorilor într-un flux de lucru
  8. Puncte cheie

Orchestarea instrumentelor în secvență

Agentul meteorologic din lecția anterioară utiliza instrumente independente. Într-un flux de lucru cu instrumente multiple, rezultatele unui instrument alimentează apelul următor. Modelul orchestrează secvența automat; rolul dumneavoastră este să furnizați instrumentele și să executați apelurile.

Arhitectura fluxului de lucru

Un flux de lucru tipic urmează această schemă:

Căutare → Analiză → Acțiune → Notificare

Fiecare pas produce date consumate de pasul următor. Modelul gestionează această orchestrare în mod natural datorită contextului conversației.

Exemplu: flux de lucru pentru intelligence competitiv

Imaginați-vă un flux de lucru care monitorizează prețurile concurenților și generează un raport:

tools = [
    {
        "type": "function",
        "function": {
            "name": "scrape_competitor_prices",
            "description": "Retrieve current prices from a competitor "
                          "for a list of products. Returns an array "
                          "of {product, price, availability}.",
            "parameters": {
                "type": "object",
                "properties": {
                    "competitor": {
                        "type": "string",
                        "description": "Competitor name"
                    },
                    "products": {
                        "type": "array",
                        "items": {"type": "string"},
                        "description": "List of products to check"
                    }
                },
                "required": ["competitor", "products"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "compare_with_our_prices",
            "description": "Compare competitor prices with our prices. "
                          "Returns percentage gaps and adjustment "
                          "recommendations.",
            "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": "Generate a PDF report with the benchmark "
                          "analysis results. Returns the report URL.",
            "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": "Send an email or Slack notification "
                          "with a summary and a link to the report.",
            "parameters": {
                "type": "object",
                "properties": {
                    "channel": {
                        "type": "string",
                        "enum": ["email", "slack"]
                    },
                    "recipient": {"type": "string"},
                    "message": {"type": "string"},
                    "attachment_url": {"type": "string"}
                },
                "required": ["channel", "recipient", "message"]
            }
        }
    }
]

Executarea fluxului de lucru

Când utilizatorul solicită: „Analizează prețurile CompetitorX pentru cele mai bine vândute 5 produse ale noastre și trimite raportul echipei de vânzări“, modelul orchestrează:

Runda 1 : scrape_competitor_prices(competitor="CompetitorX", products=[...])
Runda 2 : compare_with_our_prices(competitor_prices=[rezultate din runda 1])
Runda 3 : generate_report(title="Monitorizare prețuri CompetitorX", data={...})
Runda 4 : send_notification(channel="slack", recipient="#sales", ...)

Fiecare rundă utilizează rezultatele rundei precedente. Modelul transmite în mod natural datele de la un instrument la următorul.

Combinarea instrumentelor server și client într-un flux de lucru

Cele mai puternice fluxuri de lucru combină instrumentele server și client:

tools = [
    {"type": "web_search"},  # Server: căutare web
    {
        "type": "function",
        "function": {
            "name": "extract_data",
            "description": "Extract structured data from raw text",
            "parameters": { ... }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "save_to_crm",
            "description": "Save extracted data to the CRM",
            "parameters": { ... }
        }
    }
]

Flux: modelul efectuează o căutare web (automat pe partea server), apoi apelează funcția dumneavoastră de extragere (partea client), iar în final salvează datele în CRM (partea client).

Model: fan-out / fan-in

Unele fluxuri de lucru necesită un model fan-out (apeluri multiple paralele) urmat de un fan-in (agregarea rezultatelor):

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

Modelul gestionează acest lucru în mod natural prin apeluri paralele:

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

Gestionarea erorilor într-un flux de lucru

Un flux de lucru robust gestionează erorile la fiecare pas:

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)  # Wait before retry

    return {
        "error": f"Failed after {max_retries + 1} attempts",
        "function": name,
        "partial_data": None
    }

Când un pas eșuează, modelul poate:

  • Să reîncerce cu parametri ajustați
  • Să omită pasul și să continue cu date parțiale
  • Să informeze utilizatorul și să solicite instrucțiuni

Puncte cheie

  • Un flux de lucru cu instrumente multiple înlănțuie rezultatele de la un instrument la următorul
  • Modelul orchestrează secvența automat datorită contextului
  • Modelul fan-out/fan-in combină apelurile paralele și agregarea
  • Combinați instrumentele server (web_search) și instrumentele client (funcțiile dumneavoastră) pentru fluxuri de lucru hibride
  • Gestionați erorile la fiecare pas prin reîncercare și soluții de rezervă
  • Fiecare instrument din fluxul de lucru trebuie să aibă o responsabilitate clară și unică