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

Agents SDK: Suiteáil agus do Chéad Ghníomhaire

Ceacht 4 as 25 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Agents SDK: Suiteáil agus do Chéad Ghníomhaire
  2. Réamhriachtanais
  3. Suiteáil
  4. Do Chéad Ghníomhaire
  5. Feidhmiú Asincronach
  6. Feidhmiú Sruthaithe
  7. Struchtúr Tionscadail Gníomhaire
  8. Príomhphointí

Agents SDK: Suiteáil agus do Chéad Ghníomhaire

Bogaimis go dtí an códáil. Suiteálfaidh tú SDK oifigiúil Gníomhairí OpenAI, tógfaidh tú gníomhaire Python atá ag obair, agus déanfaidh tú iniúchadh ar na trí mhód feidhmithe a úsáidfidh tú ar fud an chúrsa seo.

Réamhriachtanais

Níl uait ach trí rud: Python 3.10+ suiteáilte ar do mheaisín, cuntas OpenAI le heochair API gníomhach, agus eagarthóir cóid. Molaimid VS Code, ach oibreoidh aon eagarthóir le haibhsíocht shintacs Python go maith.

Suiteáil

Tugtar openai-agents ar an bpacáiste. Bí ar an airdeall: má shuiteálann tú openai amháin, faigheann tú an cliant API clasaiceach, ní an SDK Gníomhairí.

pip install openai-agents

Suiteálann an pacáiste seo spleáchais riachtanacha go huathoibríoch, lena n-áirítear SDK Python OpenAI. Anois, socraigh d’eochair API mar athróg timpeallachta. Léann an SDK é go huathoibríoch, mar sin ní gá aon chumraíocht bhreise.

export OPENAI_API_KEY="sk-proj-your-api-key"

Imíonn an t-ordú seo nuair a dhúnann tú an teirminéal, agus cinnte ní mhaireodh tú d’eochair a chrua-chódú i do chomhaid foinse. Chun socruithe cuí a dhéanamh ar thionscadal, úsáid comhad .env le python-dotenv, agus cuir an comhad sin le do .gitignore sula ndéanann tú do chéad ghealltanas.

pip install python-dotenv
# .env
OPENAI_API_KEY=sk-proj-your-api-key

Do Chéad Ghníomhaire

Cruthaigh comhad darbh ainm my_first_agent.py:

from agents import Agent, Runner

agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant. Respond in English concisely.",
    model="gpt-5.6-terra",
)

result = Runner.run_sync(agent, "Explain what an AI agent is in three sentences.")
print(result.final_output)

Rith é:

python my_first_agent.py

Chruthaigh agus rith tú do chéad ghníomhaire díreach. Tá sé simplí—gan uirlisí, gan gardaí—ach is é an bonn atá ann do gach rud eile. Níl sa chuid eile den chúrsa seo ach tógáil ar an dá oibiacht seo: Agent agus Runner.

Feidhmiú Asincronach

Bacann run_sync an snáithe reatha go dtí go dtagann an freagra. Tá sé sin ceart go leor do script tástála, ach dofhaighte do fhreastalaí gréasáin atá ag láimhseáil na gcéadta iarratas comhuaineach. Sa táirgeadh, úsáidfidh tú an mód asincronach.

import asyncio
from agents import Agent, Runner

agent = Agent(
    name="Async Assistant",
    instructions="You are a helpful assistant. Respond in English.",
    model="gpt-5.6-terra",
)

async def main():
    result = await Runner.run(agent, "What are the advantages of Python for AI?")
    print(result.final_output)

asyncio.run(main())

Is é Runner.run() an leagan asincronach; is fillteán sioncronach é Runner.run_sync() a ghlaonn air duitse. Nuair a bhíonn tú ag úsáid FastAPI nó aon fhráma work asincronach eile, úsáid Runner.run() i gcónaí.

Feidhmiú Sruthaithe

Tá tríú mód ann, atá riachtanach aon uair a bhíonn duine ag fanacht ag an scáileán. Taispeánann sruthú an freagra de réir mar a ghintear é, token ar token.

import asyncio
from agents import Agent, Runner

agent = Agent(
    name="Streaming Assistant",
    instructions="You are a helpful assistant. Respond in English.",
    model="gpt-5.6-terra",
)

async def main():
    result = Runner.run_streamed(agent, "Tell a short story about AI.")
    async for event in result.stream_events():
        if event.type == "raw_response_event":
            if hasattr(event.data, "delta") and event.data.delta:
                print(event.data.delta, end="", flush=True)
    print()  # New line at the end

asyncio.run(main())

Ithíonn an lúb async for sruth imeachtaí. Anseo, scagaimid d’imeachtaí freagartha múnla amh agus ní phriontáilimid ach blúirí téacs. Tá sruthú ríthábhachtach don taithí úsáideora: ní mhaith le duine ar bith bheith ag stánadh ar scáileán bán ar feadh 10 soicind.

Struchtúr Tionscadail Gníomhaire

Ní oireann gníomhaire táirgeachta i gcomhad amháin. Scar do shainmhínithe gníomhairí, uirlisí, agus tástálacha ón tús, nó éireoidh do main.py doiléir go tapa.

my-agent-project/
├── .env                 # API key
├── requirements.txt     # Dependencies
├── agents/
│   ├── __init__.py
│   ├── assistant.py     # Agent definition
│   └── tools.py         # Tool definitions
├── main.py              # Entry point
└── tests/
    └── test_agent.py    # Tests
# requirements.txt
openai-agents>=0.1.0
python-dotenv>=1.0.0

Príomhphointí

  • Suiteáil an SDK le pip install openai-agents
  • Socraigh OPENAI_API_KEY mar athróg timpeallachta
  • Úsáid Runner.run_sync() d’fhorbairt agus Runner.run() do tháirgeadh asincronach
  • Úsáid Runner.run_streamed() le haghaidh sruthaithe fíor-ama
  • Struchtúraigh do thionscadal le fillteáin ar leith do ghníomhairí, uirlisí, agus tástálacha