Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Píblíne Il-Uirlisí

Ceacht 13 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Uirlisí a eagrú i seicheamh
  2. Ailtireacht na píblíne
  3. Sampla: píblíne faisnéise iomaíochta
  4. Forghníomhú na píblíne
  5. Uirlisí freastalaí agus cliant a chomhcheangal i bpíblíne
  6. Patrún: fan-out / fan-in
  7. Teipeanna a láimhseáil i bpíblíne
  8. Príomhphointí

Uirlisí a eagrú i seicheamh

Bhain an gníomhaire aimsire ón gcacht roimhe seo úsáid as uirlisí neamhspleácha. I bpíblíne il-uirlisí, beathaíonn torthaí ó uirlis amháin an glaoch seo chugainn. Déanann an tsamhail an seicheamh a eagrú go huathoibríoch—is é do ról ná na huirlisí a sholáthar agus na glaonna a fhorghníomhú.

Ailtireacht na píblíne

Leanann píblíne tipiciúil an scéama seo:

Cuardach → Anailís → Gníomh → Fógra

Táirgeann gach céim sonraí a úsáideann an chéad cheann eile. Láimhseálann an tsamhail an t-eagrú seo go nádúrtha mar gheall ar chomhthéacs an chomhrá.

Sampla: píblíne faisnéise iomaíochta

Samhlaigh píblíne a dhéanann monatóireacht ar phraghsanna iomaitheoirí agus a ghineann tuarascáil:

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

Forghníomhú na píblíne

Nuair a iarrann an t-úsáideoir, “Déan anailís ar phraghsanna CompetitorX dár 5 tháirge is fearr agus seol an tuarascáil chuig an bhfoireann díolacháin,” déanann an tsamhail eagrú ar:

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", ...)

Úsáideann gach casadh na torthaí ón gceann roimhe. Pasálann an tsamhail sonraí ó uirlis amháin go dtí an chéad uirlis eile go nádúrtha.

Uirlisí freastalaí agus cliant a chomhcheangal i bpíblíne

Is iad na píblíní is cumhachtaí ná cinn a chomhcheanglaíonn uirlisí freastalaí agus cliant:

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": { ... }
        }
    }
]

Sreabhadh: Déanann an tsamhail cuardach gréasáin (uathoibríoch ar thaobh an fhreastalaí), ansin glaonn sí ar d’fheidhm eastósctha (taobh an chliaint), agus ansin sábhálann sí chuig an CRM (taobh an chliaint).

Patrún: fan-out / fan-in

Éilíonn roinnt píblíní patrún fan-out (glonna comhthreomhara iolracha) agus ina dhiaidh sin fan-in (comhiomlánú torthaí):

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

Láimhseálann an tsamhail é seo go nádúrtha le glaonna comhthreomhara:

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={...})

Teipeanna a láimhseáil i bpíblíne

Láimhseálann píblíne láidir teipeanna ag gach céim:

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
    }

Nuair a theipeann ar chéim, is féidir leis an tsamhail:

  • Triail arís le paraiméadair choigeartaithe
  • An chéim a scipeáil agus leanúint ar aghaidh le sonraí páirteacha
  • An t-úsáideoir a chur ar an eolas agus treoracha a iarraidh

Príomhphointí

  • Cuireann píblíne il-uirlisí torthaí ó uirlis amháin i slabhra leis an gcéad cheann eile
  • Déanann an tsamhail an seicheamh a eagrú go huathoibríoch mar gheall ar an gcomhthéacs
  • Comhcheanglaíonn an patrún fan-out/fan-in glaonna comhthreomhara agus comhiomlánú
  • Comhcheangail uirlisí freastalaí (web_search) agus uirlisí cliant (do fheidhmeanna) le haghaidh píblíní hibrideacha
  • Láimhseáil teipeanna ag gach céim le hathiarracht agus cúltaca
  • Caithfidh gach uirlis sa phíblíne freagracht shoiléir, aonair a bheith aici