Tfittxija tal-Għodod: Għodod Dinamiċi
F'din il-paġna
Tfittxija tal-Għodod: Għodod Dinamiċi
Aġent demo jgħix tajjeb bi tlieta jew erba’ għodod biss. Madankollu, aġent intrapriżali jakkumula inevitabbilment għexieren, u xi kultant mijiet ta’ għodod: fatturazzjoni, riżorsi umani, CRM, dokumenti, skedar. F’dik l-iskala, li tibgħat il-katalgu sħiħ lill-mudell ma’ kull talba jsir ineffiċjenti u għali f’termini ta’ tokens. It-Tfittxija tal-Għodod (Tool Search) issolvi din il-problema billi tagħżel dinamikament l-għodod rilevanti għal kull talba.
Il-Problema ta’ Għodod Wisq
Immaġina aġent b’50 għodda. Fuq kull sejħa API, l-iskemi tal-50 għodda kollha jintbagħtu fil-prompt. Dan jikkonsma eluf ta’ tokens u jista’ jħawwad il-mudell: itwal tkun il-lista, aktar isiru simili d-deskrizzjonijiet, u aktar jibża’ l-mudell bejn għodod viċini. L-ispejjeż jogħlew filwaqt li l-preċiżjoni tonqos—l-agħar kombinazzjoni possibbli.
# Problema: wisq għodod
agent = Agent(
name="Super Agent",
instructions="Tista' tagħmel kollox.",
tools=[tool_1, tool_2, tool_3, ... , tool_50], # 50 għodda = ħafna tokens
)
Kif Tattiva t-Tfittxija tal-Għodod
It-Tfittxija tal-Għodod tuża indiċi semantiku biex tagħżel għodod rilevanti bbażati fuq it-talba. Tiddikjara l-għodod tiegħek bħas-soltu, iżda l-parametru tool_use_behavior="auto" jħalli lill-mudell jagħżel mill-katalgu minflok ma jitgħabba kollox minn qabel. Fl-eżempju hawn taħt, talba biex tibgħat tfakkira ta’ ħlas ma tattivax għodod tar-riżorsi umani, u viċi versa.
from agents import Agent, Runner, function_tool
# Iddefinixxi ħafna għodod
@function_tool
def create_invoice(client: str, amount: float) -> str:
"""Toħloq fattura għal klijent."""
return f"Fattura maħluqa għal {client}: €{amount}"
@function_tool
def send_reminder(invoice_id: str) -> str:
"""Tibgħat tfakkira ta' ħlas għal fattura mhux imħallsa."""
return f" Tfakkira mibgħuta għall-fattura {invoice_id}"
@function_tool
def generate_hr_report(month: str) -> str:
"""Tiġġenera rapport tar-riżorsi umani għal xahar partikolari."""
return f"Rapport HR iġġenerat għal {month}"
@function_tool
def schedule_interview(candidate: str, date: str) -> str:
"""Tiskeda intervista tax-xogħol ma' kandidat."""
return f"Intervista skedata ma' {candidate} fi {date}"
# Ħafna għodod oħra...
agent = Agent(
name="Enterprise Agent",
instructions="Timmaniġġja l-operazzjonijiet tal-kumpanija.",
tools=[
create_invoice,
send_reminder,
generate_hr_report,
schedule_interview,
# ... 50 għodda oħra
],
tool_use_behavior="auto", # Il-mudell jagħżel dinamikament
)
Mudell: Għażla Manwali tal-Għodod
Jekk trid kontroll totali fuq l-għażla tal-għodod, implimenta l-loġika tiegħek stess. Il-prinċipju huwa sempliċi: aġent router żgħir jaqra t-talba u sempliċiment isemmi d-dominju rilevanti. Imbagħad tibni l-aġent speċjalizzat fuq it-titjira bl-għodod biss għal dak id-dominju. Frażi bħal “ibgħat tfakkira għall-fattura F-2026-114” toħroġ mir-router bir-risposta accounting, u l-aġent ta’ eżekuzzjoni qatt ma jara l-għodod tal-HR.
from agents import Agent, Runner, function_tool
# Iggroupja l-għodod skont id-dominju
accounting_tools = [create_invoice, send_reminder]
hr_tools = [generate_hr_report, schedule_interview]
# Aġent router li jagħżel id-dominju
router = Agent(
name="Router",
instructions="""Iddetermina d-dominju tat-talba.
Wieġeb biss b' 'accounting' jew 'hr'.""",
model="gpt-5.6-terra", # Mgħaġġel u rħis għar-routing
output_type=str,
)
async def handle_request(message: str):
# Pass 1: Iddetermina d-dominju
route = await Runner.run(router, message)
domain = route.final_output.strip().lower()
# Pass 2: Oħloq l-aġent speċjalizzat bl-għodod it-tajba
if domain == "accounting":
tools = accounting_tools
instructions = "Timmaniġġja l-kontabbiltà tal-kumpanija."
elif domain == "hr":
tools = hr_tools
instructions = "Timmaniġġja r-riżorsi umani."
else:
tools = accounting_tools + hr_tools
instructions = "Timmaniġġja l-operazzjonijiet tal-kumpanija."
specialized_agent = Agent(
name=f"{domain.capitalize()} Agent",
instructions=instructions,
tools=tools,
model="gpt-5.6-terra",
)
result = await Runner.run(specialized_agent, message)
return result.final_output
L-użu ta’ gpt-5.6-terra kemm għar-routing kif ukoll għall-eżekuzzjoni jappartjeni għall-ġenerazzjoni preċedenti ta’ mudelli; ir-raġunament wara dan il-mudell jibqa’ identiku mal-familja GPT-5.6, fejn is-settings tal-isforz jiddistingwu r-router mgħaġġel mill-eżekutur.
Mudell: Għodod Dinamiċi Sensittivi għall-Kuntest
L-għażla ma tiddependix biss fuq il-mistoqsija magħmula; tiddependi wkoll fuq min qed jistaqsi. Tista’ tadatta l-għodod disponibbli bbażat fuq l-utent li daħal, u hekk taqta’ żewġ għasafar b’ġebla waħda: inqas tokens mibgħuta, u, l-aktar importanti, kontrolli tal-aċċess infurzati qabel ma l-mudell saħansitra jirraġuna. Impjegat tal-bejgħ jikseb għodod ta’ kwotazzjoni, iżda delete_account sempliċiment ma teżistix fl-aġent tiegħu.
from dataclasses import dataclass
@dataclass
class UserContext:
role: str # "admin", "manager", "employee"
department: str
def get_tools_for_role(ctx: UserContext) -> list:
"""Tirritorna għodod awtorizzati bbażati fuq ir-rwol."""
base_tools = [search_document, view_schedule]
if ctx.role in ("admin", "manager"):
base_tools.extend([create_invoice, generate_hr_report])
if ctx.role == "admin":
base_tools.extend([modify_permissions, delete_account])
if ctx.department == "sales":
base_tools.extend([search_client, create_quote])
return base_tools
async def create_agent_for_user(ctx: UserContext):
tools = get_tools_for_role(ctx)
return Agent(
name="Custom Agent",
instructions=f"Inti tgħin lil {ctx.role} fid-dipartiment tal-{ctx.department}.",
tools=tools,
model="gpt-5.6-terra",
)
Ottimizzazzjoni tad-Deskrizzjonijiet tal-Għodod
Ikun xi jkun il-mekkaniżmu tal-għażla li tagħżel, dan jiddependi fuq materjal wieħed: it-test tad-deskrizzjonijiet tiegħek. Il-kwalità ta’ dawn id-deskrizzjonijiet taffettwa direttament ir-rilevanza tal-għażla. Qabbel iż-żewġ dikjarazzjonijiet hawn taħt: l-ewwel waħda ma tgħid xejn dwar ix-xenarju tal-użu, filwaqt li t-tieni waħda tsemmi l-inputs, l-output, u meta għandha tintuża.
# Ħażin: deskrizzjoni vaga
@function_tool
def process_data(data: str) -> str:
"""Tipproċessa d-data."""
return "OK"
# Tajjeb: deskrizzjoni preċiża u kuntestwalizzata
@function_tool
def calculate_gross_margin(revenue: float, production_cost: float) -> str:
"""Tikkalkula l-marġni gross bħala perċentwal mid-dħul
u l-ispiża tal-produzzjoni. Utli għall-analiżi finanzjarja trimestrali."""
margin = ((revenue - production_cost) / revenue) * 100
return f"Marġni gross: {margin:.1f}% (Dħul: €{revenue}, Spejjeż: €{production_cost})"
Deskrizzjoni tajba ta’ għodda hija bħal docstring tajba: tispjega meta għandha tintuża l-għodda, mhux biss x’tagħmel. Ħu għaxar minuti biex tirrevedi d-deskrizzjonijiet tal-aġent tiegħek, u staqsi lilek innifsek għal kull waħda jekk kollega setax jagħżel l-għodda t-tajba billi jaqra dik is-sentenza biss. Dak huwa eżattament l-eżerċizzju li l-mudell iwettaq.
Punti Ewlenin
- It-Tfittxija tal-Għodod tagħżel dinamikament l-għodod rilevanti għal kull talba
- B’ħafna għodod, aġent router jista’ jiddetermina d-dominju minn qabel
- Adatta l-għodod disponibbli bbażat fuq ir-rwol u l-kuntest tal-utent
- Il-kwalità tad-deskrizzjoni tal-għodda taffettwa l-preċiżjoni tal-għażla
- Uża mudell ħafif għar-routing mgħaġġel u mudell kapaċi għall-eżekuzzjoni