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

Gníomhaire ilchéimeach le lúib réasúnaíochta

Ceacht 15 as 25 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Gníomhaire ilchéimeach le lúib réasúnaíochta
  2. An patrún pleanáil-feidhmiú
  3. Gníomhaire féincheartaitheach
  4. Patrún: slabhra gníomhairí speisialaithe
  5. Doimhneacht na réasúnaíochta a rialú
  6. Príomhphointí

Gníomhaire ilchéimeach le lúib réasúnaíochta

Ní stopann na gníomhairí is cumhachtaí tar éis glaonna uirlise aonair. Déanann siad slabhra de chéimeanna éagsúla réasúnaíochta, coigeartaíonn siad a straitéis de réir na dtorthaí, agus déanann siad athrá go dtí go sroicheann siad a sprioc. Sa cheacht seo, foghlaimeoidh tú conas na gníomhairí ilchéimeacha seo a thógáil. Úsáideann na samplaí teaghlaigh GPT-5.6: áit a raibh gá le hathrú samhlacha chun réasúnaíocht a chumasú sa ghlúin roimhe seo, rialaíonn tú an iompar seo anois tríd an socruithe iarrachta ar an tsamhail a roghnaigh tú.

An patrún pleanáil-feidhmiú

Tosaíonn gníomhaire ilchéimeach trí phlean a chruthú, agus ansin feidhmíonn sé gach céim. Is d’aon turas an deighilt seo: níl aon uirlisí ag an bpleanálaí agus cruthaíonn sé struchtúr típithe, faigheann an feidhmitheoir an plean seo mar mhapa bóthair agus leanann sé é go simplí. Déantar iarratas doiléir cosúil le “ullmhaigh an t-athbhreithniú ráithiúil do na príomhchuntais” a thiontú ina sheicheamh concreite gníomhaíochtaí—ceistigh an CRM, gine an tuarascáil, seol an ríomhphost—sula ndéantar aon ghníomh a thriail.

from agents import Agent, Runner, function_tool
from pydantic import BaseModel
import json

class PlanAction(BaseModel):
    steps: list[str]
    objective: str

planner_agent = Agent(
    name="Planner",
    instructions="""Faigheann tú tasc casta. Brise síos é ina chéimeanna simplí, ordaithe.
    Caithfidh gach céim a bheith ina mhír ghníomhaíochta choincréiteach.""",
    model="gpt-5.6-sol",  # Réasúnaíocht chasta le haghaidh pleanála
    output_type=PlanAction,
)

@function_tool
def search_crm(query: str) -> str:
    """Cuardaíonn sé an CRM le haghaidh faisnéise faoi chustaiméirí."""
    return json.dumps({"customers": [
        {"name": "Acme Corp", "revenue": 500000, "contract": "Enterprise"},
        {"name": "TechStart", "revenue": 50000, "contract": "Starter"},
    ]})

@function_tool
def generate_report(title: str, content: str) -> str:
    """Gineann sé tuarascáil fhormáidithe."""
    return f"Report '{title}' generated successfully ({len(content)} characters)"

@function_tool
def send_email(recipient: str, subject: str, body: str) -> str:
    """Seolann sé ríomhphost."""
    return f"Email sent to {recipient}: {subject}"

executor_agent = Agent(
    name="Executor",
    instructions="""Feidhmíonn tú tascanna céim ar chéim.
    Bain úsáid as na huirlisí atá ar fáil chun gach céim a chríochnú.
    Má theipeann ar chéim, bain triail as cur chuige malartach.""",
    tools=[search_crm, generate_report, send_email],
    model="gpt-5.6-terra",
)

async def process_complex_task(task: str):
    # Céim 1: Pleanáil
    plan = await Runner.run(planner_agent, task)
    print(f"Plan: {plan.final_output.steps}")

    # Céim 2: Feidhmiú leis an bplean mar chomhthéacs
    execution_instructions = f"""Feidhmigh na céimeanna seo a leanas in ord:
    {chr(10).join(f'{i+1}. {e}' for i, e in enumerate(plan.final_output.steps))}
    Cuspóir: {plan.final_output.objective}"""

    result = await Runner.run(executor_agent, execution_instructions)
    return result.final_output

Gníomhaire féincheartaitheach

Ní leor pleanáil amháin: sa saol fíor, teipeann ar uirlisí. Is é an dara cineál lúibe ná ligean don ghníomhaire a chuid earráidí a bhrath agus iad a cheartú. Braitheann gach rud ar mhionsonraí a dhéantar dearmad go minic air—ní chuireann an uirlis eisceacht amach; filleann sí teachtaireacht earráide inléite. Léann an gníomhaire é, tuigeann sé gur dhearmad sé an clásal FROM, athscríobhann sé a cheist, agus déanann sé iarracht arís, laistigh den teorainn trí iarracht a leagtar síos ina chuid treoracha.

from agents import Agent, Runner, function_tool

@function_tool
def execute_sql_query(sql: str) -> str:
    """Feidhmíonn sé ceist SQL ar an mbunachar sonraí."""
    # Simléad: teipeann ar roinnt ceisteanna
    if "DROP" in sql.upper():
        return "ERROR: Destructive queries are forbidden."
    if "SELECT" in sql.upper() and "FROM" not in sql.upper():
        return "ERROR: Invalid SQL syntax - missing FROM."
    return json.dumps({
        "columns": ["name", "monthly_revenue", "region"],
        "rows": [
            ["Acme Corp", 45000, "Île-de-France"],
            ["TechStart", 12000, "Rhône-Alpes"],
        ],
        "result_count": 2
    })

analyst_agent = Agent(
    name="Data Analyst",
    instructions="""Déanann tú anailís ar shonraí trí cheisteanna SQL a fheidhmiú.
    Má theipeann ar cheist:
    1. Déan anailís ar an teachtaireacht earráide
    2. Ceartaigh an cheist
    3. Bain triail arís
    Uasmhéid 3 iarracht in aghaidh na ceiste.
    Ná húsáid DROP, DELETE, ná TRUNCATE riamh.""",
    tools=[execute_sql_query],
    model="gpt-5.6-terra",
    max_turns=10,  # Go leor casanna le haghaidh ceartúcháin
)

result = Runner.run_sync(
    analyst_agent,
    "What is the total revenue by region?"
)

Tabhair faoi deara go bhfuil an toirmeasc ar cheisteanna millteacha le feiceáil in dhá áit: sna treoracha agus sa chód uirlise. Treoraíonn na treoracha an tsamhail, ach ní ráthaíonn ach an seiceáil taobh freastalaí san uirlis nach sleamhnaíonn DROP TABLE tríd riamh.

Patrún: slabhra gníomhairí speisialaithe

Le haghaidh sreabha oibre casta, déan slabhra de roinnt gníomhairí speisialaithe in ionad gach freagracht a luchtú ar ghníomhaire amháin. Tá ról soiléir ag gach nasc: bailíonn an bailitheoir an t-amhábhar, aithníonn an t-anailíseoir—feistithe le samhail réasúnaíochta—treochtaí, agus déanann an scríbhneoir formáidiú ar an aschur. Tá an tairbhe oideachasúil agus oibríochtúil araon: nuair a chuireann an tuarascáil deiridh díomá ort, tá a fhios agat láithreach cé acu de na trí ghníomhaire is gá a dheisiú.

from agents import Agent, Runner

collection_agent = Agent(
    name="Data Collector",
    instructions="Bailigh gach sonraí atá riachtanach don anailís.",
    tools=[search_crm, execute_sql_query],
    model="gpt-5.6-terra",
)

analysis_agent = Agent(
    name="Analyst",
    instructions="Déan anailís ar na sonraí a bailíodh agus aithin treochtaí.",
    model="gpt-5.6-sol",  # Réasúnaíocht chasta le haghaidh anailíse
)

writing_agent = Agent(
    name="Writer",
    instructions="""Scríobh tuarascáil shoiléir, struchtúrtha i mBéarla
    bunaithe ar an anailís a soláthraíodh. Formáid: réamhrá, príomhphointí, moltaí.""",
    model="gpt-5.6-terra",
)

async def analysis_pipeline(question: str):
    # Céim 1: Bailigh sonraí
    data = await Runner.run(collection_agent, question)

    # Céim 2: Déan anailís
    analysis = await Runner.run(
        analysis_agent,
        f"Analyze this data: {data.final_output}"
    )

    # Céim 3: Scríobh an tuarascáil
    report = await Runner.run(
        writing_agent,
        f"Write a report based on this analysis: {analysis.final_output}"
    )

    return report.final_output

Doimhneacht na réasúnaíochta a rialú

Tá tréith amháin ag na lúba seo go léir: d’fhéadfadh siad gan stopadh riamh. Is é an paraiméadar max_turns do phríomhchosaint, agus déanann tú é a thiontú de réir uaillmhian an tasc. Leor trí chas do ghníomhaire a bhfuiltear ag súil leis freagra a thabhairt ar an gcéad iarracht; tá cúig chas is fiche ag teastáil le haghaidh taiscéalaíochta a dhéanann ceist ar fhoinsí iolracha sula dtagann sé ar chonclúid.

# Gníomhaire coimeádach: beagán casanna
simple_agent = Agent(
    name="Simple Agent",
    instructions="Freagair i gcas amháin más féidir.",
    model="gpt-5.6-terra",
)
result = await Runner.run(simple_agent, "Simple question", max_turns=3)

# Gníomhaire casta: go leor casanna
research_agent = Agent(
    name="Deep Researcher",
    instructions="Déan iniúchadh ar gach uillinn sula dtagann tú ar chonclúid.",
    tools=[search_crm, execute_sql_query],
    model="gpt-5.6-terra",
)
result = await Runner.run(research_agent, "Complete Q1 analysis", max_turns=25)

Socraigh an luach seo trí do rianta a bhreathnú seachas buille faoi thuairim a dhéanamh: má chríochnaíonn do fheidhmithe iarbhír i sé chas, ní chosnaíonn teorainn cúig chas is fiche tú in aon rud.

Príomhphointí

  • Deighleann an patrún pleanáil-feidhmiú an phleanáil (samhail réasúnaíochta) ón bhfeidhmiú
  • Déanann gníomhaire féincheartaitheach anailís ar a chuid earráidí agus coigeartaíonn sé a straitéis
  • Cuireann slabhraí gníomhairí speisialaithe ar chumas sreabha oibre casta, inchothabhála
  • Rialaíonn max_turns doimhneacht na réasúnaíochta agus cosnaíonn sé in aghaidh lúba gan chríoch
  • Cuir cumais réasúnaíochta chun cinn in áirithe le haghaidh pleanála agus anailíse