Píblíne Il-Uirlisí
Ar an leathanach seo
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