Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Pajp ta' Għodod Multipli

Lezzjoni 13 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Orkestrazzjoni ta’ għodod f’sekwenza
  2. Arkitettura tal-pajp
  3. Eżempju: pajp ta’ intelligence kompetittiva
  4. Eżekuzzjoni tal-pajp
  5. Tagħqid ta’ għodod tas-server u tal-klijent f’pajp
  6. Mudell: fan-out / fan-in
  7. Ġestjoni tal-fallimenti f’pajp
  8. Punti Ewlenin

Orkestrazzjoni ta’ għodod f’sekwenza

L-aġent tat-temp mil-lezzjoni ta’ qabel uża għodod indipendenti. F’pajp ta’ għodod multipli, ir-riżultati minn għodda waħda jitimgħu s-sejħa li jmiss. Il-mudell jorkestra s-sekwenza awtomatikament—ir-rwol tiegħek huwa li tipprovdi l-għodod u twettaq is-sejħiet.

Arkitettura tal-pajp

Pajp tipiku jsegwi dan l-iskema:

Search → Analysis → Action → Notification

Kull pass jipproduċi data kkunsmata mill-pass li jmiss. Il-mudell jimmaniġġja din l-orkestrazzjoni b’mod naturali grazzi għall-kuntest tal-konversazzjoni.

Eżempju: pajp ta’ intelligence kompetittiva

Immaġina pajp li jmonitorja l-prezzijiet tal-kompetituri u jiġġenera rapport:

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"]
            }
        }
    }
]

Eżekuzzjoni tal-pajp

Meta l-utent jistaqsi, “Analizza l-prezzijiet ta’ CompetitorX għall-5 prodotti ewlenin tagħna u ibgħat ir-rapport lit-tim tal-bejgħ,” il-mudell jorkestra:

Turn 1 : scrape_competitor_prices(competitor="CompetitorX", products=[...])
Turn 2 : compare_with_our_prices(competitor_prices=[results from turn 1])
Turn 3 : generate_report(title="CompetitorX Price Monitoring", data={...})
Turn 4 : send_notification(channel="slack", recipient="#sales", ...)

Kull dawra tuża r-riżultati minn dik ta’ qabilha. Il-mudell jgħaddi d-data b’mod naturali minn għodda għall-oħra.

Tagħqid ta’ għodod tas-server u tal-klijent f’pajp

L-aktar pajps qawwija jgħaqqdu għodod tas-server u tal-klijent:

tools = [
    {"type": "web_search"},  # Server: web search
    {
        "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": { ... }
        }
    }
]

Fluss: il-mudell iwettaq tfittxija fuq il-web (awtomatika fuq in-naħa tas-server), imbagħad isejjaħ il-funzjoni ta’ estrazzjoni tiegħek (naħa tal-klijent), u mbagħad isalva fil-CRM (naħa tal-klijent).

Mudell: fan-out / fan-in

Xi pajps jeħtieġu mudell fan-out (sejħiet paralleli multipli) segwit minn fan-in (aggregazzjoni tar-riżultati):

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

Il-mudell jimmaniġġja dan b’mod naturali b’sejħiet paralleli:

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

Ġestjoni tal-fallimenti f’pajp

Pajp robustu jittratta l-fallimenti f’kull pass:

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
    }

Meta pass ifalli, il-mudell jista’:

  • Jipprova mill-ġdid b’parametri aġġustati
  • Jaqbeż il-pass u jkompli b’data parzjali
  • Jgħarraf lill-utent u jitlob struzzjonijiet

Punti Ewlenin

  • Pajp ta’ għodod multipli jgħaqqad ir-riżultati minn għodda waħda mal-oħra
  • Il-mudell jorkestra s-sekwenza awtomatikament grazzi għall-kuntest
  • Il-mudell fan-out/fan-in jgħaqqad sejħiet paralleli u aggregazzjoni
  • Għaqqad għodod tas-server (web_search) u għodod tal-klijent (il-funzjonijiet tiegħek) għal pajps ibridi
  • Ipproċessa l-fallimenti f’kull pass b’tentattivi mill-ġdid u pjanijiet alternattivi
  • Kull għodda fil-pajp trid ikollha responsabbiltà waħda ċara u unika