Cuardach Uirlisí: Uirlisí Dinimiciúla
Ar an leathanach seo
Cuardach Uirlisí: Uirlisí Dinimiciúla
Éiríonn le gníomhaire taispeána maith le trí nó ceithre uirlis. Ach, carnann gníomhaire fiontair dosaen uirlis go héagsúil, uaireanta na céadta: billeáil, ACF, CRM, doiciméid, sceidealú. Ag an scála sin, éiríonn sé mí-éifeachtach agus costasach ó thaobh token de an catalóg iomlán a sheoladh chuig an múnla le gach iarratas. Réitíonn Cuardach Uirlisí an fhadhb seo trí na huirlisí ábhartha a roghnú go dinimiciúil do gach iarratas.
An Fhadhb le Rómhórán Uirlisí
Samhlaigh gníomhaire le 50 uirlis. Ar gach glao API, seoltar scéimre na n-uirlisí 50 go léir sa leid. Caitheann sé seo na mílte token agus is féidir leis an múnla a mheabhrú: dá faide an liosta, is amhlaidh is cosúla na cur síos, agus is amhlaidh is mó a leisceann an múnla idir uirlisí in aice le chéile. Éiríonn na costais níos airde agus titann an chruinneas – an comhcheangal is measa is féidir.
# Fadhb: rómhórán uirlisí
agent = Agent(
name="Super Agent",
instructions="You can do anything.",
tools=[tool_1, tool_2, tool_3, ... , tool_50], # 50 tools = lots of tokens
)
Cuardach Uirlisí a Chumasú
Baineann Cuardach Uirlisí úsáid as innéacs shéimeantach chun uirlisí ábhartha a roghnú bunaithe ar an iarratas. Dearbhaíonn tú do chuid uirlisí mar is gnách, ach ligeann an paraiméadar tool_use_behavior="auto" don mhúnla roghnú as an gcatlóg in ionad gach rud a lódáil roimh ré. Sa sampla thíos, ní spreagfaidh iarratas chun meabhrúchán íocaíochta a sheoladh uirlisí ACF, agus a mhalairt.
from agents import Agent, Runner, function_tool
# Sainmhínigh go leor uirlisí
@function_tool
def create_invoice(client: str, amount: float) -> str:
"""Creates an invoice for a client."""
return f"Invoice created for {client}: €{amount}"
@function_tool
def send_reminder(invoice_id: str) -> str:
"""Sends a payment reminder for an unpaid invoice."""
return f"Reminder sent for invoice {invoice_id}"
@function_tool
def generate_hr_report(month: str) -> str:
"""Generates a human resources report for a given month."""
return f"HR report generated for {month}"
@function_tool
def schedule_interview(candidate: str, date: str) -> str:
"""Schedules a job interview with a candidate."""
return f"Interview scheduled with {candidate} on {date}"
# Go leor uirlisí eile...
agent = Agent(
name="Enterprise Agent",
instructions="You manage company operations.",
tools=[
create_invoice,
send_reminder,
generate_hr_report,
schedule_interview,
# ... 50 other tools
],
tool_use_behavior="auto", # The model selects dynamically
)
Patrún: Roghnú Láimhe Uirlisí
Má theastaíonn rialú iomlán uait ar roghnú na n-uirlisí, cuir do chuid loighce féin i bhfeidhm. Is simplí an prionsabal: léann gníomhaire beag ródaire an t-iarratas agus ainmníonn sé an fearann ábhartha amháin. Ansin, tógann tú an gníomhaire speisialaithe ar an eitilt leis na huirlisí don fhearann sin amháin. Tagann frása cosúil le “seol meabhrúchán don fháltas F-2026-114” amach as an ródaire leis an bhfreagra accounting, agus ní fheiceann an gníomhaire feidhmiúcháin na huirlisí ACF riamh.
from agents import Agent, Runner, function_tool
# Grúpáil uirlisí de réir fearainn
accounting_tools = [create_invoice, send_reminder]
hr_tools = [generate_hr_report, schedule_interview]
# Gníomhaire ródaire a roghnaíonn an fearann
router = Agent(
name="Router",
instructions="""Determine the domain of the request.
Respond only with 'accounting' or 'hr'.""",
model="gpt-5.6-terra", # Fast and cheap for routing
output_type=str,
)
async def handle_request(message: str):
# Céim 1: Faigh amach an fearann
route = await Runner.run(router, message)
domain = route.final_output.strip().lower()
# Céim 2: Cruthaigh an gníomhaire speisialaithe leis na huirlisí cearta
if domain == "accounting":
tools = accounting_tools
instructions = "You manage the company's accounting."
elif domain == "hr":
tools = hr_tools
instructions = "You manage human resources."
else:
tools = accounting_tools + hr_tools
instructions = "You manage company operations."
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
Baineann úsáid as gpt-5.6-terra don ródaireacht agus don fheidhmiú araon le glúin roimhe seo de mhúnlaí; fanann an réasúnaíocht taobh thiar den phatrún mar an gcéanna le teaghlach GPT-5.6, áit a ndéanann socruithe iarrachta idirdhealú idir an ródaire tapa agus an feidhmitheoir.
Patrún: Uirlisí Dinimiciúla Comhthéacs-Aireach
Ní bhraitheann an roghnú ar an gceist a chuirtear amháin; braitheann sé freisin ar cé atá ag cur na ceiste. Is féidir leat na huirlisí atá ar fáil a oiriúnú bunaithe ar an úsáideoir atá logáilte isteach, ag marú dhá éan le cloch amháin: níos lú token seolta, agus, níos tábhachtaí fós, rialuithe rochtana forfheidhmithe sula ndéanann an múnla fiú réasúnaíocht. Faigheann fostaí díola uirlisí luachana, ach níl delete_account ann fiú ina ngníomhaire.
from dataclasses import dataclass
@dataclass
class UserContext:
role: str # "admin", "manager", "employee"
department: str
def get_tools_for_role(ctx: UserContext) -> list:
"""Returns authorized tools based on role."""
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"You assist a {ctx.role} in the {ctx.department} department.",
tools=tools,
model="gpt-5.6-terra",
)
Cur síos ar Uirlisí a Optamú
Cibé meicníocht roghnúcháin a roghnaíonn tú, braitheann sí ar ábhar amháin: téacs do chuid cur síos. Buaileann cáilíocht na gcur síos seo go díreach ar ábharthacht an roghnúcháin. Déan comparáid idir an dá dhearbhú thíos: ní deir an chéad cheist faoin gcás úsáide, ach ainmníonn an dara ceann na hionchuir, an t-aschur, agus cathain a úsáidfear é.
# Droch: cur síos doiléir
@function_tool
def process_data(data: str) -> str:
"""Processes data."""
return "OK"
# Maith: cur síos cruinn agus comhthéacsaithe
@function_tool
def calculate_gross_margin(revenue: float, production_cost: float) -> str:
"""Calculates gross margin as a percentage from revenue
and production cost. Useful for quarterly financial analysis."""
margin = ((revenue - production_cost) / revenue) * 100
return f"Gross margin: {margin:.1f}% (Revenue: €{revenue}, Costs: €{production_cost})"
Is cosúil cur síos maith uirlise le docstring maith: míníonn sé cathain a úsáidfear an uirlis, ní hamháin cad a dhéanann sí. Tóg deich nóiméad chun athbhreithniú a dhéanamh ar chur síos do ghníomhaire, ag cur ceiste ort féin do gach ceann acu an bhféadfadh comhghleacaí an uirlis cheart a roghnú trí an abairt sin amháin a léamh. Sin díreach an cleachtadh a dhéanann an múnla.
Príomhphointí
- Roghnaíonn Cuardach Uirlisí uirlisí ábhartha go dinimiciúil do gach iarratas
- Le go leor uirlisí, is féidir le gníomhaire ródaire an fearann a chinneadh roimh ré
- Oiriúnaigh na huirlisí atá ar fáil bunaithe ar ról agus comhthéacs an úsáideora
- Buaileann cáilíocht chur síos na n-uirlisí cruinneas an roghnúcháin
- Úsáid múnla éadrom le haghaidh ródaireachta tapa agus múnla cumasach le haghaidh feidhmiúcháin