Anatamaíocht an SDK: Gníomhaire, Riteoir, Uirlis, Cosaint
Ar an leathanach seo
Anatamaíocht an SDK: Gníomhaire, Riteoir, Uirlis, Cosaint
Tá SDK na nGníomhairí bunaithe ar cheithre phríomhchoincheap: Gníomhaire, Riteoir, Uirlis, agus Cosaint. Tá freagracht amháin ag gach ceann acu. Is é an chaoi a n-oibríonn siad le chéile—cé a dhéanann an cinneadh, cé a fheidhmíonn, cé a ghníomhaíonn, cé a rialaíonn—ná an rud a dhéanann an SDK inléite nuair a dhéanann tú é a thuiscint go hiomlán.
Gníomhaire — An inchinn
Sainíonn sé treoracha, an tsamhail, uirlisí, agus cosaintí. Seo do chumraíocht gníomhaire.
Riteoir — An t-inneall feidhmithe
Déanann sé comhordú ar an lúib réasúnaíochta: seolann sé iarratais, feidhmíonn sé uirlisí, agus láimhseálann sé aistrithe.
Uirlis — Cumais
Feidhmeanna is féidir leis an ngníomhaire a ghlaowh: cuardach gréasáin, feidhmiú cóid, glaonna API, agus go leor eile.
Cosaint — Sábháilteacht
Fíoraíonn sé ionchuir agus aschuir an ghníomhaire. Cuireann sé bac ar iarratais contúirteacha nó nach mbaineann leis an ábhar.
Gníomhaire: Cumraíocht
Tá an rang Agent dearbhaitheach go hiomlán: ní ritheann sé aon rud; déanann sé cur síos air. Tá gach rud a shainíonn iompraíocht do ghníomhaire in áit amháin.
from agents import Agent, function_tool, WebSearchTool
@function_tool
def get_price(product: str) -> str:
"""Retrieves the price of a product."""
prices = {"widget": "€29.99", "gadget": "€49.99"}
return prices.get(product, "Unknown product")
agent = Agent(
name="Sales Agent",
instructions="""You are a sales agent for an online store.
Help customers find products and learn their prices.
Always respond in French with a professional tone.""",
model="gpt-5.6-terra",
tools=[get_price, WebSearchTool()],
handoff_description="Agent specialized in selling products",
output_type=None, # or a Pydantic type to enforce an output format
)
Príomhpharaiméadair Agent:
name: Aitheantóir inléite don duine don ghníomhaireinstructions: An leid córais a shainíonn an iompraíochtmodel: An tsamhail le húsáid (gpt-5.6-sol,gpt-5.6-terra,gpt-5.6-luna)tools: An liosta d’uirlisí atá ar fáilhandoff_description: Cur síos a úsáidtear le haghaidh aistrithe idir gníomhairíoutput_type: Cineál Pydantic chun an t-aschur a struchtúrú
Riteoir: Feidhmiú
Is é an Runner an t-inneall a ritheann do ghníomhaire. Bainistíonn sé an lúib iomlán agus tagann sé i dtrí mhód ag brath ar do chomhthéacs glaonna.
from agents import Runner
# Synchronous mode (development)
result = Runner.run_sync(agent, "What is the price of the widget?")
# Asynchronous mode (production)
result = await Runner.run(agent, "What is the price of the widget?")
# Streaming mode (real time)
result = Runner.run_streamed(agent, "What is the price of the widget?")
Beag beann ar an mód, faigheann tú RunResult ar ais, ina bhfuil i bhfad níos mó ná an freagra atá le taispeáint. Ligeann an stair iomlán duit comhrá a athrú, agus éiríonn last_agent riachtanach chomh luath agus a dhéanann gníomhairí iolracha aistriú chuig a chéile.
result = Runner.run_sync(agent, "What is the price of the widget?")
# The agent's final response
print(result.final_output)
# The complete conversation history
print(result.to_input_list())
# The last active agent (useful with handoffs)
print(result.last_agent.name)
Uirlis: Cumais
Tacaíonn an SDK le trí bhealach chun uirlisí a dhearbhú, ón gceann is coitianta go dtí an ceann is ailtireachta.
1. Uirlisí feidhme (is coitianta)
Déantar uirlis de fheidhm Python atá maisithe; déanann an SDK an scéama a thátal ón síniú agus ón doiciméadú.
from agents import function_tool
@function_tool
def send_email(recipient: str, subject: str, body: str) -> str:
"""Sends an email to a recipient."""
# Your sending logic here
return f"Email sent to {recipient}"
2. Uirlisí óstáilte ag OpenAI
Ritheann na huirlisí seo ar thaobh OpenAI: ní scríobhann tú an loighic chuardaigh ná an bosca gainimh Python.
from agents import WebSearchTool, FileSearchTool, CodeInterpreterTool
tools = [
WebSearchTool(), # Web search
FileSearchTool(vector_store_ids=["vs_123"]), # File search
CodeInterpreterTool(tool_config={"type": "code_interpreter", "container": {"type": "auto"}}), # Code execution
]
3. Gníomhairí mar uirlisí
Is féidir le gníomhaire amháin ceann eile a úsáid mar uirlis. Déanann an comhordaitheoir thíos taighde a tharmligean gan smacht ar an gcomhrá a thabhairt suas riamh, rud a dhéanann idirdhealú idir é seo agus aistriú.
search_agent = Agent(
name="Researcher",
instructions="You look up precise information.",
tools=[WebSearchTool()],
)
primary_agent = Agent(
name="Coordinator",
instructions="You coordinate research.",
tools=[search_agent.as_tool(
tool_name="search",
tool_description="Performs in-depth research"
)],
)
Cosaint: Sábháilteacht
Is gníomhaire rialaithe é cosaint a chuirtear os comhair do ghníomhaire gnó. Anseo, seiceálann fíoraitheoir an mbaineann an t-iarratas le díolacháin sula bhfreagraíonn an gníomhaire díolacháin.
from agents import Agent, InputGuardrail, GuardrailFunctionOutput, Runner
guardrail_agent = Agent(
name="Verifier",
instructions="Determine whether the request concerns sales. Respond true or false.",
output_type=bool,
)
async def verify_topic(ctx, agent, input_data):
result = await Runner.run(guardrail_agent, input_data, context=ctx)
return GuardrailFunctionOutput(
output_info=result.final_output,
tripwire_triggered=not result.final_output,
)
protected_agent = Agent(
name="Protected Sales Agent",
instructions="You are a sales agent.",
input_guardrails=[
InputGuardrail(guardrail_function=verify_topic),
],
)
Má thagann an chosaint i ngníomh (tripwire_triggered=True), stopann an fheidhmiú agus ardaítear eisceacht InputGuardrailTripwireTriggered. Pleanáil é seo a ghabháil i d’fheidhmchlár; murach sin, seolfaidh tú earráid 500 chuig úsáideoir a rinne ceist nach raibh ábhartha ach amháin.
Conas a idirghníomhaíonn na píosaí seo
Ritheann an sruth iomlán mar a leanas:
- Glaonn tú ar
Runner.run(agent, message) - Seiceálann an Riteoir cosaintí ionchuir
- Seolann an Riteoir an teachtaireacht chuig samhail an Ghníomhaire
- Má iarrann an tsamhail uirlis, feidhmíonn an Riteoir í
- Tugann an Riteoir an toradh ar ais don tsamhail (ar ais go dtí céim 3)
- Nuair a tháirgeann an tsamhail freagra deiridh, seiceálann an Riteoir cosaintí aschuir
- Tugtar an
RunResultar ais
Príomhphointí
- Sainíonn
Agentan iompraíocht (treoracha, samhail, uirlisí) - Déanann
Runnercomhordú ar fheidhmiú lúibe an ghníomhaire - Dearbhaigh uirlisí le
@function_tool, ranganna ionsuite, nó.as_tool() - Fíoraíonn Cosaintí ionchuir agus aschuir le haghaidh sábháilteachta
- Coinníonn
RunResultan freagra deiridh agus an stair iomlán