Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Anatamaíocht an SDK: Gníomhaire, Riteoir, Uirlis, Cosaint

Ceacht 5 as 25 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Anatamaíocht an SDK: Gníomhaire, Riteoir, Uirlis, Cosaint
  2. Gníomhaire: Cumraíocht
  3. Riteoir: Feidhmiú
  4. Uirlis: Cumais
  5. Cosaint: Sábháilteacht
  6. Conas a idirghníomhaíonn na píosaí seo
  7. Príomhphointí

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.

1

Gníomhaire — An inchinn

Sainíonn sé treoracha, an tsamhail, uirlisí, agus cosaintí. Seo do chumraíocht gníomhaire.

2

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.

3

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.

4

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íomhaire
  • instructions: An leid córais a shainíonn an iompraíocht
  • model: 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áil
  • handoff_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:

  1. Glaonn tú ar Runner.run(agent, message)
  2. Seiceálann an Riteoir cosaintí ionchuir
  3. Seolann an Riteoir an teachtaireacht chuig samhail an Ghníomhaire
  4. Má iarrann an tsamhail uirlis, feidhmíonn an Riteoir í
  5. Tugann an Riteoir an toradh ar ais don tsamhail (ar ais go dtí céim 3)
  6. Nuair a tháirgeann an tsamhail freagra deiridh, seiceálann an Riteoir cosaintí aschuir
  7. Tugtar an RunResult ar ais

Príomhphointí

  • Sainíonn Agent an iompraíocht (treoracha, samhail, uirlisí)
  • Déanann Runner comhordú 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 RunResult an freagra deiridh agus an stair iomlán