Flux de lucru cu instrumente multiple
Pe această pagină
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ă